@vpxa/aikit 0.1.295 → 0.1.297
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/bin/aikit.mjs +27 -2
- package/package.json +1 -1
- package/packages/blocks-core/dist/index.mjs +54 -36
- package/packages/cli/dist/index.js +18 -18
- package/packages/cli/dist/{init-DWIr_CT8.js → init-WmQoeitD.js} +1 -1
- package/packages/cli/dist/{templates-Cc3Rn_zv.js → templates-BQ1J4HzY.js} +13 -13
- package/packages/present/dist/index.html +39 -22
- package/packages/server/dist/bin.js +3 -3
- package/packages/server/dist/{curated-manager-C5uOPept.js → curated-manager-i5QA4c79.js} +2 -2
- package/packages/server/dist/index.d.ts +30 -3
- package/packages/server/dist/index.js +1 -1
- package/packages/server/dist/promotion-DmwIVl0c.js +2 -0
- package/packages/server/dist/promotion-bQutAIz-.js +3 -0
- package/packages/server/dist/{server-CyERdqK0.js → server-BOvlXO_K.js} +178 -177
- package/packages/server/dist/{server-BRinO5Fx.js → server-fs4l4wco.js} +178 -177
- package/packages/server/viewers/canvas.html +85 -68
- package/packages/server/viewers/report-template.html +21 -4
- package/packages/server/viewers/tour-viewer.html +25 -8
- package/packages/store/dist/index.d.ts +3 -3
- package/packages/store/dist/index.js +35 -35
- package/scaffold/definitions/mcp-entry.json +1 -1
- package/scaffold/dist/definitions/mcp-entry.json +1 -1
- package/scaffold/dist/definitions/skills/c4-architecture.mjs +1 -1
- package/scaffold/dist/definitions/skills/docs.mjs +1 -1
- package/scaffold/dist/definitions/skills/present.mjs +1 -1
- package/packages/server/dist/promotion-CJFYv4Ye.js +0 -3
- package/packages/server/dist/promotion-D9anNXv8.js +0 -2
|
@@ -1,41 +1,41 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{n as e,t}from"./bin.js";import{a as n,c as r,d as i,f as a,h as o,i as s,l as c,m as l,n as u,o as d,p as f,r as p,s as m,u as h}from"./supersession-DO_ZROFl.js";import{a as g,i as _,n as v,o as y,r as b,reconfigureForWorkspace as x,t as S}from"./config-DK_lqZRv.js";import{n as C,r as w}from"./resolve-sibling-ByoHo7Tp.js";import{n as T,r as E}from"./evolution-DWaEE6XW.js";import{a as D,i as O,n as k,r as ee,s as te,t as ne}from"./promotion-
|
|
3
|
-
`)}}]})),e.registerPrompt(`onboard`,{title:`Onboard Codebase`,description:`Analyze the codebase for first-time onboarding — runs all analyzers and produces a knowledge summary`,argsSchema:{path:
|
|
2
|
+
import{n as e,t}from"./bin.js";import{a as n,c as r,d as i,f as a,h as o,i as s,l as c,m as l,n as u,o as d,p as f,r as p,s as m,u as h}from"./supersession-DO_ZROFl.js";import{a as g,i as _,n as v,o as y,r as b,reconfigureForWorkspace as x,t as S}from"./config-DK_lqZRv.js";import{n as C,r as w}from"./resolve-sibling-ByoHo7Tp.js";import{n as T,r as E}from"./evolution-DWaEE6XW.js";import{a as D,i as O,n as k,r as ee,s as te,t as ne}from"./promotion-bQutAIz-.js";import{autoUpgradeScaffold as re,getCurrentVersion as ie,getUpgradeState as ae}from"./version-check-CJK1Fwmy.js";import{createRequire as oe}from"node:module";import{createHash as A,randomBytes as se,randomUUID as ce,timingSafeEqual as j}from"node:crypto";import{existsSync as M,mkdirSync as N,readFileSync as P,readdirSync as le,renameSync as ue,rmSync as de,statSync as fe,unlinkSync as pe,writeFileSync as me}from"node:fs";import{basename as he,dirname as ge,isAbsolute as _e,join as F,relative as ve,resolve as I,sep as ye}from"node:path";import{fileURLToPath as be}from"node:url";import{promisify as xe}from"node:util";import{AIKIT_PATHS as Se,CONTENT_TYPES as Ce,CircuitBreaker as we,EMBEDDING_DEFAULTS as Te,HealthBus as Ee,KNOWLEDGE_ORIGINS as De,SOURCE_TYPES as Oe,TOKEN_BUDGETS as ke,addLogListener as Ae,computePartitionKey as je,createLogger as L,getGlobalDataDir as Me,getPartitionDir as Ne,isUserInstalled as Pe,listWorkspaces as Fe,serializeError as R}from"../../core/dist/index.js";import{FileCache as Ie,acquireLease as Le,addToWorkset as Re,audit as ze,bookendReorder as Be,changelog as Ve,check as He,checkpointDiff as Ue,checkpointGC as We,checkpointHistory as Ge,checkpointLatest as Ke,checkpointList as qe,checkpointLoad as Je,checkpointSave as Ye,codemod as Xe,compact as Ze,compressTerminalOutput as Qe,createRestorePoint as $e,createSearchSuccessResponse as et,dataTransform as tt,delegate as nt,delegateListModels as rt,deleteWorkset as it,diffParse as at,digest as ot,encode as st,ensureLegacyStashImported as ct,envInfo as lt,evaluate as ut,evidenceMap as dt,fileSummary as ft,find as pt,findDeadSymbols as mt,findExamples as ht,forgeClassify as gt,forgeGround as _t,getWorkset as vt,gitContext as yt,graphAugmentSearch as bt,graphQuery as xt,guide as St,health as Ct,httpRequest as wt,laneCreate as Tt,laneDiff as Et,laneDiscard as Dt,laneList as Ot,laneMerge as kt,laneStatus as At,listActiveLeases as jt,listRestorePoints as Mt,listWorksets as Nt,measure as Pt,onboard as Ft,parseOutput as It,processList as Lt,processLogs as Rt,processStart as zt,processStatus as Bt,processStop as Vt,queueClear as Ht,queueCreate as Ut,queueDag as Wt,queueDelete as Gt,queueDone as Kt,queueFail as qt,queueGet as Jt,queueList as Yt,queueNext as Xt,queuePush as Zt,regexTest as Qt,releaseLease as $t,removeFromWorkset as en,rename as tn,replayAppend as nn,replayClear as rn,replayList as an,replayTrim as on,restoreFromPoint as sn,saveWorkset as cn,schemaValidate as ln,scopeMap as un,scoreCompliance as dn,sessionDigest as fn,sessionDigestSampling as pn,stashClear as mn,stashDelete as hn,stashGet as gn,stashList as _n,stashSet as vn,storeReversibleContext as yn,stratumCard as bn,summarizeCheckResult as xn,symbol as Sn,testRun as Cn,timeUtils as wn,trace as Tn,truncateToTokenBudget as z,watchList as En,watchStart as Dn,watchStop as On,webFetch as kn,webSearch as An}from"../../tools/dist/index.js";import{mkdir as jn,readFile as Mn,readdir as Nn,rm as Pn,stat as Fn,unlink as In,writeFile as Ln}from"node:fs/promises";import{homedir as Rn,tmpdir as zn}from"node:os";import{McpServer as Bn,ResourceTemplate as Vn}from"@modelcontextprotocol/sdk/server/mcp.js";import{RootsListChangedNotificationSchema as Hn}from"@modelcontextprotocol/sdk/types.js";import{buildFormSchema as Un,field as Wn,normalizeResponse as Gn}from"../../elicitation/dist/index.js";import{completable as Kn}from"@modelcontextprotocol/sdk/server/completable.js";import{z as B}from"zod";import{getEngine as qn,registerBrowserTools as Jn}from"../../browser/dist/index.js";import{BlastRadiusAnalyzer as Yn,DependencyAnalyzer as Xn,DiagramGenerator as Zn,EntryPointAnalyzer as Qn,KnowledgeProducer as $n,PatternAnalyzer as er,StructureAnalyzer as tr,SymbolAnalyzer as nr}from"../../analyzers/dist/index.js";import{WasmDiagnostics as rr,WasmRuntime as ir,initializeWasm as ar}from"../../chunker/dist/index.js";import{ERCache as or,ERClient as sr,EvolutionCollector as cr,PolicyStore as lr,PushAdapter as ur,mergeResults as dr}from"../../enterprise-bridge/dist/index.js";import"../../tool-routing/dist/index.mjs";import{RESOURCE_MIME_TYPE as fr,getUiCapability as pr,registerAppResource as mr,registerAppTool as hr}from"@modelcontextprotocol/ext-apps/server";import{SqliteGraphStore as gr,allMigrations as _r,createSqliteAdapter as vr,createStateStore as yr,createStore as br,runMigrations as xr}from"../../store/dist/index.js";import{execFile as Sr,execSync as Cr}from"node:child_process";import{TemplateRegistry as wr,buildShell as Tr,dashboardTemplateDefinition as Er,defaultRegistry as Dr,flameGraphTemplateDefinition as Or,isError as kr,isResult as Ar,kanbanTemplateDefinition as jr,listSortTemplateDefinition as Mr,renderSurface as Nr}from"../../blocks-core/dist/index.mjs";import{createServer as Pr}from"node:http";import{EmbedderProxy as Fr}from"../../embeddings/dist/index.js";import{FileHashCache as Ir,IncrementalIndexer as Lr}from"../../indexer/dist/index.js";function Rr(e){function t(){return!!e.server?.getClientCapabilities?.()?.elicitation}async function n(n,r){if(t())try{let t=await e.server.elicitInput({message:n,requestedSchema:r});return Gn(t?{action:t.action,content:t.content}:void 0)}catch{return}}return{get available(){return t()},async ask(e){return await n(e.message,e.schema)||{action:`decline`}},async confirm(e){let t=await n(e,Un({confirmed:Wn.confirm(e)}));return t?.action===`accept`&&t.content?.confirmed===!0},async selectOne(e,t){let r=await n(e,Un({selection:Wn.select(`Choose one`,t)}));if(r?.action!==`accept`)return null;let i=r.content?.selection;return typeof i==`string`?i:null},async selectMany(e,t){let r=await n(e,Un({selections:Wn.multi(`Choose one or more`,t)}));if(r?.action!==`accept`)return[];let i=r.content?.selections;return Array.isArray(i)?i:[]},async promptText(e,t){let r=await n(e,Un({text:Wn.text(e,{description:t})}));if(r?.action!==`accept`)return null;let i=r.content?.text;return typeof i==`string`?i:null}}}const zr={debug:`debug`,info:`info`,warn:`warning`,error:`error`};function Br(e){return Ae(({level:t,component:n,message:r,data:i})=>{try{Promise.resolve(e.sendLoggingMessage({level:zr[t],logger:n,data:i?{message:r,...i}:r})).catch(()=>{})}catch{}})}const Vr=3e4,Hr=new Map;function Ur(e,t,n){let r=Hr.get(e);if(r&&Date.now()<r.expires)return Promise.resolve(r.data);let i=n();return Promise.resolve(i).then(n=>(Hr.set(e,{data:n,expires:Date.now()+t}),n))}function Wr(){Hr.clear()}function Gr(e,t){return Ur(`curated-paths`,Vr,async()=>e.listPaths({limit:5e3})).then(e=>e.filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20))}function Kr(e,t){return Ur(`file-paths`,Vr,()=>e.listSourcePaths()).then(e=>e.filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20))}function qr(e,t){return Ur(`symbol-names`,Vr,async()=>(await e.findNodes({type:`symbol`,limit:500})).map(e=>e.name)).then(e=>e.filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20))}function Jr(e,t){return t?_n(t).map(e=>e.key).filter(t=>t.toLowerCase().includes(e.toLowerCase())).slice(0,20):[]}function Yr(e){return Nt().map(e=>e.name).filter(t=>t.toLowerCase().includes(e.toLowerCase())).slice(0,20)}function Xr(e,t){return t?qe(t).map(e=>e.label).filter(t=>t.toLowerCase().includes(e.toLowerCase())).slice(0,20):[]}function Zr(e,t,n){if(e.registerPrompt(`ready`,{title:`AI Kit Ready`,description:`AI Kit is ready — quick-start guide for search, onboard, and workflows`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`AI Kit is ready. Quick start:`,``,'• **New project?** → `onboard({ path: "." })` for full codebase analysis','• **Returning?** → `status({})` then `search({ query: "SESSION CHECKPOINT", origin: "curated" })`','• **Exploring?** → `guide({ goal: "your task" })` for workflow recommendations','• **Quick lookup?** → `search({ query: "your question" })`'].join(`
|
|
3
|
+
`)}}]})),e.registerPrompt(`onboard`,{title:`Onboard Codebase`,description:`Analyze the codebase for first-time onboarding — runs all analyzers and produces a knowledge summary`,argsSchema:{path:B.string().optional().describe(`Path to analyze (default: workspace root)`)}},async({path:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Run the full onboarding workflow for "${e??`.`}"`,``,`1. \`onboard({ path: "${e??`.`}" })\` — full codebase analysis`,`2. \`produce_knowledge({ path: "${e??`.`}" })\` — generate synthesis`,'3. `knowledge({ action: "remember", ... })` for key curated entries',"4. `status` to verify index health"].join(`
|
|
4
4
|
`)}}]})),e.registerPrompt(`sessionStart`,{title:`Start AI Kit Session`,description:`Initialize an AI Kit session — check status, list knowledge, and resume from last checkpoint`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`Run the session start protocol:`,``,"1. `status({})` — check AI Kit health and onboard state",'2. `knowledge({ action: "list" })` — see stored knowledge entries','3. `search({ query: "SESSION CHECKPOINT", origin: "curated" })` — resume prior work'].join(`
|
|
5
|
-
`)}}]})),e.registerPrompt(`sessionEnd`,{title:`End AI Kit Session`,description:`Persist decisions and create a session checkpoint before ending`,argsSchema:{summary:
|
|
6
|
-
`)}}]})),e.registerPrompt(`search`,{title:`Search AI Kit`,description:`Search AI Kit with hybrid semantic + keyword search`,argsSchema:{query:
|
|
7
|
-
`)}}]})),e.registerPrompt(`investigate`,{title:`Investigate Bug`,description:`Bug investigation workflow — parse error, find symbols, trace data flow, assess impact`,argsSchema:{error:
|
|
8
|
-
`)}}]})),!t)return;let{curated:r,store:i,graphStore:a}=t;e.registerPrompt(`read_knowledge`,{title:`Read Knowledge`,description:`Read a curated knowledge entry by path — with autocomplete`,argsSchema:{path:
|
|
5
|
+
`)}}]})),e.registerPrompt(`sessionEnd`,{title:`End AI Kit Session`,description:`Persist decisions and create a session checkpoint before ending`,argsSchema:{summary:B.string().describe(`Brief summary of decisions made, blockers encountered, and next steps`)}},async({summary:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Run the session end protocol:`,``,'1. `knowledge({ action: "remember", title: "Session checkpoint: '+e.slice(0,60)+`...", content: "`+e.replace(/"/g,`\\"`)+'", category: "session" })` — persist findings',n===`smart`?`2. Smart indexing is active — index refreshes automatically`:"2. `reindex({})` — refresh search index if files changed",`3. Confirm session data saved`].join(`
|
|
6
|
+
`)}}]})),e.registerPrompt(`search`,{title:`Search AI Kit`,description:`Search AI Kit with hybrid semantic + keyword search`,argsSchema:{query:B.string().describe(`Search query`)}},async({query:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Search AI Kit for: "${e}"\n\nUse \`search({ query: "${e.replace(/"/g,`\\"`)}" })\` to find relevant code, documentation, and curated knowledge.`}}]})),e.registerPrompt(`remember`,{title:`Remember Knowledge`,description:`Store a decision, convention, or finding as curated knowledge`,argsSchema:{title:B.string().describe(`Title of the knowledge entry`),content:B.string().describe(`Content to remember`),category:B.enum([`conventions`,`decisions`,`patterns`,`blockers`,`tasks`]).optional().describe(`Category (default: conventions)`)}},async({title:e,content:t,category:n})=>({messages:[{role:`user`,content:{type:`text`,text:`Store this knowledge:\n\n\`knowledge({ action: "remember", title: "${e.replace(/"/g,`\\"`)}", content: "${t.replace(/"/g,`\\"`).slice(0,200)}...", category: "${n??`conventions`}" })\``}}]})),e.registerPrompt(`planTask`,{title:`Plan a Task`,description:`Generate a reading plan and scope map for a development task`,argsSchema:{task:B.string().describe(`Description of the task to plan`)}},async({task:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Plan implementation for: "${e}"`,``,'1. `search({ query: "'+e.replace(/"/g,`\\"`)+'" })` — find related code and prior decisions','2. `scope_map({ task: "'+e.replace(/"/g,`\\"`)+'" })` — generate a reading plan',"3. For each recommended file, use `file_summary` then `compact` for detail","4. `blast_radius` on planned changes to assess impact"].join(`
|
|
7
|
+
`)}}]})),e.registerPrompt(`investigate`,{title:`Investigate Bug`,description:`Bug investigation workflow — parse error, find symbols, trace data flow, assess impact`,argsSchema:{error:B.string().describe(`Error message, stack trace, or bug description`)}},async({error:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Investigate this error:`,"```",e,"```",``,`Follow the bug investigation workflow:`,"1. `parse_output({ text: <error> })` — extract structured data from the error","2. `symbol({ name: <relevant symbol> })` — find definition and references",'3. `trace({ symbol: <symbol>, direction: "backward" })` — trace data flow to find root cause',"4. `blast_radius({ changed_files: [<affected files>] })` — assess fix impact"].join(`
|
|
8
|
+
`)}}]})),!t)return;let{curated:r,store:i,graphStore:a}=t;e.registerPrompt(`read_knowledge`,{title:`Read Knowledge`,description:`Read a curated knowledge entry by path — with autocomplete`,argsSchema:{path:Kn(B.string().describe(`Path of the curated entry (e.g. conventions/naming.md)`),async e=>Gr(r,e))}},async({path:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Read the curated knowledge entry: \`knowledge({ action: "read", path: "${e}" })\``}}]})),e.registerPrompt(`update_knowledge`,{title:`Update Knowledge`,description:`Update an existing curated knowledge entry — with autocomplete`,argsSchema:{path:Kn(B.string().describe(`Path of the curated entry to update`),async e=>Gr(r,e)),content:B.string().describe(`New content for the entry`)}},async({path:e,content:t})=>({messages:[{role:`user`,content:{type:`text`,text:`Update the curated entry at "${e}":\n\n\`knowledge({ action: "update", path: "${e}", content: "${t.replace(/"/g,`\\"`).slice(0,200)}..." })\``}}]})),e.registerPrompt(`forget_knowledge`,{title:`Forget Knowledge`,description:`Delete a curated knowledge entry — with autocomplete`,argsSchema:{path:Kn(B.string().describe(`Path of the curated entry to delete`),async e=>Gr(r,e))}},async({path:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Delete the curated entry: \`knowledge({ action: "forget", path: "${e}" })\``}}]})),e.registerPrompt(`lookup_file`,{title:`Lookup File`,description:`Look up an indexed file — with autocomplete`,argsSchema:{path:Kn(B.string().describe(`Source file path`),async e=>Kr(i,e))}},async({path:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Look up the indexed file: \`file_summary({ path: "${e}" })\``}}]})),e.registerPrompt(`find_symbol`,{title:`Find Symbol`,description:`Find a symbol definition and references — with autocomplete`,argsSchema:{name:Kn(B.string().describe(`Symbol name`),async e=>qr(a,e))}},async({name:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Find symbol: \`symbol({ name: "${e}" })\``}}]})),e.registerPrompt(`get_stash`,{title:`Get Stash`,description:`Retrieve a stashed value by key — with autocomplete`,argsSchema:{key:Kn(B.string().describe(`Stash key`),e=>Jr(e,t?.stateStore))}},async({key:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Get stashed value: \`stash({ action: "get", key: "${e}" })\``}}]})),e.registerPrompt(`get_workset`,{title:`Get Workset`,description:`Load a saved workset by name — with autocomplete`,argsSchema:{name:Kn(B.string().describe(`Workset name`),e=>Yr(e))}},async({name:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Load workset: \`workset({ action: "load", name: "${e}" })\``}}]})),e.registerPrompt(`load_checkpoint`,{title:`Load Checkpoint`,description:`Restore a saved checkpoint by name — with autocomplete`,argsSchema:{name:Kn(B.string().describe(`Checkpoint name`),e=>Xr(e,t?.stateStore))}},async({name:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Load checkpoint: \`checkpoint({ action: "load", name: "${e}" })\``}}]})),e.registerPrompt(`audit_workflow`,{title:`Audit Workflow`,description:`Run a full project quality audit: check → test_run → audit → produce recommendations`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Audit Workflow`,``,`Execute the following tools in sequence:`,``,"1. `check({})` — Run typecheck + lint","2. `test_run({})` — Run all tests","3. `audit({})` — Full project audit","4. Review findings and `remember` important patterns",``,`Report: pass/fail status, error counts, audit recommendations, and suggested next steps.`].join(`
|
|
9
9
|
`)}}]})),e.registerPrompt(`refactor_workflow`,{title:`Refactor Workflow`,description:`Safe refactoring workflow: analyze → blast_radius → implement → verify`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Refactor Workflow`,``,`For the target files/symbols:`,``,'1. `analyze({ aspect: "structure", path })` — Understand current structure','2. `analyze({ aspect: "dependencies", path })` — Map dependency graph',"3. `blast_radius({ changed_files })` — Assess impact scope",`4. Implement changes carefully`,"5. `check({})` + `test_run({})` — Verify nothing broke",n===`smart`?`6. Smart indexing is active — changes will be indexed automatically`:"6. `reindex({})` — Update AI Kit with changes",``,`What would you like to refactor?`].join(`
|
|
10
10
|
`)}}]})),e.registerPrompt(`forge_workflow`,{title:`FORGE Workflow`,description:`Full FORGE protocol: classify → ground → implement with quality gates`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## FORGE Quality Gate Workflow`,``,"1. `forge_classify({ task })` — Determine complexity tier (floor/standard/critical)","2. `forge_ground({ task, files, root_path })` — Full grounding analysis",`3. Review typed unknowns and constraints`,`4. Implement with evidence tracking`,'5. `evidence_map({ action: "validate" })` — Verify all claims',"6. `check({})` + `test_run({})` — Final verification",``,`Describe the task to classify:`].join(`
|
|
11
11
|
`)}}]})),e.registerPrompt(`investigate_workflow`,{title:`Investigate Issue`,description:`Bug investigation workflow: trace → analyze → find root cause → fix`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Bug Investigation Workflow`,``,"1. `parse_output({ output })` — Parse error messages if available","2. `symbol({ name })` — Find the failing symbol",'3. `trace({ symbol, direction: "backward" })` — Trace data flow to root cause',"4. `blast_radius({ changed_files })` — Assess impact of fix",`5. Implement fix`,"6. `check({})` + `test_run({})` — Verify fix works",``,`Describe the issue:`].join(`
|
|
12
12
|
`)}}]})),e.registerPrompt(`context_workflow`,{title:`Build Context`,description:`Progressive context building: file_summary → compact → digest for deep understanding`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Context Building Workflow`,``,`Build understanding progressively:`,``,"1. `file_summary({ path })` — Structure overview (~50 tokens)","2. `compact({ path, query })` or `compact({ ref, query? })` — Extract relevant sections (5-20x reduction)","3. `digest({ sources })` — Multi-file compressed summary","4. `stratum_card({ files })` — Reusable reference card",``,`For project-wide context:`,"- `scope_map({ task })` — Reading plan for a specific task",'- `workset({ action: "save" })` — Save working set for later',``,`What do you need to understand?`].join(`
|
|
13
13
|
`)}}]})),e.registerPrompt(`migrate_workflow`,{title:`Migration Workflow`,description:`Code migration workflow: analyze → plan → migrate → verify → document`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Migration Workflow`,``,'1. `analyze({ aspect: "structure", path })` — Current codebase state','2. `analyze({ aspect: "patterns", path })` — Identify patterns to migrate',"3. `dead_symbols({ path })` — Find unused code to remove",'4. `scope_map({ task: "migration" })` — Plan migration scope',"5. Use `codemod` for bulk transformations","6. `check({})` + `test_run({})` — Verify after each step","7. `changelog({ from })` — Document changes",``,`What are you migrating from/to?`].join(`
|
|
14
|
-
`)}}]}))}const
|
|
15
|
-
`)}function
|
|
16
|
-
`)})})}function
|
|
17
|
-
`)})})}function
|
|
18
|
-
`)})})}function
|
|
19
|
-
`).filter(Boolean).map(e=>{try{return JSON.parse(e)}catch{return null}}).filter(
|
|
20
|
-
`)}`;n.push({title:`Dependencies: ${r}`,content:t,category:`context`,tags:[`architecture`,`dependencies`,`analysis`],hash:
|
|
21
|
-
`)}`,category:`context`,tags:[`architecture`,`entry-points`],hash:B(`entry-points`),identityKey:`analyze:entry-points`,quality:.7,source:e.toolName})}if(e.toolName===`scope_map`){let r=typeof e.args.task==`string`?e.args.task:``;r&&t.length>100&&n.push({title:`Scope map: ${r.slice(0,60)}`,content:`Scope analysis for "${r}":\n${t.slice(0,500)}`,category:`context`,tags:[`planning`,`scope-map`],hash:B(`scope-${r}`),identityKey:`scope-map:${r}`,quality:.6,source:e.toolName,ttlMs:72e5})}return e.toolName===`onboard`&&t.length>200&&n.push({title:`Onboard analysis summary`,content:`Codebase onboarding analysis:\n${t.slice(0,800)}`,category:`context`,tags:[`onboarding`,`analysis`,`structure`],hash:B(`onboard-summary`),identityKey:`onboard:summary`,quality:.9,source:e.toolName}),n}};function Mi(e,t,n,r,i,a,o,s){return{title:e,content:t,category:`context`,tags:s,hash:B(n),identityKey:r,quality:i,ttlMs:a,source:o}}const Ni={name:`context-reads`,tools:[`compact`,`file_summary`,`digest`,`lookup`,`stratum_card`],extract(e){if(e.isError)return[];let t=ei(e.result);if(!t)return[];if(e.toolName===`compact`){let n=typeof e.args.path==`string`?e.args.path:void 0,r=typeof e.args.query==`string`?e.args.query:void 0;return!n||!r||t.length<100?[]:[Mi(`Context: ${n} (${r.slice(0,40)})`,t.slice(0,800),`compact-${n}-${r}`,`compact:${n}:${r}`,.7,72e5,e.toolName,[`context`,`compact`,`file-read`])]}if(e.toolName===`file_summary`){let n=typeof e.args.path==`string`?e.args.path:void 0;return!n||t.length<50?[]:[Mi(`Structure: ${n}`,t,`file-summary-${n}`,`file-summary:${n}`,.65,144e5,e.toolName,[`context`,`file-summary`,`structure`])]}if(e.toolName===`digest`){let n=typeof e.args.query==`string`?e.args.query:void 0;if(!n||t.length<150)return[];let r=Array.isArray(e.args.sources)?e.args.sources.map(e=>{if(!e||typeof e!=`object`)return``;let t=e.id;return typeof t==`string`?t:``}).join(`,`):``;return[Mi(`Digest: ${n.slice(0,60)}`,t.slice(0,1e3),`digest-${n}-${r}`,`digest:${n}:${r}`,.75,72e5,e.toolName,[`context`,`digest`,`compression`])]}if(e.toolName===`lookup`){let n=typeof e.args.path==`string`?e.args.path:void 0;return!n||t.length<100?[]:[Mi(`Indexed: ${n}`,t.slice(0,600),`lookup-${n}`,`lookup:${n}`,.5,72e5,e.toolName,[`context`,`lookup`,`file-content`])]}if(e.toolName===`stratum_card`){let n=Array.isArray(e.args.files)?e.args.files.filter(e=>typeof e==`string`):[],r=typeof e.args.query==`string`?e.args.query:``,i=typeof e.args.tier==`string`?e.args.tier:void 0;if(n.length===0||!i||t.length<50)return[];let a=n.join(`,`),o=i===`T2`?`stratum-${a}-${i}-${r}`:`stratum-${a}-${i}`;return[Mi(`Card [${i}]: ${n[0]} (+${n.length-1})`,t.slice(0,600),o,`stratum:${i}:${a}:${r}`,i===`T2`?.7:.55,72e5,e.toolName,[`context`,`stratum-card`,i])]}return[]}};function Pi(e,t){let n=[],r=e.toLowerCase();r.includes(`biome`)?n.push({title:`Linter: Biome`,content:`This project uses Biome for linting and formatting.`,category:`conventions`,tags:[`tooling`,`linter`,`biome`],hash:B(`convention-linter-biome`),quality:.8,source:t}):r.includes(`eslint`)&&n.push({title:`Linter: ESLint`,content:`This project uses ESLint for linting.`,category:`conventions`,tags:[`tooling`,`linter`,`eslint`],hash:B(`convention-linter-eslint`),quality:.8,source:t}),r.includes(`prettier`)&&n.push({title:`Formatter: Prettier`,content:`This project uses Prettier for code formatting.`,category:`conventions`,tags:[`tooling`,`formatter`,`prettier`],hash:B(`convention-formatter-prettier`),quality:.8,source:t}),(/strict\s*(?:mode)?.*(?:enabled|true)/i.test(e)||/"strict"\s*:\s*true/.test(e))&&n.push({title:`TypeScript strict mode enabled`,content:`This project has TypeScript strict mode enabled. Ensure all types are explicit.`,category:`conventions`,tags:[`typescript`,`strict`,`config`],hash:B(`convention-ts-strict`),quality:.8,source:t});for(let e of[`pnpm`,`yarn`,`npm`,`bun`])if(r.includes(e)&&(r.includes(`lockfile`)||r.includes(`workspace`)||r.includes(`${e} run`))){n.push({title:`Package manager: ${e}`,content:`This project uses ${e} as its package manager.`,category:`conventions`,tags:[`tooling`,`package-manager`,e],hash:B(`convention-pm-${e}`),quality:.7,source:t});break}return(r.includes(`monorepo`)||r.includes(`workspaces`)||/packages\/\w+/.test(e))&&n.push({title:`Monorepo structure detected`,content:`This project uses a monorepo structure with multiple packages.`,category:`conventions`,tags:[`architecture`,`monorepo`],hash:B(`convention-monorepo`),quality:.7,source:t}),n}function Fi(e,t){let n=[],r=e.matchAll(/(?:pattern|convention):\s*(.+?)(?:\n|$)/gi);for(let e of r){let r=e[1]?.trim();r&&r.length>20&&r.length<200&&n.push({title:`Pattern: ${r.slice(0,80)}`,content:r,category:`patterns`,tags:[`detected-pattern`],hash:B(`pattern-${r}`),quality:.6,source:t})}return n}const Ii={name:`convention-detection`,tools:[`check`,`analyze`,`onboard`],extract(e){let t=ei(e.result);if(!t||e.isError)return[];let n=[];return n.push(...Pi(t,e.toolName)),e.toolName===`analyze`&&e.args.aspect===`patterns`&&n.push(...Fi(t,e.toolName)),n}};function Li(e,t){return e.match(t)?.[1]?.trim()||null}function Ri(e,t,n,r,i,a){return{title:e,content:t,category:`context`,tags:n,hash:B(r),quality:i,source:a}}const zi={name:`environment-facts`,tools:[`env`,`config`,`status`],extract(e){let t=ei(e.result);if(!t)return[];let n=[],r=Li(t,/node(?:\.js)?\s*[:=]\s*([^\r\n]+)/i);r&&n.push(Ri(`Node.js version`,`Detected Node.js version: ${r}`,[`environment`,`node`],`node-version-${r}`,.4,e.toolName));let i=Li(t,/(?:^|\n)os\s*[:=]\s*([^\r\n]+)/i);i&&n.push(Ri(`Operating system`,`Detected OS: ${i}`,[`environment`,`os`],`os-${i}`,.4,e.toolName));let a=Li(t,/workspace(?: path)?\s*[:=]\s*([^\r\n]+)/i);a&&n.push(Ri(`Workspace path`,`Primary workspace path: ${a}`,[`environment`,`workspace`],`workspace-${a}`,.4,e.toolName));let o=Li(t,/store(?: backend)?\s*[:=]\s*([^\r\n]+)/i);o&&n.push(Ri(`Store backend`,`Configured store backend: ${o}`,[`environment`,`storage`],`store-${o}`,.6,e.toolName));let s=Li(t,/embedding(?: model)?\s*[:=]\s*([^\r\n]+)/i);return s&&n.push(Ri(`Embedding model`,`Configured embedding model: ${s}`,[`environment`,`embedding`],`embedding-${s}`,.6,e.toolName)),n}},Bi={"search-result":800,"file-card":2e3,analysis:1500,"step-summary":3e3},Vi=[`search`,`file_summary`,`stratum_card`,`compact`,`blast_radius`,`scope_map`],Hi={search:`search-result`,file_summary:`file-card`,stratum_card:`file-card`,compact:`analysis`,blast_radius:`analysis`,scope_map:`step-summary`},Ui={"search-result":72e5,"file-card":144e5,analysis:144e5,"step-summary":288e5};function Wi(e){return e.replace(/\s+/g,` `).trim()}function Gi(e){return Math.max(.6,Math.min(.8,ti(e)))}function V(e,t=500){let n=Wi(e);return n.length<=t?n:`${n.slice(0,Math.max(0,t-3)).trimEnd()}...`}function Ki(e){return typeof e==`object`&&!!e}function qi(e){try{return JSON.parse(e)}catch{return null}}function H(e){return typeof e==`string`?Wi(e):typeof e==`number`||typeof e==`boolean`?String(e):``}function Ji(e,t=5){if(!Array.isArray(e))return[];let n=[];for(let r of e){if(n.length>=t)break;if(typeof r==`string`){let e=Wi(r);e&&n.push(e);continue}if(Ki(r)){let e=H(r.path)||H(r.sourcePath)||H(r.title)||H(r.name)||H(r.label);e&&n.push(e)}}return n}function U(e,...t){for(let n of t){let t=H(e[n]);if(t)return t}return``}function Yi(e){let t=[e.file,e.path,e.files,e.changed_files,e.changedFiles].flatMap(e=>typeof e==`string`?[Wi(e)]:Ji(e,6));return[...new Set(t.filter(Boolean))].slice(0,6)}function Xi(e,t=6){let n=e.match(/(?:[A-Za-z]:[\\/]|\.\/?|\.\.[\\/]|[A-Za-z0-9_.-]+\/)[^\s,:;]+\.[A-Za-z0-9]+/g)??[];return[...new Set(n.map(e=>Wi(e)))].slice(0,t)}function Zi(e,t){return e.length===0?``:`${t}: ${e.join(`, `)}`}function Qi(e,t=3){return e.split(/\r?\n/).map(e=>Wi(e)).filter(e=>e.length>=12).slice(0,t)}function $i(e){if(!Ki(e))return``;let t=H(e.title)||H(e.path)||H(e.sourcePath)||H(e.file),n=H(e.snippet)||H(e.preview)||H(e.content)||H(e.summary);return Wi([t,n&&`- ${n}`].filter(Boolean).join(` `))}function ea(e,t){let n=U(e,`query`),r=qi(t);if(Ki(r)&&Array.isArray(r.results)){let e=r.results.map(e=>$i(e)).filter(Boolean).slice(0,3);if(e.length>0)return V(`Query: ${n||`unknown`}. Top hits: ${e.join(` | `)}`,Bi[`search-result`])}let i=Qi(t,3);return V(`Query: ${n||`unknown`}. Top hits: ${i.join(` | `)}`,Bi[`search-result`])}function ta(e,t){let n=U(e,`path`,`file`),r=qi(t);if(Ki(r)){let e=H(r.path)||n||`unknown file`,t=Ji(r.imports,4),i=Ji(r.exports,5),a=Ji(r.functions,4),o=[`File: ${e}`,Zi(i,`Exports`),Zi(t,`Imports`),Zi(a,`Functions`)].filter(Boolean);if(o.length>1)return V(o.join(`. `),Bi[`file-card`])}let i=Qi(t,4);return V(`File: ${n||`unknown file`}. Structure: ${i.join(` | `)}`,Bi[`file-card`])}function na(e,t){let n=Yi(e),r=U(e,`tier`)||`T1`,i=qi(t);if(Ki(i)){let e=(Array.isArray(i.cards)?i.cards:[]).map(e=>$i(e)).filter(Boolean).slice(0,3);if(e.length>0)return V(`Tier: ${r}. Files: ${n.join(`, `)||`unknown`}. Cards: ${e.join(` | `)}`,Bi[`file-card`])}let a=Qi(t,3);return V(`Tier: ${r}. Files: ${n.join(`, `)||`unknown`}. Highlights: ${a.join(` | `)}`,Bi[`file-card`])}function ra(e,t){let n=U(e,`path`,`file`),r=U(e,`query`);return V(`Path: ${n||`unknown`}. Focus: ${r||`general`}. Summary: ${t}`,Bi.analysis)}function ia(e,t){let n=Yi(e),r=qi(t),i=Ki(r)?[...Ji(r.affectedFiles,8),...Ji(r.tests,4),...Ji(r.importers,4)]:[],a=[...new Set([...i,...Xi(t,8)])].slice(0,8),o=[`Changed: ${n.join(`, `)||`unknown`}`,Zi(a,`Affected`)].filter(Boolean);return o.length>1?V(o.join(`. `),Bi.analysis):V(`Changed: ${n.join(`, `)||`unknown`}. Summary: ${t}`,Bi.analysis)}function aa(e,t){let n=U(e,`task`),r=qi(t);if(Ki(r)){let e=Ji(r.files,6),t=typeof r.totalFiles==`number`?r.totalFiles:e.length;if(e.length>0)return V(`Task: ${n||`unknown`}. Reading plan (${t} files): ${e.join(`, `)}`,Bi[`step-summary`])}let i=Xi(t,6);return V(`Task: ${n||`unknown`}. Reading plan: ${i.join(`, `)||Qi(t,3).join(` | `)}`,Bi[`step-summary`])}function oa(e,t){switch(e.toolName){case`search`:return ea(e.args,t);case`file_summary`:return ta(e.args,t);case`stratum_card`:return na(e.args,t);case`compact`:return ra(e.args,t);case`blast_radius`:return ia(e.args,t);case`scope_map`:return aa(e.args,t);default:return``}}function sa(e){switch(e.toolName){case`search`:return V(`Search: ${U(e.args,`query`)||`unknown query`}`,120);case`file_summary`:return V(`File summary: ${U(e.args,`path`,`file`)||`unknown file`}`,120);case`stratum_card`:return V(`Stratum card: ${Yi(e.args).join(`, `)||`unknown files`}${U(e.args,`tier`)?` (${U(e.args,`tier`)})`:``}`,120);case`compact`:return V(`Compact: ${U(e.args,`path`,`file`)||`unknown path`}${U(e.args,`query`)?` - ${U(e.args,`query`)}`:``}`,120);case`blast_radius`:return V(`Blast radius: ${Yi(e.args).join(`, `)||`unknown changes`}`,120);case`scope_map`:return V(`Scope map: ${U(e.args,`task`)||`unknown task`}`,120);default:return V(`Flow context: ${e.toolName}`,120)}}function ca(e){switch(e.toolName){case`search`:return`search:${U(e.args,`query`)||`unknown-query`}`;case`file_summary`:return`file-summary:${U(e.args,`path`,`file`)||`unknown-file`}`;case`stratum_card`:{let t=Yi(e.args).join(`,`),n=U(e.args,`tier`)||`unknown-tier`,r=U(e.args,`query`);return`stratum:${n}:${t}${r?`:${r}`:``}`}case`compact`:{let t=U(e.args,`path`,`file`)||`unknown-path`,n=U(e.args,`query`);return`compact:${t}${n?`:${n}`:``}`}case`blast_radius`:return`blast-radius:${Yi(e.args).join(`,`)||`unknown-changes`}`;case`scope_map`:return`scope-map:${U(e.args,`task`)||`unknown-task`}`;default:return`${e.toolName}:generic`}}function la(e){return{name:`flow-context`,tools:[...Vi],extract(t){if(t.isError)return[];let n=e();if(!n?.active||!n.slug||!(t.toolName in Hi))return[];let r=ei(t.result).trim();if(r.length<50)return[];let i=Hi[t.toolName],a=oa(t,r);if(a.length<50)return[];let o=sa(t);return[{title:o,content:a,category:`flow-context`,tags:[`flow-context`,`flow:${n.slug}`,i,`tool:${t.toolName}`],hash:B(`${n.slug}|${t.toolName}|${o}|${a}`),identityKey:ca(t),quality:Gi(a),ttlMs:Ui[i],source:t.toolName}]}}}const ua={name:`research-results`,tools:[`web_search`,`web_fetch`,`search`,`find`],extract(e){let t=ei(e.result);if(!t||t.length<100||e.isError)return[];let n=[];if(e.toolName===`web_search`){let r=typeof e.args.query==`string`?e.args.query:``;if(r&&t.length>200){let i=t.slice(0,800);n.push({title:`Web research: ${r.slice(0,80)}`,content:`Research query: "${r}"\n\nKey findings:\n${i}`,category:`context`,tags:[`research`,`web-search`],hash:B(`web-search-${r}`),quality:Math.min(.8,ti(i)+.2),source:e.toolName,ttlMs:864e5})}}if(e.toolName===`web_fetch`){let r=e.args.urls,i=Array.isArray(r)?String(r[0]??``):typeof e.args.url==`string`?e.args.url:``;if(i&&t.length>200){let r=t.split(/\r?\n/).find(e=>e.trim().length>10)?.trim()??i,a=t.slice(0,600);n.push({title:`Fetched: ${r.slice(0,80)}`,content:`Source: ${i}\n\n${a}`,category:`context`,tags:[`research`,`web-fetch`],hash:B(`web-fetch-${i}`),quality:ti(a),source:e.toolName,ttlMs:864e5})}}if(e.toolName===`search`){let r=typeof e.args.query==`string`?e.args.query:``,i=typeof e.args.origin==`string`?e.args.origin:``,a=typeof e.args.search_mode==`string`?e.args.search_mode:`hybrid`;i===`curated`&&r&&t.length>100&&n.push({title:`Curated search: ${r.slice(0,80)}`,content:`Searched curated knowledge for: "${r}"\n\nResults:\n${t.slice(0,500)}`,category:`context`,tags:[`research`,`curated-search`],hash:B(`curated-search-${r}`),quality:.5,source:e.toolName,ttlMs:36e5}),i!==`curated`&&r&&t.length>150&&n.push({title:`Search: ${r.slice(0,80)}`,content:t.slice(0,500),category:`context`,tags:[`research`,`search`,i||`hybrid`,a],hash:B(`search-${r}-${i||`hybrid`}-${a}`),quality:.5,source:e.toolName,ttlMs:36e5})}if(e.toolName===`find`){let r=typeof e.args.query==`string`?e.args.query:``,i=typeof e.args.pattern==`string`?e.args.pattern:``,a=typeof e.args.glob==`string`?e.args.glob:``,o=typeof e.args.mode==`string`?e.args.mode:``,s=r||i||a||``;s&&t.length>100&&n.push({title:o?`Find (${o}): ${s.slice(0,60)}`:`Find: ${s.slice(0,60)}`,content:t.slice(0,600),category:`context`,tags:[`research`,`find`,o||`search`],hash:B(`find-${r}-${i}-${a}-${o}`),quality:.55,source:e.toolName,ttlMs:36e5})}return n}},da=new Set([`neighbors`,`traverse`,`find_nodes`,`symbol360`]),fa=144e5;function pa(e,t){return e.slice(0,t).trim()}function ma(e,t){let n=pa(t,800);return n.length<80?[]:[{title:`Symbol: ${e}`,content:n,category:`patterns`,tags:[`architecture`,`symbol`,`definition`],hash:B(`symbol-${e}`),quality:.7,ttlMs:fa,source:`symbol`}]}function ha(e,t,n){let r=pa(n,800);return r.length<100?[]:[{title:`Trace ${t}: ${e}`,content:r,category:`patterns`,tags:[`architecture`,`trace`,`data-flow`,t],hash:B(`trace-${e}-${t}`),quality:.75,ttlMs:fa,source:`trace`}]}function ga(e,t){return e===`find_nodes`?`Graph nodes: ${t}`:e===`neighbors`?`Graph neighbors: ${t}`:e===`traverse`?`Graph traverse: ${t}`:`Symbol360: ${t}`}function _a(e,t,n,r,i){let a=pa(i,600);return a.length<50?[]:[{title:ga(e,t),content:a,category:`patterns`,tags:[`architecture`,`graph`,e],hash:B(`graph-${e}-${t}-${n}-${r}`),quality:.6,ttlMs:fa,source:`graph`}]}const va={name:`symbol-analysis`,tools:[`symbol`,`trace`,`graph`],extract(e){let t=ei(e.result);if(!t||e.isError)return[];if(e.toolName===`symbol`){let n=typeof e.args.name==`string`?e.args.name:``;return n?ma(n,t):[]}if(e.toolName===`trace`){let n=typeof e.args.start==`string`?e.args.start:``,r=typeof e.args.direction==`string`?e.args.direction:``;return!n||!r?[]:ha(n,r,t)}if(e.toolName===`graph`){let n=typeof e.args.action==`string`?e.args.action:``;if(!da.has(n))return[];let r=typeof e.args.node_id==`string`?e.args.node_id:``,i=typeof e.args.name_pattern==`string`?e.args.name_pattern:``;if(n===`find_nodes`&&!i||(n===`neighbors`||n===`traverse`||n===`symbol360`)&&!r)return[];let a=typeof e.args.direction==`string`?e.args.direction:`both`,o=typeof e.args.max_depth==`number`?String(e.args.max_depth):``;return _a(n,n===`find_nodes`?i:r,a,o,t)}return[]}};function ya(e){let t=e.toLowerCase();return t.includes(`vitest`)?`vitest`:t.includes(`jest`)?`jest`:t.includes(`mocha`)?`mocha`:t.includes(`playwright`)?`playwright`:t.includes(`cypress`)?`cypress`:null}function ba(e){let t=[/(\S+\.test\.\w+)/,/(\S+\.spec\.\w+)/,/(\S+_test\.\w+)/,/__tests__\/\S+/],n=new Set;for(let r of t){let t=e.matchAll(new RegExp(r.source,`g`));for(let e of t){let t=e[0].match(/\.(test|spec)\.\w+$/);t&&n.add(t[0])}}return n.size>0?[...n].join(`, `):null}const xa={name:`test-results`,tools:[`check`,`test_run`],extract(e){let t=ei(e.result);if(!t)return[];let n=[],r=ya(t);r&&n.push({title:`Test framework: ${r}`,content:`This project uses ${r} for testing. Detected from ${e.toolName} output.`,category:`context`,tags:[`testing`,`environment`,r],hash:B(`test-framework-${r}`),quality:.7,source:e.toolName});let i=ba(t);return i&&n.push({title:`Test file pattern: ${i}`,content:`Test files use the naming pattern: ${i}. Follow this convention when creating new tests.`,category:`conventions`,tags:[`testing`,`naming-convention`],hash:B(`test-pattern-${i}`),quality:.7,source:e.toolName}),n}};function Sa(e){let t=e.toLowerCase();return/enoent|no such file|not found/i.test(e)?{type:`missing-file`,actionable:!1}:/econnreset|econnrefused|etimedout|fetch failed/i.test(e)?{type:`network`,actionable:!1}:/permission denied|eacces/i.test(e)?{type:`permission`,actionable:!0}:/type\s*error|cannot.*property|is not a function/i.test(e)?{type:`type-error`,actionable:!0}:/syntax\s*error|unexpected token|parsing error/i.test(e)?{type:`syntax`,actionable:!0}:/out of memory|heap|allocation/i.test(e)?{type:`memory`,actionable:!0}:/timeout|timed out/i.test(e)?{type:`timeout`,actionable:t.includes(`increase`)||t.includes(`config`)}:/import|require|module not found|cannot find module/i.test(e)?{type:`module-resolution`,actionable:!0}:{type:`unknown`,actionable:e.length>100}}const Ca={name:`tool-failure-patterns`,tools:[],extract(e){if(!e.isError)return[];let t=ei(e.result);if(!t||t.length<30)return[];let{type:n,actionable:r}=Sa(t);if(!r)return[];let i=t.slice(0,500),a=ti(i);return a<.2?[]:[{title:`${n} error in ${e.toolName}`,content:`Tool \`${e.toolName}\` failed with a ${n} error.\n\nArgs: ${JSON.stringify(e.args,null,2).slice(0,200)}\n\nError:\n${i}`,category:`context`,tags:[`errors`,n,e.toolName],hash:B(`smart-error-${n}-${e.toolName}-${t.slice(0,80)}`),quality:Math.min(.7,a+.1),source:e.toolName,ttlMs:72e5}]}};var wa=class{extractors=[];register(e){this.extractors.push(e)}getExtractors(e){return this.extractors.filter(t=>t.tools.length===0||t.tools.includes(e))}extractAll(e){return this.getExtractors(e.toolName).flatMap(t=>t.extract(e))}};function Ta(e){return{content:[{type:`text`,text:(e instanceof Error,String(e))}],isError:!0}}function Ea(e,t){try{e.push(t)}catch{}}function Da(e){return async(t,n)=>{let r=Date.now();try{let i=await n();return Ea(e,{toolName:t.toolName,args:t.args,result:i,durationMs:Date.now()-r,isError:i.isError===!0,timestamp:new Date().toISOString()}),i}catch(n){throw Ea(e,{toolName:t.toolName,args:t.args,result:Ta(n),durationMs:Date.now()-r,isError:!0,timestamp:new Date().toISOString()}),n}}}const Oa=L(`auto-knowledge`);var ka=class{registry;curated;flowContextAdapter;queue=[];timer=null;seenHashes=new Map;failedBuffer=[];maxBufferSize=50;storedCount=0;droppedCount=0;dedupedCount=0;bufferDropCount=0;recoveryListenerRegistered=!1;config;existingCuratedEntries=null;recoveryListener=null;constructor(e,t,n={},r){this.registry=e,this.curated=t,this.flowContextAdapter=r,this.config={...$r,...n}}push(e){if(!(!this.config.enabled||!this.curated&&!this.flowContextAdapter)&&!(this.storedCount>=this.config.maxFactsPerSession)){if(this.queue.push(e),this.queue.length>=this.config.batchSize){this.flush().catch(e=>{Oa.warn(`Auto-knowledge flush error`,{error:String(e)})});return}this.scheduleBatch()}}async flush(){this.timer&&=(clearTimeout(this.timer),null);let e=this.queue.splice(0);if(e.length===0||!this.curated&&!this.flowContextAdapter)return;this.existingCuratedEntries===null&&(this.existingCuratedEntries=await this.loadExistingCuratedEntries());let t=new Map;for(let n of e)for(let e of this.registry.extractAll(n)){if(e.quality<this.config.minQuality){this.droppedCount++;continue}if(this.isSeenRecently(e)){this.dedupedCount++;continue}let n=this.buildFactIdentity(e),r=t.get(n);if(r){t.set(n,this.choosePreferredFact(r,e)),this.dedupedCount++;continue}t.set(n,e)}for(let e of t.values()){if(this.storedCount>=this.config.maxFactsPerSession)break;if(Ee.instance().isDegraded(`embedder`)){Oa.debug?.(`Auto-knowledge embedder degraded — buffering fact`),this.bufferFact(e);continue}try{await this.storeFact(e)}catch(t){Oa.warn(`Auto-knowledge store failed — buffered for retry`,{title:e.title,error:String(t)}),this.bufferFact(e)}}}reset(){this.queue=[],this.seenHashes.clear(),this.failedBuffer.length=0,this.storedCount=0,this.droppedCount=0,this.dedupedCount=0,this.bufferDropCount=0,this.existingCuratedEntries=null,this.removeRecoveryListener(),this.timer&&=(clearTimeout(this.timer),null)}getStats(){return{queued:this.queue.length,stored:this.storedCount,seen:this.seenHashes.size,dropped:this.droppedCount,deduped:this.dedupedCount,bufferSize:this.failedBuffer.length,bufferDropped:this.bufferDropCount}}bufferFact(e){this.failedBuffer.length>=this.maxBufferSize&&(this.failedBuffer.shift(),this.bufferDropCount++),this.failedBuffer.push(e),this.ensureRecoveryListener()}ensureRecoveryListener(){if(this.recoveryListenerRegistered)return;let e=Ee.instance(),t=n=>{n.subsystem===`embedder`&&(e.removeListener(`healthy`,t),this.recoveryListener=null,this.recoveryListenerRegistered=!1,this.flushBuffer().catch(e=>{Oa.warn(`Buffer flush failed`,{error:String(e)})}))};this.recoveryListener=t,this.recoveryListenerRegistered=!0,e.on(`healthy`,t)}removeRecoveryListener(){if(!this.recoveryListener){this.recoveryListenerRegistered=!1;return}Ee.instance().removeListener(`healthy`,this.recoveryListener),this.recoveryListener=null,this.recoveryListenerRegistered=!1}async flushBuffer(){if(this.failedBuffer.length===0||!this.curated&&!this.flowContextAdapter)return;this.existingCuratedEntries===null&&(this.existingCuratedEntries=await this.loadExistingCuratedEntries()),Oa.info(`Flushing ${this.failedBuffer.length} buffered auto-knowledge facts`);let e=this.failedBuffer.splice(0);for(let t=0;t<e.length;t++){let n=e[t];if(n){if(this.storedCount>=this.config.maxFactsPerSession){this.failedBuffer.unshift(...e.slice(t));break}if(Ee.instance().isDegraded(`embedder`)){this.failedBuffer.unshift(...e.slice(t)),this.ensureRecoveryListener();break}try{let e=await this.storeFact(n);(e===`created`||e===`updated`)&&Oa.info(`Buffered fact stored on recovery`,{title:n.title,status:e})}catch(r){Oa.warn(`Auto-knowledge store failed — buffered for retry`,{title:n.title,error:String(r)}),this.failedBuffer.unshift(n,...e.slice(t+1)),this.ensureRecoveryListener();break}}}}isSeenRecently(e){let t=this.seenHashes.get(e.hash);return t==null?!1:e.ttlMs==null?!0:Date.now()-t<e.ttlMs}normalizeTitle(e){return e.toLowerCase().trim()}buildFactIdentity(e){let t=e.identityKey?`key:${e.identityKey}`:`hash:${e.hash||this.normalizeTitle(e.title)}`;return`${e.category}:${t}`}choosePreferredFact(e,t){return t.quality===e.quality?e:t.quality>e.quality?t:e}slugify(e){return e.toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-|-$/g,``).slice(0,80)||`untitled`}resolveCuratedRelativePath(e){let t=`${e.category}/auto-${this.slugify(e.identityKey??e.title)}.md`,n=this.existingCuratedEntries??[],r=n.find(e=>e.path===t);if(r)return r.path;let i=this.normalizeTitle(e.title),a=n.filter(t=>t.category===e.category&&this.normalizeTitle(t.title)===i);return a.length===0?t:(a.sort((t,n)=>{let r=this.tagOverlapScore(n.tags,e.tags),i=this.tagOverlapScore(t.tags,e.tags);return r===i?t.path.localeCompare(n.path):r-i}),a[0]?.path??t)}resolveFlowContextRelativePath(e){return`${e.tags.find(e=>!e.startsWith(`flow:`)&&!e.startsWith(`tool:`)&&e!==`flow-context`)||`analysis`}/${this.slugify(e.identityKey??e.title)}.md`}tagOverlapScore(e,t){let n=new Set(e),r=0;for(let e of t)n.has(e)&&(r+=1);return r}markFactSeen(e){this.seenHashes.set(e.hash,Date.now())}rememberExistingCuratedFact(e,t){let n=this.existingCuratedEntries;if(!n)return;let r=n.find(t=>t.path===e);if(r){r.title=t.title,r.category=t.category,r.tags=[...t.tags];return}n.push({path:e,title:t.title,category:t.category,tags:[...t.tags]})}async storeFact(e){if(e.tags.includes(`flow-context`)&&this.flowContextAdapter){let t=this.resolveFlowContextRelativePath(e),n=`# ${e.title}\n\n${e.content}`,r=await this.flowContextAdapter.read(t);if(r===n)return this.markFactSeen(e),this.dedupedCount++,`unchanged`;await this.flowContextAdapter.write(t,n);let i=r==null?`created`:`updated`;return this.markFactSeen(e),this.storedCount++,Oa.info(i===`created`?`Auto-knowledge stored`:`Auto-knowledge refreshed`,{title:e.title,category:e.category,quality:e.quality,source:e.source,status:i}),i}else if(this.curated){let t=this.resolveCuratedRelativePath(e),n=`Auto-knowledge refresh from ${e.source}`,r=this.curated;if(typeof r.upsertAutoKnowledge==`function`){let i=await r.upsertAutoKnowledge(t,e.title,e.content,e.category,e.tags,n);return this.markFactSeen(e),this.rememberExistingCuratedFact(i.path,e),i.status===`unchanged`?(this.dedupedCount++,`unchanged`):(this.storedCount++,Oa.info(i.status===`created`?`Auto-knowledge stored`:`Auto-knowledge refreshed`,{title:e.title,category:e.category,quality:e.quality,source:e.source,status:i.status}),i.status)}await this.curated.remember(e.title,e.content,e.category,e.tags)}else return`skipped`;return this.markFactSeen(e),this.storedCount++,this.curated&&this.rememberExistingCuratedFact(this.resolveCuratedRelativePath(e),e),Oa.info(`Auto-knowledge stored`,{title:e.title,category:e.category,quality:e.quality,source:e.source}),`created`}async loadExistingCuratedEntries(){let e=this.curated;if(!e)return[];try{return(await e.list()).map(e=>({path:e.path,title:e.title,category:e.category,tags:[...e.tags]}))}catch{Oa.warn(`Failed to load existing curated entries for dedup`,{})}return[]}scheduleBatch(){this.timer||=setTimeout(()=>{this.timer=null,this.flush().catch(e=>{Oa.warn(`Auto-knowledge flush error`,{error:String(e)})})},this.config.debounceMs)}};const Aa=/```/,ja=/^\s*(?:import|export|function|class|interface|type|const|let|var|return|if|for|while|switch|try|catch|throw|await|async)\b/,Ma=/=>|;\s*$|{\s*$|}\s*$|:\s*(?:string|number|boolean|unknown|void|any|Record|Array|Set|Map|Promise|ReadonlyArray)\b/;function Na(e){let t=e.trimStart();if(t.length===0)return!1;let n=t.charAt(0);return n!==`{`&&n!==`[`?!1:n===`{`?!(!t.includes(`"`)||!t.includes(`:`)):t.length>2}function Pa(e){if(Na(e)||e.includes("```")||Aa.test(e))return!0;let t=e.split(/\r?\n/u).filter(e=>e.trim().length>0);if(t.length<3)return!1;let n=0;for(let e of t)(ja.test(e)||Ma.test(e))&&(n+=1);return n/t.length>=.25}function Fa(e){let t=e.meta?.compression?.preserve??`balanced`;if(t===`exact`||Pa(e.text))return{profile:`exact`,shouldCompress:!1,mode:`structural`,threshold:e.threshold,tokenBudget:e.tokenBudget,reason:t===`exact`?`tool-specific preservation profile`:`code-like output preserved verbatim`};if(t===`dense`){let t=Math.max(1,Math.floor(e.threshold*.65)),n=Math.max(1,Math.floor(e.tokenBudget*.6));return{profile:`dense`,shouldCompress:e.text.length>=t,mode:`aggressive`,threshold:t,tokenBudget:n,reason:`dense tool profile`}}return{profile:`balanced`,shouldCompress:e.text.length>=e.threshold,mode:`structural`,threshold:e.threshold,tokenBudget:e.tokenBudget,reason:`balanced tool profile`}}const W={search:{title:`Hybrid Search`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`dense`}},find:{title:`Federated Find`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`dense`}},symbol:{title:`Symbol Resolver — Cross-Module Definitions & References`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`exact`}},trace:{title:`Data Flow Tracer — Cross-Module Call & Import Chains`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`exact`}},scope_map:{title:`Task Scope Map`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`exact`},capabilities:{indexIndependent:!0}},lookup:{title:`Chunk Lookup`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`exact`}},dead_symbols:{title:`Dead Symbol Finder`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`exact`}},file_summary:{title:`File Summary`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`exact`,selfManaged:!0},capabilities:{indexIndependent:!0}},analyze:{title:`Analyze`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`analysis`],compression:{preserve:`exact`}},blast_radius:{title:`Blast Radius`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`analysis`,`search`],compression:{preserve:`exact`}},knowledge:{title:`Knowledge`,annotations:{readOnlyHint:!1},category:[`knowledge`],compression:{preserve:`balanced`},capabilities:{indexIndependent:!0}},memory_explain:{title:`Memory Explain`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`knowledge`,`search`],compression:{preserve:`exact`}},produce_knowledge:{title:`Produce Knowledge`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`knowledge`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},compact:{title:`Semantic Compactor`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`compression`],compression:{preserve:`balanced`},capabilities:{indexIndependent:!0}},digest:{title:`Multi-Source Digest`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`compression`],compression:{preserve:`balanced`},capabilities:{indexIndependent:!0}},stratum_card:{title:`Stratum Card`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`compression`],compression:{preserve:`balanced`},capabilities:{indexIndependent:!0}},forge_ground:{title:`FORGE Ground`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`forge`],compression:{preserve:`exact`}},forge_classify:{title:`FORGE Classify`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`forge`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},evidence_map:{title:`Evidence Map`,annotations:{readOnlyHint:!1},category:[`forge`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},present:{title:`Rich Content Presenter`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`presentation`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},check:{title:`Typecheck & Lint`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`execution`],compression:{preserve:`dense`,selfManaged:!0},capabilities:{zeroDep:!0,indexIndependent:!0}},test_run:{title:`Run Tests`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`execution`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},eval:{title:`Evaluate Code`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`execution`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},audit:{title:`Project Audit`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`execution`],compression:{preserve:`dense`,selfManaged:!0}},browser:{title:`Browser Automation`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`web`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},rename:{title:`Rename Symbol`,annotations:{readOnlyHint:!1,destructiveHint:!0},category:[`manipulation`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},restore:{title:`Restore`,annotations:{readOnlyHint:!1},category:[`manipulation`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},codemod:{title:`Codemod`,annotations:{readOnlyHint:!1,destructiveHint:!0},category:[`manipulation`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},data_transform:{title:`Data Transform`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`manipulation`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},stash:{title:`Stash Values`,annotations:{readOnlyHint:!1},category:[`session`],compression:{preserve:`dense`},capabilities:{indexIndependent:!0}},signal:{title:`Inter-Agent Signaling`,annotations:{readOnlyHint:!1},category:[`session`],compression:{preserve:`dense`},capabilities:{indexIndependent:!0}},checkpoint:{title:`Session Checkpoint`,annotations:{readOnlyHint:!1},category:[`session`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},session_digest:{title:`Session Digest`,annotations:{readOnlyHint:!0,idempotentHint:!1},category:[`session`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},compliance_score:{title:`Compliance Score`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`session`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},workset:{title:`Workset Manager`,annotations:{readOnlyHint:!1},category:[`session`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},lane:{title:`Exploration Lane`,annotations:{readOnlyHint:!1},category:[`session`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},git_context:{title:`Git Context`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`git`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},diff_parse:{title:`Diff Parser`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`git`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},parse_output:{title:`Parse Build Output`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`git`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},process:{title:`Process Manager`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`process`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},watch:{title:`File Watcher`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`process`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},delegate:{title:`Delegate Task`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`process`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},config:{title:`Configuration Manager`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`exact`},capabilities:{indexIndependent:!0}},status:{title:`AI Kit Status`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},health:{title:`Health Check`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},reindex:{title:`Reindex`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`dense`},capabilities:{indexIndependent:!0}},onboard:{title:`Onboard Codebase`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`dense`},capabilities:{indexIndependent:!0}},graph:{title:`Code Knowledge Graph — Module & Symbol Relationships`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`balanced`},capabilities:{indexIndependent:!0}},guide:{title:`Tool Guide`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},replay:{title:`Replay History`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},list_tools:{title:`List Available Tools`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`meta`],compression:{preserve:`exact`},capabilities:{zeroDep:!0}},describe_tool:{title:`Describe Tool`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`meta`],compression:{preserve:`exact`},capabilities:{zeroDep:!0}},search_tools:{title:`Search Tools`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`meta`],compression:{preserve:`exact`},capabilities:{zeroDep:!0}},changelog:{title:`Generate Changelog`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},regex_test:{title:`Regex Tester`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},encode:{title:`Encode / Decode`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},measure:{title:`Code Metrics`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},schema_validate:{title:`Schema Validator`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},env:{title:`Environment Info`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},time:{title:`Date & Time`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},web_fetch:{title:`Web Fetch`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`web`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},web_search:{title:`Web Search`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`web`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},http:{title:`HTTP Request`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`web`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},queue:{title:`Operation Queue`,annotations:{readOnlyHint:!1},category:[`queue`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},bridge_push:{title:`Bridge Push`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},bridge_pull:{title:`Bridge Pull`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},bridge_sync:{title:`Bridge Sync Status`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},er_push:{title:`Enterprise Push`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},er_pull:{title:`Enterprise Pull`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},er_sync_status:{title:`Enterprise Sync Status`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},er_update_policy:{title:`Enterprise Update Policy`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},er_evolve_review:{title:`Enterprise Evolution Review`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},evolution_state:{title:`Evolution State`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},policy_check:{title:`Policy Check`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},flow:{title:`Flow`,annotations:{readOnlyHint:!1},category:[`flow`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0}}},Ia=Object.keys(W).filter(e=>!W[e]?.capabilities?.conditional),La=new Set(Object.entries(W).filter(([e,t])=>t.capabilities?.zeroDep).map(([e])=>e)),Ra=new Set(Object.entries(W).filter(([e,t])=>t.capabilities?.indexIndependent).map(([e])=>e));function G(e){return W[e]??{title:e,annotations:{readOnlyHint:!1},category:[]}}function za(e){switch(e){case`efficient`:return{threshold:2e3,tokenBudget:1e3};case`full`:return{threshold:1/0};default:return{threshold:4e3,tokenBudget:2e3}}}function Ba(e){let t=e?.threshold??4e3,n=e?.tokenBudget??2e3;return async(e,r)=>{if(G(e.toolName).compression?.selfManaged)return r();let i=await r();if(!Array.isArray(i.content))return i;let a={profile:`balanced`,applied:!1,reason:`below threshold`,mode:`structural`,threshold:t,tokenBudget:n,originalChars:0,compressedChars:0,savedChars:0,compressedItems:0,preservedItems:0},o=i.content.map(r=>{if(r.type!==`text`||typeof r.text!=`string`)return r;a.originalChars+=r.text.length;let i=Fa({meta:e.meta,text:r.text,threshold:t,tokenBudget:n});if(a.profile=i.profile,a.mode=i.mode,a.threshold=i.threshold,a.tokenBudget=i.tokenBudget,a.reason=i.reason,!i.shouldCompress||r.text.length<i.threshold)return a.preservedItems+=1,a.compressedChars+=r.text.length,r;let o=Qe({text:r.text,tool:e.toolName,tokenBudget:i.tokenBudget,mode:i.mode});return a.applied=!0,a.compressedItems+=1,a.compressedChars+=o.text.length,o.text===r.text?r:{...r,text:o.text}});return a.originalChars===0?i:(a.savedChars=a.originalChars-a.compressedChars,{...i,content:o,_meta:{...i._meta??{},compression:a}})}}var Va=class{baseDir;getActiveSlug;constructor(e,t){this.baseDir=e,this.getActiveSlug=t}async initialize(){await Mn(this.baseDir,{recursive:!0})}async read(e){let t=this.resolveScopedPath(e);if(t==null)return null;try{return await Nn(t,`utf-8`)}catch(e){if(this.isMissingError(e))return null;throw e}}async write(e,t,n){let r=this.resolveScopedPath(e);r!=null&&(await Mn(ge(r),{recursive:!0}),await Rn(r,t,{encoding:`utf-8`,flag:n?.exclusive?`wx`:`w`}))}async delete(e){let t=this.resolveScopedPath(e);if(t==null)return!1;try{return await Ln(t),!0}catch(e){if(this.isMissingError(e))return!1;throw e}}async list(e){let t=this.getActiveSlugDir();if(t==null)return[];let n=e?this.resolveScopedPath(e):t;return n==null?[]:this.collectFiles(n,e??``)}async exists(e){let t=this.resolveScopedPath(e);if(t==null)return!1;try{return await In(t),!0}catch(e){if(this.isMissingError(e))return!1;throw e}}async listDirectories(){let e=this.getActiveSlugDir();if(e==null)return[];try{return(await Pn(e,{withFileTypes:!0})).filter(e=>e.isDirectory()&&/^[a-z][a-z0-9-]*$/.test(e.name)).map(e=>e.name).sort()}catch(e){if(this.isMissingError(e))return[];throw e}}async flushAll(){let e=this.getActiveSlugDir();if(e==null)return 0;let t=await this.countFiles(e);return t===0?0:(await Fn(e,{recursive:!0,force:!0}),t)}async close(){}getActiveSlugDir(){let e=this.getActiveSlug();return e?F(this.baseDir,e):null}resolveScopedPath(e){let t=this.getActiveSlugDir();if(t==null)return null;let n=I(t),r=I(n,e),i=ve(n,r);if(i===``||i===`..`||i.startsWith(`..${ye}`)||_e(i))throw Error(`Path escapes active flow context scope: ${e}`);return r}async collectFiles(e,t){let n;try{n=await Pn(e,{withFileTypes:!0})}catch(e){if(this.isMissingError(e))return[];throw e}let r=[];for(let i of n){let n=t?`${t}/${i.name}`:i.name,a=F(e,i.name);if(i.isDirectory()){r.push(...await this.collectFiles(a,n));continue}if(!(!i.isFile()||!i.name.endsWith(`.md`)))try{let e=await In(a);r.push({path:n,size:e.size,mtimeMs:e.mtimeMs})}catch(e){if(!this.isMissingError(e))throw e}}return r.sort((e,t)=>e.path.localeCompare(t.path))}async countFiles(e){let t;try{t=await Pn(e,{withFileTypes:!0})}catch(e){if(this.isMissingError(e))return 0;throw e}let n=0;for(let r of t){let t=F(e,r.name);if(r.isDirectory()){n+=await this.countFiles(t);continue}r.isFile()&&(n+=1)}return n}isMissingError(e){return typeof e==`object`&&!!e&&`code`in e&&(e.code===`ENOENT`||e.code===`ENOTDIR`)}};const Ha=L(`observation-capture`),Ua=[`check`,`test_run`,`search`,`trace`],Wa=[/\bAuthorization\s*:\s*Bearer\s+[A-Za-z0-9\-._~+/]+=*/gi,/\bBearer\s+[A-Za-z0-9\-._~+/]+=*/g,/\b(?:sk|ghp|gho|glpat|xoxb|xoxp)-[A-Za-z0-9\-._]{20,}\b/g,/\b(?:token|key|secret|password|auth(?:orization)?)\s*[=:]\s*['"]?[^\s'"&]{8,}/gi,/\b(?:token|key|secret|password|auth(?:orization)?)=[^\s&]+/gi,/\b[A-Z][A-Z0-9_]*(?:PASSWORD|SECRET|TOKEN|AUTH)[A-Z0-9_]*\b\s*[=:]\s*['"]?[^\s'"]+/g,/\b[A-Z][A-Z0-9_]*KEY[A-Z0-9_]*\b\s*[=:]\s*['"]?[^\s'"]{8,}/g,/-----BEGIN [\w\s]+-----[\s\S]*?-----END [\w\s]+-----/g],Ga=new Set([`env`,`auth`,`config`]),Ka=2e3,qa={enabled:!0,rateLimit:10,captureFrom:[...Ua],minContentLength:50};var Ja=class{maxPerMinute;timestamps=[];constructor(e){this.maxPerMinute=e}canCapture(e=Date.now()){return this.prune(e),this.timestamps.length<this.maxPerMinute}record(e=Date.now()){this.prune(e),this.timestamps.push(e)}setLimit(e){this.maxPerMinute=e,this.prune(Date.now())}prune(e){let t=e-6e4;this.timestamps=this.timestamps.filter(e=>e>t)}};function Ya(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Xa(e){return typeof e==`string`?e:Ya(e)?[Array.isArray(e.content)?e.content.filter(e=>Ya(e)).map(e=>typeof e.text==`string`?e.text:``).filter(e=>e.length>0).join(`
|
|
14
|
+
`)}}]}))}const Qr={enabled:!0,batchSize:10,debounceMs:5e3,maxFactsPerSession:50,minQuality:.3};function $r(e){return(e.content??[]).filter(e=>e.type===`text`&&typeof e.text==`string`).map(e=>e.text??``).join(`
|
|
15
|
+
`)}function V(e){return A(`sha256`).update(e).digest(`hex`).slice(0,16)}function ei(e){let t=0;return e.length>=50&&(t+=.2),e.length>=150&&(t+=.1),/[a-zA-Z]\w+\.\w+/.test(e)&&(t+=.15),/[:=]|^[-*]|\n[-*]|```/.test(e)&&(t+=.15),/\b(use|should|must|always|never|prefer|avoid|requires?|detected|confirmed|verified)\b/i.test(e)&&(t+=.2),/^(Error|TypeError|ReferenceError):/m.test(e)&&e.length<100&&(t-=.2),Math.max(0,Math.min(1,t))}const ti={enabled:!0,batchThreshold:20,cooldownMs:3e5,maxCandidatesPerSession:5,initialConfidence:40,excludeTools:[`knowledge`,`replay`,`stash`,`checkpoint`,`session_digest`,`reindex`,`status`,`flow`,`evidence_map`,`present`]},ni=new Set([`search`,`find`,`symbol`,`grep_search`,`semantic_search`]),ri=new Set([`replace_string_in_file`,`editfiles`,`create_file`,`apply_patch`]),ii=new Set([`check`,`test_run`]),ai=new Set(`action.and.args.auto.buffer.category.content.create.cwd.false.file.files.find.grep.json.knowledge.list.path.query.read.replace.search.semantic.subaction.symbol.test.tool.true.update`.split(`.`));function oi(e){let t=e.toLowerCase().match(/[a-z0-9]{2,}/g)??[];return new Set(t)}function si(e,t){let n=oi(e),r=oi(t);if(n.size===0&&r.size===0)return 1;if(n.size===0||r.size===0)return 0;let i=new Set([...n].filter(e=>r.has(e))),a=new Set([...n,...r]);return i.size/a.size}function ci(e,t){return e.length<=t?e:`${e.slice(0,Math.max(0,t-1))}...`}function li(e){try{return JSON.stringify(e)}catch{return`[unserializable args]`}}function ui(e){return e.replace(/^mcp_[^_]+_/,``).toLowerCase()}function di(e){return[...new Set(e.filter(e=>e.length>0))]}function fi(e,t){return{...t,confidence:ti.initialConfidence,tags:[`auto-observed`,`detector:${e}`],detector:e}}function pi(e,t){let n=new Map;for(let t of e)for(let e of oi(t))ai.has(e)||n.set(e,(n.get(e)??0)+1);let r=[...n.entries()].filter(([,e])=>e>=t).sort((e,t)=>t[1]-e[1]||e[0].localeCompare(t[0])).map(([e])=>e);return r.length>0?r.slice(0,4):[...n.entries()].sort((e,t)=>t[1]-e[1]||e[0].localeCompare(t[0])).slice(0,4).map(([e])=>e)}function mi(e){return e.length>0?e.join(`, `):`similar tasks`}function hi(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.ts==`number`&&Number.isFinite(t.ts)&&typeof t.tool==`string`&&typeof t.input==`string`&&(t.output===void 0||typeof t.output==`string`)&&Array.isArray(t.files)&&t.files.every(e=>typeof e==`string`)}function gi(e){let t=[];for(let n of e)t.some(e=>si(e.title,n.title)>.8)||t.push(n);return t}function _i(e){return typeof e==`string`?[e]:Array.isArray(e)?e.filter(e=>typeof e==`string`):[]}function vi(e){return typeof e==`string`?[...e.matchAll(/^\*\*\* (?:Add|Delete|Update) File: (.+)$/gm)].map(e=>e[1]?.trim()??``).filter(Boolean):[]}function yi(e){let t=[],n=e=>{if(!(typeof e!=`object`||!e)){if(Array.isArray(e)){for(let t of e)n(t);return}for(let[r,i]of Object.entries(e))(r===`path`||r===`filePath`||r===`files`)&&t.push(..._i(i)),n(i)}};return n(e),t.push(...vi(e.input)),di(t)}function bi(e){return{tool:e.toolName,input:ci(li(e.args),200),output:ci($r(e.result),500),files:yi(e.args),ts:Date.now()}}function xi(e){return{title:e.title,content:`${e.context}\n\n${e.insight}\n\nEvidence:\n${e.evidence}`,category:`conventions`,tags:di([`auto-observed`,`detector:${e.detector}`,...e.tags]),hash:A(`sha256`).update(`${e.detector}:${e.title}`).digest(`hex`).slice(0,16),quality:Math.max(0,Math.min(1,e.confidence/100)),source:`behavioral:${e.detector}`}}function Si(e){let t=new Map;for(let n of e){let e=ui(n.tool),r=t.get(e)??[];r.push(n),t.set(e,r)}return[...t.entries()].filter(([,e])=>e.length>=5).map(([e,t])=>{let n=mi(pi(t.map(e=>e.input),Math.max(2,Math.ceil(t.length/2))));return fi(`tool-preference`,{title:`Preferred tool: ${e} for ${n}`,context:`Observed ${t.length} ${e} calls with recurring inputs around ${n}.`,insight:`Use ${e} when working with ${n}.`,evidence:t.slice(0,5).map(e=>`${e.tool}: ${e.input}`).join(`
|
|
16
|
+
`)})})}function Ci(e){let t=new Map;for(let n=0;n<e.length;n+=1){let r=e[n];if(ni.has(ui(r.tool)))for(let i=n+1;i<e.length&&i<=n+5;i+=1){let n=e[i];if(!(!ri.has(ui(n.tool))||n.files.length===0))for(let e of di(n.files)){let i=t.get(e)??{count:0,queries:[],evidence:[]};i.count+=1,i.queries.push(r.input),i.evidence.push(`${r.tool}: ${r.input} -> ${n.tool}: ${e}`),t.set(e,i)}}}return[...t.entries()].filter(([,e])=>e.count>=3).map(([e,t])=>{let n=mi(pi(t.queries,Math.max(2,Math.ceil(t.count/2))));return fi(`search-action`,{title:`Check ${e} when searching for ${n}`,context:`Searches related to ${n} were followed by edits to ${e} ${t.count} times within five tool calls.`,insight:`When working on ${n}, check ${e} early because searches repeatedly led there.`,evidence:t.evidence.slice(0,5).join(`
|
|
17
|
+
`)})})}function wi(e){let t=new Map;for(let n=0;n<e.length-2;n+=1){let r=e[n];if(!ii.has(ui(r.tool)))continue;let i=new Set,a=!1;for(let o=n+1;o<e.length;o+=1){let n=e[o],s=ui(n.tool);if(ri.has(s)){a=!0;for(let e of n.files)i.add(e);continue}if(ii.has(s)){if(!a||i.size===0)break;let e=[...i].sort(),o=e.join(`|`),s=t.get(o)??{count:0,evidence:[]};s.count+=1,s.evidence.push(`${r.tool} -> edit(${e.join(`, `)}) -> ${n.tool}`),t.set(o,s);break}if(!a)break}}return[...t.entries()].filter(([,e])=>e.count>=2).map(([e,t])=>{let n=e.split(`|`);return fi(`error-fix-cycle`,{title:`Repeated validation-edit loop in ${n.length===1?n[0]:`${n[0]} and related files`}`,context:`Observed ${t.count} validation cycles touching ${n.join(`, `)}.`,insight:`Common fix pattern in ${n.join(`, `)}: check -> edit -> recheck.`,evidence:t.evidence.slice(0,5).join(`
|
|
18
|
+
`)})})}function Ti(e,t=ti){if(!t.enabled||e.length===0)return[];let n=new Set(t.excludeTools.map(e=>e.toLowerCase())),r=e.filter(e=>!n.has(ui(e.tool)));return gi([...Si(r),...Ci(r),...wi(r)].map(e=>({...e,confidence:t.initialConfidence,tags:di([`auto-observed`,`detector:${e.detector}`,...e.tags])}))).slice(0,t.maxCandidatesPerSession)}function Ei(e){return e.split(`
|
|
19
|
+
`).filter(Boolean).map(e=>{try{return JSON.parse(e)}catch{return null}}).filter(hi).map(e=>({...e,output:e.output??``}))}var Di=class{name=`behavioral`;tools=[];buffer=[];eventCounter=0;lastDetectionTs=0;extract(e){if(this.push(bi(e)),this.eventCounter+=1,this.eventCounter%50!=0)return[];let t=Date.now();if(t-this.lastDetectionTs<3e5)return[];let n=Ti(this.buffer).map(xi);return this.eventCounter=0,this.lastDetectionTs=t,n}push(e){this.buffer.push(e),this.buffer.length>100&&this.buffer.splice(0,this.buffer.length-100)}};function Oi(){return new Di}Oi();const ki={name:`build-commands`,tools:[`check`,`test_run`],extract(e){if(e.isError)return[];let t=$r(e.result);if(!t)return[];let n=[];if(e.toolName===`check`){let r=[];if(/typecheck.*(?:pass|success|0 error)/i.test(t)&&r.push(`typecheck`),/lint.*(?:pass|success|no (?:warning|error))/i.test(t)&&r.push(`lint`),/biome.*(?:checked|no fixes)/i.test(t)&&r.push(`biome`),r.length>0){let t=[...r].sort();n.push({title:`Verified checks: ${t.join(`, `)}`,content:`The following checks passed successfully: ${t.join(`, `)}.\nRun with the \`check\` tool to verify code quality.`,category:`conventions`,tags:[`build`,`verified`,...t],hash:V(`build-checks-${t.join(`,`)}`),quality:.8,source:e.toolName})}}if(e.toolName===`test_run`){let r=t.match(/(\d+)\s*(?:tests?\s+)?pass/i),i=t.match(/(\d+)\s*(?:total|tests)/i),a=t.match(/(\d+)\s*(?:test\s+)?files?/i);if(r){let t=r[1],o=i?.[1]??t,s=a?.[1]??`unknown`;n.push({title:`Test suite summary`,content:`Test results: ${t}/${o} tests passed across ${s} test files.\nUse \`test_run\` tool to execute the test suite.`,category:`context`,tags:[`testing`,`verified`,`test-summary`],hash:V(`test-summary-${t}-${o}`),quality:.7,source:e.toolName,ttlMs:72e5})}let o=t.match(/(?:running|command|exec):\s*(.+?)$/im);if(o?.[1]){let t=o[1].trim();n.push({title:`Test command: ${t.slice(0,60)}`,content:`Verified test command: \`${t}\`\nThis command successfully ran the project's test suite.`,category:`conventions`,tags:[`testing`,`build-command`,`verified`],hash:V(`test-cmd-${t}`),quality:.9,source:e.toolName})}}return n}},Ai={name:`codebase-insights`,tools:[`analyze`,`scope_map`,`blast_radius`,`onboard`],extract(e){let t=$r(e.result);if(!t||t.length<50||e.isError)return[];let n=[];if(e.toolName===`analyze`&&e.args.aspect===`structure`){let r=typeof e.args.path==`string`?e.args.path:`.`,i=t.slice(0,600);n.push({title:`Structure: ${r}`,content:`Project structure analysis for ${r}:\n${i}`,category:`context`,tags:[`architecture`,`structure`,`analysis`],hash:V(`structure-${r}`),identityKey:`analyze:structure:${r}`,quality:Math.min(.9,ei(i)+.2),source:e.toolName})}if(e.toolName===`analyze`&&e.args.aspect===`dependencies`){let r=typeof e.args.path==`string`?e.args.path:`.`,i=t.split(/\r?\n/).filter(e=>/(?:depends on|imports?|requires?|from)\s/i.test(e)).slice(0,10);if(i.length>0){let t=`Dependency analysis for ${r}:\n${i.join(`
|
|
20
|
+
`)}`;n.push({title:`Dependencies: ${r}`,content:t,category:`context`,tags:[`architecture`,`dependencies`,`analysis`],hash:V(`deps-${r}`),identityKey:`analyze:dependencies:${r}`,quality:.7,source:e.toolName})}}if(e.toolName===`blast_radius`){let r=e.args.changed_files,i=Array.isArray(r)?r.map(String).join(`, `):String(r??``);if(i&&t.length>50){let r=t.slice(0,400);n.push({title:`Blast radius: ${i.slice(0,60)}`,content:`Impact analysis for changes to ${i}:\n${r}`,category:`context`,tags:[`architecture`,`blast-radius`,`impact`],hash:V(`blast-${i}`),identityKey:`blast-radius:${i}`,quality:.6,source:e.toolName,ttlMs:36e5})}}if(e.toolName===`analyze`&&e.args.aspect===`entry_points`){let r=t.split(/\r?\n/).filter(e=>/(?:entry|export|main|bin)\b/i.test(e)).slice(0,10);r.length>0&&n.push({title:`Project entry points`,content:`Detected entry points:\n${r.join(`
|
|
21
|
+
`)}`,category:`context`,tags:[`architecture`,`entry-points`],hash:V(`entry-points`),identityKey:`analyze:entry-points`,quality:.7,source:e.toolName})}if(e.toolName===`scope_map`){let r=typeof e.args.task==`string`?e.args.task:``;r&&t.length>100&&n.push({title:`Scope map: ${r.slice(0,60)}`,content:`Scope analysis for "${r}":\n${t.slice(0,500)}`,category:`context`,tags:[`planning`,`scope-map`],hash:V(`scope-${r}`),identityKey:`scope-map:${r}`,quality:.6,source:e.toolName,ttlMs:72e5})}return e.toolName===`onboard`&&t.length>200&&n.push({title:`Onboard analysis summary`,content:`Codebase onboarding analysis:\n${t.slice(0,800)}`,category:`context`,tags:[`onboarding`,`analysis`,`structure`],hash:V(`onboard-summary`),identityKey:`onboard:summary`,quality:.9,source:e.toolName}),n}};function ji(e,t,n,r,i,a,o,s){return{title:e,content:t,category:`context`,tags:s,hash:V(n),identityKey:r,quality:i,ttlMs:a,source:o}}const Mi={name:`context-reads`,tools:[`compact`,`file_summary`,`digest`,`lookup`,`stratum_card`],extract(e){if(e.isError)return[];let t=$r(e.result);if(!t)return[];if(e.toolName===`compact`){let n=typeof e.args.path==`string`?e.args.path:void 0,r=typeof e.args.query==`string`?e.args.query:void 0;return!n||!r||t.length<100?[]:[ji(`Context: ${n} (${r.slice(0,40)})`,t.slice(0,800),`compact-${n}-${r}`,`compact:${n}:${r}`,.7,72e5,e.toolName,[`context`,`compact`,`file-read`])]}if(e.toolName===`file_summary`){let n=typeof e.args.path==`string`?e.args.path:void 0;return!n||t.length<50?[]:[ji(`Structure: ${n}`,t,`file-summary-${n}`,`file-summary:${n}`,.65,144e5,e.toolName,[`context`,`file-summary`,`structure`])]}if(e.toolName===`digest`){let n=typeof e.args.query==`string`?e.args.query:void 0;if(!n||t.length<150)return[];let r=Array.isArray(e.args.sources)?e.args.sources.map(e=>{if(!e||typeof e!=`object`)return``;let t=e.id;return typeof t==`string`?t:``}).join(`,`):``;return[ji(`Digest: ${n.slice(0,60)}`,t.slice(0,1e3),`digest-${n}-${r}`,`digest:${n}:${r}`,.75,72e5,e.toolName,[`context`,`digest`,`compression`])]}if(e.toolName===`lookup`){let n=typeof e.args.path==`string`?e.args.path:void 0;return!n||t.length<100?[]:[ji(`Indexed: ${n}`,t.slice(0,600),`lookup-${n}`,`lookup:${n}`,.5,72e5,e.toolName,[`context`,`lookup`,`file-content`])]}if(e.toolName===`stratum_card`){let n=Array.isArray(e.args.files)?e.args.files.filter(e=>typeof e==`string`):[],r=typeof e.args.query==`string`?e.args.query:``,i=typeof e.args.tier==`string`?e.args.tier:void 0;if(n.length===0||!i||t.length<50)return[];let a=n.join(`,`),o=i===`T2`?`stratum-${a}-${i}-${r}`:`stratum-${a}-${i}`;return[ji(`Card [${i}]: ${n[0]} (+${n.length-1})`,t.slice(0,600),o,`stratum:${i}:${a}:${r}`,i===`T2`?.7:.55,72e5,e.toolName,[`context`,`stratum-card`,i])]}return[]}};function Ni(e,t){let n=[],r=e.toLowerCase();r.includes(`biome`)?n.push({title:`Linter: Biome`,content:`This project uses Biome for linting and formatting.`,category:`conventions`,tags:[`tooling`,`linter`,`biome`],hash:V(`convention-linter-biome`),quality:.8,source:t}):r.includes(`eslint`)&&n.push({title:`Linter: ESLint`,content:`This project uses ESLint for linting.`,category:`conventions`,tags:[`tooling`,`linter`,`eslint`],hash:V(`convention-linter-eslint`),quality:.8,source:t}),r.includes(`prettier`)&&n.push({title:`Formatter: Prettier`,content:`This project uses Prettier for code formatting.`,category:`conventions`,tags:[`tooling`,`formatter`,`prettier`],hash:V(`convention-formatter-prettier`),quality:.8,source:t}),(/strict\s*(?:mode)?.*(?:enabled|true)/i.test(e)||/"strict"\s*:\s*true/.test(e))&&n.push({title:`TypeScript strict mode enabled`,content:`This project has TypeScript strict mode enabled. Ensure all types are explicit.`,category:`conventions`,tags:[`typescript`,`strict`,`config`],hash:V(`convention-ts-strict`),quality:.8,source:t});for(let e of[`pnpm`,`yarn`,`npm`,`bun`])if(r.includes(e)&&(r.includes(`lockfile`)||r.includes(`workspace`)||r.includes(`${e} run`))){n.push({title:`Package manager: ${e}`,content:`This project uses ${e} as its package manager.`,category:`conventions`,tags:[`tooling`,`package-manager`,e],hash:V(`convention-pm-${e}`),quality:.7,source:t});break}return(r.includes(`monorepo`)||r.includes(`workspaces`)||/packages\/\w+/.test(e))&&n.push({title:`Monorepo structure detected`,content:`This project uses a monorepo structure with multiple packages.`,category:`conventions`,tags:[`architecture`,`monorepo`],hash:V(`convention-monorepo`),quality:.7,source:t}),n}function Pi(e,t){let n=[],r=e.matchAll(/(?:pattern|convention):\s*(.+?)(?:\n|$)/gi);for(let e of r){let r=e[1]?.trim();r&&r.length>20&&r.length<200&&n.push({title:`Pattern: ${r.slice(0,80)}`,content:r,category:`patterns`,tags:[`detected-pattern`],hash:V(`pattern-${r}`),quality:.6,source:t})}return n}const Fi={name:`convention-detection`,tools:[`check`,`analyze`,`onboard`],extract(e){let t=$r(e.result);if(!t||e.isError)return[];let n=[];return n.push(...Ni(t,e.toolName)),e.toolName===`analyze`&&e.args.aspect===`patterns`&&n.push(...Pi(t,e.toolName)),n}};function Ii(e,t){return e.match(t)?.[1]?.trim()||null}function Li(e,t,n,r,i,a){return{title:e,content:t,category:`context`,tags:n,hash:V(r),quality:i,source:a}}const Ri={name:`environment-facts`,tools:[`env`,`config`,`status`],extract(e){let t=$r(e.result);if(!t)return[];let n=[],r=Ii(t,/node(?:\.js)?\s*[:=]\s*([^\r\n]+)/i);r&&n.push(Li(`Node.js version`,`Detected Node.js version: ${r}`,[`environment`,`node`],`node-version-${r}`,.4,e.toolName));let i=Ii(t,/(?:^|\n)os\s*[:=]\s*([^\r\n]+)/i);i&&n.push(Li(`Operating system`,`Detected OS: ${i}`,[`environment`,`os`],`os-${i}`,.4,e.toolName));let a=Ii(t,/workspace(?: path)?\s*[:=]\s*([^\r\n]+)/i);a&&n.push(Li(`Workspace path`,`Primary workspace path: ${a}`,[`environment`,`workspace`],`workspace-${a}`,.4,e.toolName));let o=Ii(t,/store(?: backend)?\s*[:=]\s*([^\r\n]+)/i);o&&n.push(Li(`Store backend`,`Configured store backend: ${o}`,[`environment`,`storage`],`store-${o}`,.6,e.toolName));let s=Ii(t,/embedding(?: model)?\s*[:=]\s*([^\r\n]+)/i);return s&&n.push(Li(`Embedding model`,`Configured embedding model: ${s}`,[`environment`,`embedding`],`embedding-${s}`,.6,e.toolName)),n}},zi={"search-result":800,"file-card":2e3,analysis:1500,"step-summary":3e3},Bi=[`search`,`file_summary`,`stratum_card`,`compact`,`blast_radius`,`scope_map`],Vi={search:`search-result`,file_summary:`file-card`,stratum_card:`file-card`,compact:`analysis`,blast_radius:`analysis`,scope_map:`step-summary`},Hi={"search-result":72e5,"file-card":144e5,analysis:144e5,"step-summary":288e5};function Ui(e){return e.replace(/\s+/g,` `).trim()}function Wi(e){return Math.max(.6,Math.min(.8,ei(e)))}function H(e,t=500){let n=Ui(e);return n.length<=t?n:`${n.slice(0,Math.max(0,t-3)).trimEnd()}...`}function Gi(e){return typeof e==`object`&&!!e}function Ki(e){try{return JSON.parse(e)}catch{return null}}function U(e){return typeof e==`string`?Ui(e):typeof e==`number`||typeof e==`boolean`?String(e):``}function qi(e,t=5){if(!Array.isArray(e))return[];let n=[];for(let r of e){if(n.length>=t)break;if(typeof r==`string`){let e=Ui(r);e&&n.push(e);continue}if(Gi(r)){let e=U(r.path)||U(r.sourcePath)||U(r.title)||U(r.name)||U(r.label);e&&n.push(e)}}return n}function W(e,...t){for(let n of t){let t=U(e[n]);if(t)return t}return``}function Ji(e){let t=[e.file,e.path,e.files,e.changed_files,e.changedFiles].flatMap(e=>typeof e==`string`?[Ui(e)]:qi(e,6));return[...new Set(t.filter(Boolean))].slice(0,6)}function Yi(e,t=6){let n=e.match(/(?:[A-Za-z]:[\\/]|\.\/?|\.\.[\\/]|[A-Za-z0-9_.-]+\/)[^\s,:;]+\.[A-Za-z0-9]+/g)??[];return[...new Set(n.map(e=>Ui(e)))].slice(0,t)}function Xi(e,t){return e.length===0?``:`${t}: ${e.join(`, `)}`}function Zi(e,t=3){return e.split(/\r?\n/).map(e=>Ui(e)).filter(e=>e.length>=12).slice(0,t)}function Qi(e){if(!Gi(e))return``;let t=U(e.title)||U(e.path)||U(e.sourcePath)||U(e.file),n=U(e.snippet)||U(e.preview)||U(e.content)||U(e.summary);return Ui([t,n&&`- ${n}`].filter(Boolean).join(` `))}function $i(e,t){let n=W(e,`query`),r=Ki(t);if(Gi(r)&&Array.isArray(r.results)){let e=r.results.map(e=>Qi(e)).filter(Boolean).slice(0,3);if(e.length>0)return H(`Query: ${n||`unknown`}. Top hits: ${e.join(` | `)}`,zi[`search-result`])}let i=Zi(t,3);return H(`Query: ${n||`unknown`}. Top hits: ${i.join(` | `)}`,zi[`search-result`])}function ea(e,t){let n=W(e,`path`,`file`),r=Ki(t);if(Gi(r)){let e=U(r.path)||n||`unknown file`,t=qi(r.imports,4),i=qi(r.exports,5),a=qi(r.functions,4),o=[`File: ${e}`,Xi(i,`Exports`),Xi(t,`Imports`),Xi(a,`Functions`)].filter(Boolean);if(o.length>1)return H(o.join(`. `),zi[`file-card`])}let i=Zi(t,4);return H(`File: ${n||`unknown file`}. Structure: ${i.join(` | `)}`,zi[`file-card`])}function ta(e,t){let n=Ji(e),r=W(e,`tier`)||`T1`,i=Ki(t);if(Gi(i)){let e=(Array.isArray(i.cards)?i.cards:[]).map(e=>Qi(e)).filter(Boolean).slice(0,3);if(e.length>0)return H(`Tier: ${r}. Files: ${n.join(`, `)||`unknown`}. Cards: ${e.join(` | `)}`,zi[`file-card`])}let a=Zi(t,3);return H(`Tier: ${r}. Files: ${n.join(`, `)||`unknown`}. Highlights: ${a.join(` | `)}`,zi[`file-card`])}function na(e,t){let n=W(e,`path`,`file`),r=W(e,`query`);return H(`Path: ${n||`unknown`}. Focus: ${r||`general`}. Summary: ${t}`,zi.analysis)}function ra(e,t){let n=Ji(e),r=Ki(t),i=Gi(r)?[...qi(r.affectedFiles,8),...qi(r.tests,4),...qi(r.importers,4)]:[],a=[...new Set([...i,...Yi(t,8)])].slice(0,8),o=[`Changed: ${n.join(`, `)||`unknown`}`,Xi(a,`Affected`)].filter(Boolean);return o.length>1?H(o.join(`. `),zi.analysis):H(`Changed: ${n.join(`, `)||`unknown`}. Summary: ${t}`,zi.analysis)}function ia(e,t){let n=W(e,`task`),r=Ki(t);if(Gi(r)){let e=qi(r.files,6),t=typeof r.totalFiles==`number`?r.totalFiles:e.length;if(e.length>0)return H(`Task: ${n||`unknown`}. Reading plan (${t} files): ${e.join(`, `)}`,zi[`step-summary`])}let i=Yi(t,6);return H(`Task: ${n||`unknown`}. Reading plan: ${i.join(`, `)||Zi(t,3).join(` | `)}`,zi[`step-summary`])}function aa(e,t){switch(e.toolName){case`search`:return $i(e.args,t);case`file_summary`:return ea(e.args,t);case`stratum_card`:return ta(e.args,t);case`compact`:return na(e.args,t);case`blast_radius`:return ra(e.args,t);case`scope_map`:return ia(e.args,t);default:return``}}function oa(e){switch(e.toolName){case`search`:return H(`Search: ${W(e.args,`query`)||`unknown query`}`,120);case`file_summary`:return H(`File summary: ${W(e.args,`path`,`file`)||`unknown file`}`,120);case`stratum_card`:return H(`Stratum card: ${Ji(e.args).join(`, `)||`unknown files`}${W(e.args,`tier`)?` (${W(e.args,`tier`)})`:``}`,120);case`compact`:return H(`Compact: ${W(e.args,`path`,`file`)||`unknown path`}${W(e.args,`query`)?` - ${W(e.args,`query`)}`:``}`,120);case`blast_radius`:return H(`Blast radius: ${Ji(e.args).join(`, `)||`unknown changes`}`,120);case`scope_map`:return H(`Scope map: ${W(e.args,`task`)||`unknown task`}`,120);default:return H(`Flow context: ${e.toolName}`,120)}}function sa(e){switch(e.toolName){case`search`:return`search:${W(e.args,`query`)||`unknown-query`}`;case`file_summary`:return`file-summary:${W(e.args,`path`,`file`)||`unknown-file`}`;case`stratum_card`:{let t=Ji(e.args).join(`,`),n=W(e.args,`tier`)||`unknown-tier`,r=W(e.args,`query`);return`stratum:${n}:${t}${r?`:${r}`:``}`}case`compact`:{let t=W(e.args,`path`,`file`)||`unknown-path`,n=W(e.args,`query`);return`compact:${t}${n?`:${n}`:``}`}case`blast_radius`:return`blast-radius:${Ji(e.args).join(`,`)||`unknown-changes`}`;case`scope_map`:return`scope-map:${W(e.args,`task`)||`unknown-task`}`;default:return`${e.toolName}:generic`}}function ca(e){return{name:`flow-context`,tools:[...Bi],extract(t){if(t.isError)return[];let n=e();if(!n?.active||!n.slug||!(t.toolName in Vi))return[];let r=$r(t.result).trim();if(r.length<50)return[];let i=Vi[t.toolName],a=aa(t,r);if(a.length<50)return[];let o=oa(t);return[{title:o,content:a,category:`flow-context`,tags:[`flow-context`,`flow:${n.slug}`,i,`tool:${t.toolName}`],hash:V(`${n.slug}|${t.toolName}|${o}|${a}`),identityKey:sa(t),quality:Wi(a),ttlMs:Hi[i],source:t.toolName}]}}}const la={name:`research-results`,tools:[`web_search`,`web_fetch`,`search`,`find`],extract(e){let t=$r(e.result);if(!t||t.length<100||e.isError)return[];let n=[];if(e.toolName===`web_search`){let r=typeof e.args.query==`string`?e.args.query:``;if(r&&t.length>200){let i=t.slice(0,800);n.push({title:`Web research: ${r.slice(0,80)}`,content:`Research query: "${r}"\n\nKey findings:\n${i}`,category:`context`,tags:[`research`,`web-search`],hash:V(`web-search-${r}`),quality:Math.min(.8,ei(i)+.2),source:e.toolName,ttlMs:864e5})}}if(e.toolName===`web_fetch`){let r=e.args.urls,i=Array.isArray(r)?String(r[0]??``):typeof e.args.url==`string`?e.args.url:``;if(i&&t.length>200){let r=t.split(/\r?\n/).find(e=>e.trim().length>10)?.trim()??i,a=t.slice(0,600);n.push({title:`Fetched: ${r.slice(0,80)}`,content:`Source: ${i}\n\n${a}`,category:`context`,tags:[`research`,`web-fetch`],hash:V(`web-fetch-${i}`),quality:ei(a),source:e.toolName,ttlMs:864e5})}}if(e.toolName===`search`){let r=typeof e.args.query==`string`?e.args.query:``,i=typeof e.args.origin==`string`?e.args.origin:``,a=typeof e.args.search_mode==`string`?e.args.search_mode:`hybrid`;i===`curated`&&r&&t.length>100&&n.push({title:`Curated search: ${r.slice(0,80)}`,content:`Searched curated knowledge for: "${r}"\n\nResults:\n${t.slice(0,500)}`,category:`context`,tags:[`research`,`curated-search`],hash:V(`curated-search-${r}`),quality:.5,source:e.toolName,ttlMs:36e5}),i!==`curated`&&r&&t.length>150&&n.push({title:`Search: ${r.slice(0,80)}`,content:t.slice(0,500),category:`context`,tags:[`research`,`search`,i||`hybrid`,a],hash:V(`search-${r}-${i||`hybrid`}-${a}`),quality:.5,source:e.toolName,ttlMs:36e5})}if(e.toolName===`find`){let r=typeof e.args.query==`string`?e.args.query:``,i=typeof e.args.pattern==`string`?e.args.pattern:``,a=typeof e.args.glob==`string`?e.args.glob:``,o=typeof e.args.mode==`string`?e.args.mode:``,s=r||i||a||``;s&&t.length>100&&n.push({title:o?`Find (${o}): ${s.slice(0,60)}`:`Find: ${s.slice(0,60)}`,content:t.slice(0,600),category:`context`,tags:[`research`,`find`,o||`search`],hash:V(`find-${r}-${i}-${a}-${o}`),quality:.55,source:e.toolName,ttlMs:36e5})}return n}},ua=new Set([`neighbors`,`traverse`,`find_nodes`,`symbol360`]),da=144e5;function fa(e,t){return e.slice(0,t).trim()}function pa(e,t){let n=fa(t,800);return n.length<80?[]:[{title:`Symbol: ${e}`,content:n,category:`patterns`,tags:[`architecture`,`symbol`,`definition`],hash:V(`symbol-${e}`),quality:.7,ttlMs:da,source:`symbol`}]}function ma(e,t,n){let r=fa(n,800);return r.length<100?[]:[{title:`Trace ${t}: ${e}`,content:r,category:`patterns`,tags:[`architecture`,`trace`,`data-flow`,t],hash:V(`trace-${e}-${t}`),quality:.75,ttlMs:da,source:`trace`}]}function ha(e,t){return e===`find_nodes`?`Graph nodes: ${t}`:e===`neighbors`?`Graph neighbors: ${t}`:e===`traverse`?`Graph traverse: ${t}`:`Symbol360: ${t}`}function ga(e,t,n,r,i){let a=fa(i,600);return a.length<50?[]:[{title:ha(e,t),content:a,category:`patterns`,tags:[`architecture`,`graph`,e],hash:V(`graph-${e}-${t}-${n}-${r}`),quality:.6,ttlMs:da,source:`graph`}]}const _a={name:`symbol-analysis`,tools:[`symbol`,`trace`,`graph`],extract(e){let t=$r(e.result);if(!t||e.isError)return[];if(e.toolName===`symbol`){let n=typeof e.args.name==`string`?e.args.name:``;return n?pa(n,t):[]}if(e.toolName===`trace`){let n=typeof e.args.start==`string`?e.args.start:``,r=typeof e.args.direction==`string`?e.args.direction:``;return!n||!r?[]:ma(n,r,t)}if(e.toolName===`graph`){let n=typeof e.args.action==`string`?e.args.action:``;if(!ua.has(n))return[];let r=typeof e.args.node_id==`string`?e.args.node_id:``,i=typeof e.args.name_pattern==`string`?e.args.name_pattern:``;if(n===`find_nodes`&&!i||(n===`neighbors`||n===`traverse`||n===`symbol360`)&&!r)return[];let a=typeof e.args.direction==`string`?e.args.direction:`both`,o=typeof e.args.max_depth==`number`?String(e.args.max_depth):``;return ga(n,n===`find_nodes`?i:r,a,o,t)}return[]}};function va(e){let t=e.toLowerCase();return t.includes(`vitest`)?`vitest`:t.includes(`jest`)?`jest`:t.includes(`mocha`)?`mocha`:t.includes(`playwright`)?`playwright`:t.includes(`cypress`)?`cypress`:null}function ya(e){let t=[/(\S+\.test\.\w+)/,/(\S+\.spec\.\w+)/,/(\S+_test\.\w+)/,/__tests__\/\S+/],n=new Set;for(let r of t){let t=e.matchAll(new RegExp(r.source,`g`));for(let e of t){let t=e[0].match(/\.(test|spec)\.\w+$/);t&&n.add(t[0])}}return n.size>0?[...n].join(`, `):null}const ba={name:`test-results`,tools:[`check`,`test_run`],extract(e){let t=$r(e.result);if(!t)return[];let n=[],r=va(t);r&&n.push({title:`Test framework: ${r}`,content:`This project uses ${r} for testing. Detected from ${e.toolName} output.`,category:`context`,tags:[`testing`,`environment`,r],hash:V(`test-framework-${r}`),quality:.7,source:e.toolName});let i=ya(t);return i&&n.push({title:`Test file pattern: ${i}`,content:`Test files use the naming pattern: ${i}. Follow this convention when creating new tests.`,category:`conventions`,tags:[`testing`,`naming-convention`],hash:V(`test-pattern-${i}`),quality:.7,source:e.toolName}),n}};function xa(e){let t=e.toLowerCase();return/enoent|no such file|not found/i.test(e)?{type:`missing-file`,actionable:!1}:/econnreset|econnrefused|etimedout|fetch failed/i.test(e)?{type:`network`,actionable:!1}:/permission denied|eacces/i.test(e)?{type:`permission`,actionable:!0}:/type\s*error|cannot.*property|is not a function/i.test(e)?{type:`type-error`,actionable:!0}:/syntax\s*error|unexpected token|parsing error/i.test(e)?{type:`syntax`,actionable:!0}:/out of memory|heap|allocation/i.test(e)?{type:`memory`,actionable:!0}:/timeout|timed out/i.test(e)?{type:`timeout`,actionable:t.includes(`increase`)||t.includes(`config`)}:/import|require|module not found|cannot find module/i.test(e)?{type:`module-resolution`,actionable:!0}:{type:`unknown`,actionable:e.length>100}}const Sa={name:`tool-failure-patterns`,tools:[],extract(e){if(!e.isError)return[];let t=$r(e.result);if(!t||t.length<30)return[];let{type:n,actionable:r}=xa(t);if(!r)return[];let i=t.slice(0,500),a=ei(i);return a<.2?[]:[{title:`${n} error in ${e.toolName}`,content:`Tool \`${e.toolName}\` failed with a ${n} error.\n\nArgs: ${JSON.stringify(e.args,null,2).slice(0,200)}\n\nError:\n${i}`,category:`context`,tags:[`errors`,n,e.toolName],hash:V(`smart-error-${n}-${e.toolName}-${t.slice(0,80)}`),quality:Math.min(.7,a+.1),source:e.toolName,ttlMs:72e5}]}};var Ca=class{extractors=[];register(e){this.extractors.push(e)}getExtractors(e){return this.extractors.filter(t=>t.tools.length===0||t.tools.includes(e))}extractAll(e){return this.getExtractors(e.toolName).flatMap(t=>t.extract(e))}};function wa(e){return{content:[{type:`text`,text:(e instanceof Error,String(e))}],isError:!0}}function Ta(e,t){try{e.push(t)}catch{}}function Ea(e){return async(t,n)=>{let r=Date.now();try{let i=await n();return Ta(e,{toolName:t.toolName,args:t.args,result:i,durationMs:Date.now()-r,isError:i.isError===!0,timestamp:new Date().toISOString()}),i}catch(n){throw Ta(e,{toolName:t.toolName,args:t.args,result:wa(n),durationMs:Date.now()-r,isError:!0,timestamp:new Date().toISOString()}),n}}}const Da=L(`auto-knowledge`);var Oa=class{registry;curated;flowContextAdapter;queue=[];timer=null;seenHashes=new Map;failedBuffer=[];maxBufferSize=50;storedCount=0;droppedCount=0;dedupedCount=0;bufferDropCount=0;recoveryListenerRegistered=!1;config;existingCuratedEntries=null;recoveryListener=null;constructor(e,t,n={},r){this.registry=e,this.curated=t,this.flowContextAdapter=r,this.config={...Qr,...n}}push(e){if(!(!this.config.enabled||!this.curated&&!this.flowContextAdapter)&&!(this.storedCount>=this.config.maxFactsPerSession)){if(this.queue.push(e),this.queue.length>=this.config.batchSize){this.flush().catch(e=>{Da.warn(`Auto-knowledge flush error`,{error:String(e)})});return}this.scheduleBatch()}}async flush(){this.timer&&=(clearTimeout(this.timer),null);let e=this.queue.splice(0);if(e.length===0||!this.curated&&!this.flowContextAdapter)return;this.existingCuratedEntries===null&&(this.existingCuratedEntries=await this.loadExistingCuratedEntries());let t=new Map;for(let n of e)for(let e of this.registry.extractAll(n)){if(e.quality<this.config.minQuality){this.droppedCount++;continue}if(this.isSeenRecently(e)){this.dedupedCount++;continue}let n=this.buildFactIdentity(e),r=t.get(n);if(r){t.set(n,this.choosePreferredFact(r,e)),this.dedupedCount++;continue}t.set(n,e)}for(let e of t.values()){if(this.storedCount>=this.config.maxFactsPerSession)break;if(Ee.instance().isDegraded(`embedder`)){Da.debug?.(`Auto-knowledge embedder degraded — buffering fact`),this.bufferFact(e);continue}try{await this.storeFact(e)}catch(t){Da.warn(`Auto-knowledge store failed — buffered for retry`,{title:e.title,error:String(t)}),this.bufferFact(e)}}}reset(){this.queue=[],this.seenHashes.clear(),this.failedBuffer.length=0,this.storedCount=0,this.droppedCount=0,this.dedupedCount=0,this.bufferDropCount=0,this.existingCuratedEntries=null,this.removeRecoveryListener(),this.timer&&=(clearTimeout(this.timer),null)}getStats(){return{queued:this.queue.length,stored:this.storedCount,seen:this.seenHashes.size,dropped:this.droppedCount,deduped:this.dedupedCount,bufferSize:this.failedBuffer.length,bufferDropped:this.bufferDropCount}}bufferFact(e){this.failedBuffer.length>=this.maxBufferSize&&(this.failedBuffer.shift(),this.bufferDropCount++),this.failedBuffer.push(e),this.ensureRecoveryListener()}ensureRecoveryListener(){if(this.recoveryListenerRegistered)return;let e=Ee.instance(),t=n=>{n.subsystem===`embedder`&&(e.removeListener(`healthy`,t),this.recoveryListener=null,this.recoveryListenerRegistered=!1,this.flushBuffer().catch(e=>{Da.warn(`Buffer flush failed`,{error:String(e)})}))};this.recoveryListener=t,this.recoveryListenerRegistered=!0,e.on(`healthy`,t)}removeRecoveryListener(){if(!this.recoveryListener){this.recoveryListenerRegistered=!1;return}Ee.instance().removeListener(`healthy`,this.recoveryListener),this.recoveryListener=null,this.recoveryListenerRegistered=!1}async flushBuffer(){if(this.failedBuffer.length===0||!this.curated&&!this.flowContextAdapter)return;this.existingCuratedEntries===null&&(this.existingCuratedEntries=await this.loadExistingCuratedEntries()),Da.info(`Flushing ${this.failedBuffer.length} buffered auto-knowledge facts`);let e=this.failedBuffer.splice(0);for(let t=0;t<e.length;t++){let n=e[t];if(n){if(this.storedCount>=this.config.maxFactsPerSession){this.failedBuffer.unshift(...e.slice(t));break}if(Ee.instance().isDegraded(`embedder`)){this.failedBuffer.unshift(...e.slice(t)),this.ensureRecoveryListener();break}try{let e=await this.storeFact(n);(e===`created`||e===`updated`)&&Da.info(`Buffered fact stored on recovery`,{title:n.title,status:e})}catch(r){Da.warn(`Auto-knowledge store failed — buffered for retry`,{title:n.title,error:String(r)}),this.failedBuffer.unshift(n,...e.slice(t+1)),this.ensureRecoveryListener();break}}}}isSeenRecently(e){let t=this.seenHashes.get(e.hash);return t==null?!1:e.ttlMs==null?!0:Date.now()-t<e.ttlMs}normalizeTitle(e){return e.toLowerCase().trim()}buildFactIdentity(e){let t=e.identityKey?`key:${e.identityKey}`:`hash:${e.hash||this.normalizeTitle(e.title)}`;return`${e.category}:${t}`}choosePreferredFact(e,t){return t.quality===e.quality?e:t.quality>e.quality?t:e}slugify(e){return e.toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-|-$/g,``).slice(0,80)||`untitled`}resolveCuratedRelativePath(e){let t=`${e.category}/auto-${this.slugify(e.identityKey??e.title)}.md`,n=this.existingCuratedEntries??[],r=n.find(e=>e.path===t);if(r)return r.path;let i=this.normalizeTitle(e.title),a=n.filter(t=>t.category===e.category&&this.normalizeTitle(t.title)===i);return a.length===0?t:(a.sort((t,n)=>{let r=this.tagOverlapScore(n.tags,e.tags),i=this.tagOverlapScore(t.tags,e.tags);return r===i?t.path.localeCompare(n.path):r-i}),a[0]?.path??t)}resolveFlowContextRelativePath(e){return`${e.tags.find(e=>!e.startsWith(`flow:`)&&!e.startsWith(`tool:`)&&e!==`flow-context`)||`analysis`}/${this.slugify(e.identityKey??e.title)}.md`}tagOverlapScore(e,t){let n=new Set(e),r=0;for(let e of t)n.has(e)&&(r+=1);return r}markFactSeen(e){this.seenHashes.set(e.hash,Date.now())}rememberExistingCuratedFact(e,t){let n=this.existingCuratedEntries;if(!n)return;let r=n.find(t=>t.path===e);if(r){r.title=t.title,r.category=t.category,r.tags=[...t.tags];return}n.push({path:e,title:t.title,category:t.category,tags:[...t.tags]})}async storeFact(e){if(e.tags.includes(`flow-context`)&&this.flowContextAdapter){let t=this.resolveFlowContextRelativePath(e),n=`# ${e.title}\n\n${e.content}`,r=await this.flowContextAdapter.read(t);if(r===n)return this.markFactSeen(e),this.dedupedCount++,`unchanged`;await this.flowContextAdapter.write(t,n);let i=r==null?`created`:`updated`;return this.markFactSeen(e),this.storedCount++,Da.info(i===`created`?`Auto-knowledge stored`:`Auto-knowledge refreshed`,{title:e.title,category:e.category,quality:e.quality,source:e.source,status:i}),i}else if(this.curated){let t=this.resolveCuratedRelativePath(e),n=`Auto-knowledge refresh from ${e.source}`,r=this.curated;if(typeof r.upsertAutoKnowledge==`function`){let i=await r.upsertAutoKnowledge(t,e.title,e.content,e.category,e.tags,n);return this.markFactSeen(e),this.rememberExistingCuratedFact(i.path,e),i.status===`unchanged`?(this.dedupedCount++,`unchanged`):(this.storedCount++,Da.info(i.status===`created`?`Auto-knowledge stored`:`Auto-knowledge refreshed`,{title:e.title,category:e.category,quality:e.quality,source:e.source,status:i.status}),i.status)}await this.curated.remember(e.title,e.content,e.category,e.tags)}else return`skipped`;return this.markFactSeen(e),this.storedCount++,this.curated&&this.rememberExistingCuratedFact(this.resolveCuratedRelativePath(e),e),Da.info(`Auto-knowledge stored`,{title:e.title,category:e.category,quality:e.quality,source:e.source}),`created`}async loadExistingCuratedEntries(){let e=this.curated;if(!e)return[];try{return(await e.list()).map(e=>({path:e.path,title:e.title,category:e.category,tags:[...e.tags]}))}catch{Da.warn(`Failed to load existing curated entries for dedup`,{})}return[]}scheduleBatch(){this.timer||=setTimeout(()=>{this.timer=null,this.flush().catch(e=>{Da.warn(`Auto-knowledge flush error`,{error:String(e)})})},this.config.debounceMs)}};const ka=/```/,Aa=/^\s*(?:import|export|function|class|interface|type|const|let|var|return|if|for|while|switch|try|catch|throw|await|async)\b/,ja=/=>|;\s*$|{\s*$|}\s*$|:\s*(?:string|number|boolean|unknown|void|any|Record|Array|Set|Map|Promise|ReadonlyArray)\b/;function Ma(e){let t=e.trimStart();if(t.length===0)return!1;let n=t.charAt(0);return n!==`{`&&n!==`[`?!1:n===`{`?!(!t.includes(`"`)||!t.includes(`:`)):t.length>2}function Na(e){if(Ma(e)||e.includes("```")||ka.test(e))return!0;let t=e.split(/\r?\n/u).filter(e=>e.trim().length>0);if(t.length<3)return!1;let n=0;for(let e of t)(Aa.test(e)||ja.test(e))&&(n+=1);return n/t.length>=.25}function Pa(e){let t=e.meta?.compression?.preserve??`balanced`;if(t===`exact`||Na(e.text))return{profile:`exact`,shouldCompress:!1,mode:`structural`,threshold:e.threshold,tokenBudget:e.tokenBudget,reason:t===`exact`?`tool-specific preservation profile`:`code-like output preserved verbatim`};if(t===`dense`){let t=Math.max(1,Math.floor(e.threshold*.65)),n=Math.max(1,Math.floor(e.tokenBudget*.6));return{profile:`dense`,shouldCompress:e.text.length>=t,mode:`aggressive`,threshold:t,tokenBudget:n,reason:`dense tool profile`}}return{profile:`balanced`,shouldCompress:e.text.length>=e.threshold,mode:`structural`,threshold:e.threshold,tokenBudget:e.tokenBudget,reason:`balanced tool profile`}}const G={search:{title:`Hybrid Search`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`dense`}},find:{title:`Federated Find`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`dense`}},symbol:{title:`Symbol Resolver — Cross-Module Definitions & References`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`exact`}},trace:{title:`Data Flow Tracer — Cross-Module Call & Import Chains`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`exact`}},scope_map:{title:`Task Scope Map`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`exact`},capabilities:{indexIndependent:!0}},lookup:{title:`Chunk Lookup`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`exact`}},dead_symbols:{title:`Dead Symbol Finder`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`exact`}},file_summary:{title:`File Summary`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`],compression:{preserve:`exact`,selfManaged:!0},capabilities:{indexIndependent:!0}},analyze:{title:`Analyze`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`analysis`],compression:{preserve:`exact`}},blast_radius:{title:`Blast Radius`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`analysis`,`search`],compression:{preserve:`exact`}},knowledge:{title:`Knowledge`,annotations:{readOnlyHint:!1},category:[`knowledge`],compression:{preserve:`balanced`},capabilities:{indexIndependent:!0}},memory_explain:{title:`Memory Explain`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`knowledge`,`search`],compression:{preserve:`exact`}},produce_knowledge:{title:`Produce Knowledge`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`knowledge`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},compact:{title:`Semantic Compactor`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`compression`],compression:{preserve:`balanced`},capabilities:{indexIndependent:!0}},digest:{title:`Multi-Source Digest`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`compression`],compression:{preserve:`balanced`},capabilities:{indexIndependent:!0}},stratum_card:{title:`Stratum Card`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`compression`],compression:{preserve:`balanced`},capabilities:{indexIndependent:!0}},forge_ground:{title:`FORGE Ground`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`forge`],compression:{preserve:`exact`}},forge_classify:{title:`FORGE Classify`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`forge`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},evidence_map:{title:`Evidence Map`,annotations:{readOnlyHint:!1},category:[`forge`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},present:{title:`Rich Content Presenter`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`presentation`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},check:{title:`Typecheck & Lint`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`execution`],compression:{preserve:`dense`,selfManaged:!0},capabilities:{zeroDep:!0,indexIndependent:!0}},test_run:{title:`Run Tests`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`execution`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},eval:{title:`Evaluate Code`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`execution`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},audit:{title:`Project Audit`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`execution`],compression:{preserve:`dense`,selfManaged:!0}},browser:{title:`Browser Automation`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`web`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},rename:{title:`Rename Symbol`,annotations:{readOnlyHint:!1,destructiveHint:!0},category:[`manipulation`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},restore:{title:`Restore`,annotations:{readOnlyHint:!1},category:[`manipulation`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},codemod:{title:`Codemod`,annotations:{readOnlyHint:!1,destructiveHint:!0},category:[`manipulation`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},data_transform:{title:`Data Transform`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`manipulation`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},stash:{title:`Stash Values`,annotations:{readOnlyHint:!1},category:[`session`],compression:{preserve:`dense`},capabilities:{indexIndependent:!0}},signal:{title:`Inter-Agent Signaling`,annotations:{readOnlyHint:!1},category:[`session`],compression:{preserve:`dense`},capabilities:{indexIndependent:!0}},checkpoint:{title:`Session Checkpoint`,annotations:{readOnlyHint:!1},category:[`session`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},session_digest:{title:`Session Digest`,annotations:{readOnlyHint:!0,idempotentHint:!1},category:[`session`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},compliance_score:{title:`Compliance Score`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`session`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},workset:{title:`Workset Manager`,annotations:{readOnlyHint:!1},category:[`session`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},lane:{title:`Exploration Lane`,annotations:{readOnlyHint:!1},category:[`session`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},git_context:{title:`Git Context`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`git`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},diff_parse:{title:`Diff Parser`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`git`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},parse_output:{title:`Parse Build Output`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`git`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},process:{title:`Process Manager`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`process`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},watch:{title:`File Watcher`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`process`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},delegate:{title:`Delegate Task`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`process`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},config:{title:`Configuration Manager`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`exact`},capabilities:{indexIndependent:!0}},status:{title:`AI Kit Status`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},health:{title:`Health Check`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},reindex:{title:`Reindex`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`dense`},capabilities:{indexIndependent:!0}},onboard:{title:`Onboard Codebase`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`dense`},capabilities:{indexIndependent:!0}},graph:{title:`Code Knowledge Graph — Module & Symbol Relationships`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`balanced`},capabilities:{indexIndependent:!0}},guide:{title:`Tool Guide`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},replay:{title:`Replay History`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},list_tools:{title:`List Available Tools`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`meta`],compression:{preserve:`exact`},capabilities:{zeroDep:!0}},describe_tool:{title:`Describe Tool`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`meta`],compression:{preserve:`exact`},capabilities:{zeroDep:!0}},search_tools:{title:`Search Tools`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`meta`],compression:{preserve:`exact`},capabilities:{zeroDep:!0}},changelog:{title:`Generate Changelog`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},regex_test:{title:`Regex Tester`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},encode:{title:`Encode / Decode`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},measure:{title:`Code Metrics`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},schema_validate:{title:`Schema Validator`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},env:{title:`Environment Info`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},time:{title:`Date & Time`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`],compression:{preserve:`exact`},capabilities:{zeroDep:!0,indexIndependent:!0}},web_fetch:{title:`Web Fetch`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`web`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},web_search:{title:`Web Search`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`web`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},http:{title:`HTTP Request`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`web`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0,indexIndependent:!0}},queue:{title:`Operation Queue`,annotations:{readOnlyHint:!1},category:[`queue`],compression:{preserve:`dense`},capabilities:{zeroDep:!0,indexIndependent:!0}},bridge_push:{title:`Bridge Push`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},bridge_pull:{title:`Bridge Pull`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},bridge_sync:{title:`Bridge Sync Status`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},er_push:{title:`Enterprise Push`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},er_pull:{title:`Enterprise Pull`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},er_sync_status:{title:`Enterprise Sync Status`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},er_update_policy:{title:`Enterprise Update Policy`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},er_evolve_review:{title:`Enterprise Evolution Review`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},evolution_state:{title:`Evolution State`,annotations:{readOnlyHint:!1},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},policy_check:{title:`Policy Check`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`],compression:{preserve:`balanced`},capabilities:{conditional:!0}},flow:{title:`Flow`,annotations:{readOnlyHint:!1},category:[`flow`],compression:{preserve:`balanced`},capabilities:{zeroDep:!0}}},Fa=Object.keys(G).filter(e=>!G[e]?.capabilities?.conditional),Ia=new Set(Object.entries(G).filter(([e,t])=>t.capabilities?.zeroDep).map(([e])=>e)),La=new Set(Object.entries(G).filter(([e,t])=>t.capabilities?.indexIndependent).map(([e])=>e));function K(e){return G[e]??{title:e,annotations:{readOnlyHint:!1},category:[]}}function Ra(e){switch(e){case`efficient`:return{threshold:2e3,tokenBudget:1e3};case`full`:return{threshold:1/0};default:return{threshold:4e3,tokenBudget:2e3}}}function za(e){let t=e?.threshold??4e3,n=e?.tokenBudget??2e3;return async(e,r)=>{if(K(e.toolName).compression?.selfManaged)return r();let i=await r();if(!Array.isArray(i.content))return i;let a={profile:`balanced`,applied:!1,reason:`below threshold`,mode:`structural`,threshold:t,tokenBudget:n,originalChars:0,compressedChars:0,savedChars:0,compressedItems:0,preservedItems:0},o=i.content.map(r=>{if(r.type!==`text`||typeof r.text!=`string`)return r;a.originalChars+=r.text.length;let i=Pa({meta:e.meta,text:r.text,threshold:t,tokenBudget:n});if(a.profile=i.profile,a.mode=i.mode,a.threshold=i.threshold,a.tokenBudget=i.tokenBudget,a.reason=i.reason,!i.shouldCompress||r.text.length<i.threshold)return a.preservedItems+=1,a.compressedChars+=r.text.length,r;let o=Qe({text:r.text,tool:e.toolName,tokenBudget:i.tokenBudget,mode:i.mode});return a.applied=!0,a.compressedItems+=1,a.compressedChars+=o.text.length,o.text===r.text?r:{...r,text:o.text}});return a.originalChars===0?i:(a.savedChars=a.originalChars-a.compressedChars,{...i,content:o,_meta:{...i._meta??{},compression:a}})}}var Ba=class{baseDir;getActiveSlug;constructor(e,t){this.baseDir=e,this.getActiveSlug=t}async initialize(){await jn(this.baseDir,{recursive:!0})}async read(e){let t=this.resolveScopedPath(e);if(t==null)return null;try{return await Mn(t,`utf-8`)}catch(e){if(this.isMissingError(e))return null;throw e}}async write(e,t,n){let r=this.resolveScopedPath(e);r!=null&&(await jn(ge(r),{recursive:!0}),await Ln(r,t,{encoding:`utf-8`,flag:n?.exclusive?`wx`:`w`}))}async delete(e){let t=this.resolveScopedPath(e);if(t==null)return!1;try{return await In(t),!0}catch(e){if(this.isMissingError(e))return!1;throw e}}async list(e){let t=this.getActiveSlugDir();if(t==null)return[];let n=e?this.resolveScopedPath(e):t;return n==null?[]:this.collectFiles(n,e??``)}async exists(e){let t=this.resolveScopedPath(e);if(t==null)return!1;try{return await Fn(t),!0}catch(e){if(this.isMissingError(e))return!1;throw e}}async listDirectories(){let e=this.getActiveSlugDir();if(e==null)return[];try{return(await Nn(e,{withFileTypes:!0})).filter(e=>e.isDirectory()&&/^[a-z][a-z0-9-]*$/.test(e.name)).map(e=>e.name).sort()}catch(e){if(this.isMissingError(e))return[];throw e}}async flushAll(){let e=this.getActiveSlugDir();if(e==null)return 0;let t=await this.countFiles(e);return t===0?0:(await Pn(e,{recursive:!0,force:!0}),t)}async close(){}getActiveSlugDir(){let e=this.getActiveSlug();return e?F(this.baseDir,e):null}resolveScopedPath(e){let t=this.getActiveSlugDir();if(t==null)return null;let n=I(t),r=I(n,e),i=ve(n,r);if(i===``||i===`..`||i.startsWith(`..${ye}`)||_e(i))throw Error(`Path escapes active flow context scope: ${e}`);return r}async collectFiles(e,t){let n;try{n=await Nn(e,{withFileTypes:!0})}catch(e){if(this.isMissingError(e))return[];throw e}let r=[];for(let i of n){let n=t?`${t}/${i.name}`:i.name,a=F(e,i.name);if(i.isDirectory()){r.push(...await this.collectFiles(a,n));continue}if(!(!i.isFile()||!i.name.endsWith(`.md`)))try{let e=await Fn(a);r.push({path:n,size:e.size,mtimeMs:e.mtimeMs})}catch(e){if(!this.isMissingError(e))throw e}}return r.sort((e,t)=>e.path.localeCompare(t.path))}async countFiles(e){let t;try{t=await Nn(e,{withFileTypes:!0})}catch(e){if(this.isMissingError(e))return 0;throw e}let n=0;for(let r of t){let t=F(e,r.name);if(r.isDirectory()){n+=await this.countFiles(t);continue}r.isFile()&&(n+=1)}return n}isMissingError(e){return typeof e==`object`&&!!e&&`code`in e&&(e.code===`ENOENT`||e.code===`ENOTDIR`)}};const Va=L(`observation-capture`),Ha=[`check`,`test_run`,`search`,`trace`],Ua=[/\bAuthorization\s*:\s*Bearer\s+[A-Za-z0-9\-._~+/]+=*/gi,/\bBearer\s+[A-Za-z0-9\-._~+/]+=*/g,/\b(?:sk|ghp|gho|glpat|xoxb|xoxp)-[A-Za-z0-9\-._]{20,}\b/g,/\b(?:token|key|secret|password|auth(?:orization)?)\s*[=:]\s*['"]?[^\s'"&]{8,}/gi,/\b(?:token|key|secret|password|auth(?:orization)?)=[^\s&]+/gi,/\b[A-Z][A-Z0-9_]*(?:PASSWORD|SECRET|TOKEN|AUTH)[A-Z0-9_]*\b\s*[=:]\s*['"]?[^\s'"]+/g,/\b[A-Z][A-Z0-9_]*KEY[A-Z0-9_]*\b\s*[=:]\s*['"]?[^\s'"]{8,}/g,/-----BEGIN [\w\s]+-----[\s\S]*?-----END [\w\s]+-----/g],Wa=new Set([`env`,`auth`,`config`]),Ga=2e3,Ka={enabled:!0,rateLimit:10,captureFrom:[...Ha],minContentLength:50};var qa=class{maxPerMinute;timestamps=[];constructor(e){this.maxPerMinute=e}canCapture(e=Date.now()){return this.prune(e),this.timestamps.length<this.maxPerMinute}record(e=Date.now()){this.prune(e),this.timestamps.push(e)}setLimit(e){this.maxPerMinute=e,this.prune(Date.now())}prune(e){let t=e-6e4;this.timestamps=this.timestamps.filter(e=>e>t)}};function Ja(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Ya(e){return typeof e==`string`?e:Ja(e)?[Array.isArray(e.content)?e.content.filter(e=>Ja(e)).map(e=>typeof e.text==`string`?e.text:``).filter(e=>e.length>0).join(`
|
|
22
22
|
`):``,e.structuredContent==null?``:JSON.stringify(e.structuredContent,null,2)].filter(e=>e.length>0).join(`
|
|
23
23
|
|
|
24
|
-
`):JSON.stringify(e)}function
|
|
25
|
-
`),r=await this.curatedStore.remember(t,n,`context`,[`observation`,`source-${e.source}`,`type-${e.type}`]);this.stateStore.memoryMetaCreate(r.path,`working`)}};function
|
|
26
|
-
`)}function
|
|
27
|
-
`):`_No curated entries yet._`}`,mimeType:`text/markdown`}]}});let n=new
|
|
28
|
-
`),mimeType:`text/plain`}]})),e.registerResource(`aikit-channel-surface-schema`,Wo,{description:`JSON Schema for the ChannelSurface communication contract`,mimeType:`application/schema+json`},async()=>({contents:[{uri:Wo,text:await qo(),mimeType:`application/schema+json`}]})),Uo(e,n)}const Yo=[`er_push`,`er_pull`,`er_sync_status`],Xo=[...Yo,`er_update_policy`,`er_evolve_review`],Zo=new Set(Xo);function Qo(e){return e.toolProfiles}const $o=5e3,es=L(`structured-content-guard`);function ts(){let e=(async(e,t)=>{let n;try{n=await t()}catch(e){n={content:[{type:`text`,text:`[ERROR:INTERNAL] ${e instanceof Error?e.message:String(e)}`}],isError:!0}}let r=(e.toolConfig??{}).outputSchema;if(r==null)return n;let i=null;if(n.structuredContent==null){let t=ns(r);n.structuredContent=t,i=`synthesize`,n.structuredContent??(n.structuredContent={},i=`synthesize-null-fallback`,es.error(`synthesizeStructuredContent returned null/undefined — using empty fallback`,{tool:e.toolName}))}let a=rs(r,n.structuredContent);if(a.action!=null&&(n.structuredContent=a.structuredContent,i=a.action),as(n.structuredContent)||(n.isError=!0,n.structuredContent={},i=`fallback-error`),is(r,n.structuredContent)===!1){let e=ns(r);n.structuredContent=e??{},is(r,n.structuredContent)===!1?(n.structuredContent=as(n.structuredContent)?n.structuredContent:{},i=`final-validation-failed`):i??=`final-heal`}return n});return e.critical=!0,e}function ns(e){try{return os(e)??{}}catch{return{}}}function rs(e,t){if(is(e,t)!==!1)return{structuredContent:t,action:null};try{let n=ns(e);if(as(n)&&as(t)){let r={...n,...t};if(is(e,r)!==!1)return{structuredContent:r,action:`heal`}}return{structuredContent:n,action:`fallback-zero-value`}}catch{return{structuredContent:t,action:null}}}function is(e,t){let n=e.safeParse;if(typeof n==`function`)try{return n(t).success}catch{return}}function as(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function os(e){if(!e)return{};if(e.anyOf){let t=e.anyOf.find(e=>e.type!==`null`);return t?os(t):null}let t=e._def?.typeName;if(t&&!e.type)switch(t){case`ZodObject`:{let t={},n=null;try{n=e.shape??(typeof e._def?.shape==`function`?e._def.shape():e._def?.shape)}catch{n=null}if(n)for(let[e,r]of Object.entries(n))try{t[e]=os(r)}catch{t[e]=null}return t}case`ZodArray`:return[];case`ZodString`:return``;case`ZodNumber`:return 0;case`ZodBoolean`:return!1;case`ZodNullable`:return null;case`ZodOptional`:return;case`ZodRecord`:return{};case`ZodEnum`:return e._def?.values?.[0]??``;default:return{}}switch(e.type){case`object`:{let t={},n=e.properties??e.shape;if(n)for(let[e,r]of Object.entries(n))t[e]=os(r);return t}case`array`:return[];case`string`:return``;case`number`:case`integer`:return 0;case`boolean`:return!1;case`nullable`:return null;case`optional`:return;case`record`:return{};case`enum`:return e.options?.[0]??Object.values(e.enum??e._def?.entries??{})[0]??``;default:return{}}}function ss(e){if(!e)return{};try{let t=os(e);return as(t)?t:{}}catch{return{}}}const cs=Symbol(`toolPipelineState`);function ls(e){return e[cs]}function us(e,t){e[cs]=t}function ds(e,t){return t?async(...n)=>{let r=await e(...n);if(!r||typeof r!=`object`)return r;let i=r;return!(`content`in i)||i.structuredContent!=null&&typeof i.structuredContent==`object`?r:(i.structuredContent=ss(t),i.structuredContent??={},r)}:e}function fs(e,t,n=``){let r=ls(e);if(r){r.pipeline=t,r.prefix=n;return}us(e,{originalRegisterTool:e.registerTool.bind(e),pipeline:t,prefix:n}),e.registerTool=(n,r,i)=>{let a=ls(e),o=a?.prefix?`${a.prefix}${n}`:n;if(!i)return a?.originalRegisterTool(o,r);let s=r?.outputSchema;if((a?.pipeline??t).getMiddlewareNames().length===0){let e=ds(i,s);return a?.originalRegisterTool(o,r,e)}let c=G(n),l=ds((a?.pipeline??t).wrap(n,i,r,c),s);return a?.originalRegisterTool(o,r,l)}}const ps={analyze:1,audit:1,blast_radius:1,changelog:1,check:2,checkpoint:2,codemod:2,compact:1,config:0,data_transform:1,dead_symbols:1,delegate:3,describe_tool:1,diff_parse:1,digest:1,encode:1,env:0,eval:2,evidence_map:2,file_summary:1,find:1,flow:3,forge_classify:1,forge_ground:2,git_context:1,graph:1,guide:0,health:0,http:1,lane:2,list_tools:1,lookup:1,measure:1,onboard:3,parse_output:1,present:1,process:3,produce_knowledge:3,queue:3,regex_test:1,reindex:3,rename:2,replay:1,restore:2,schema_validate:1,scope_map:1,search:1,search_tools:1,signal:2,session_digest:2,stash:2,status:0,stratum_card:1,symbol:1,test_run:2,time:0,trace:1,watch:3,web_fetch:1,web_search:1,workset:2};function ms(e,t){return e.filter(e=>(ps[e]??0)<=t)}const hs=new Set([`status`,`config`,`guide`,`health`]),gs={full:{description:`All tools enabled (default)`,includeCategories:[]},safe:{description:`Read-only tools — no file/state modifications`,includeCategories:[`search`,`analysis`,`compression`,`utilities`,`system`,`git`,`flow`],excludeTools:[`reindex`,`onboard`]},research:{description:`Search, analysis, knowledge, and web access`,includeCategories:[`search`,`analysis`,`knowledge`,`compression`,`web`,`system`,`flow`]},minimal:{description:`Essential tools only — search, status, basic operations`,includeCategories:[`search`,`system`],includeTools:[`compact`,`file_summary`,`check`,`test_run`]},discovery:{description:`Full toolset plus discovery-oriented meta-tools for guided tool exploration`,includeCategories:[],includeTools:[`list_tools`,`describe_tool`,`search_tools`]}};function _s(e,t){let n=gs[e];if(n)return n;let r=t?.[e];if(r)return r;throw Error(`Unknown tool profile: ${e}`)}function vs(e,t,n){return t.includes(`*`)?!0:(n[e]?.category??[]).some(e=>t.includes(e))}function ys(e,t,n,r){if(t.includes(`*`)){for(let t of n)e.add(t);return}for(let i of n)vs(i,t,r)&&e.add(i)}function bs(e,t,n){if(t.includes(`*`)){e.clear();return}for(let r of[...e])vs(r,t,n)&&e.delete(r)}function xs(e,t,n){if(!e||e.length===0||e.includes(`*`))return new Set(t);let r=new Set;return ys(r,e,t,n),r}function Ss(e,t){return e===void 0?t:t===void 0?e:Math.min(e,t)}function Cs(e,t){for(let n of[...e])t[n]?.annotations?.readOnlyHint===!1&&e.delete(n)}function ws(e,t,n=0,r=[]){if(n>10)throw Error(`Tool profile inheritance exceeded max depth 10: ${[...r,e].join(` -> `)}`);if(r.includes(e))throw Error(`Tool profile inheritance cycle detected: ${[...r,e].join(` -> `)}`);let i=_s(e,t);return Ss(i.extends?ws(i.extends,t,n+1,[...r,e]):void 0,i.maxTier)}function Ts(e,t,n,r){let i=(e,a,o)=>{if(a>10)throw Error(`Tool profile inheritance exceeded max depth 10: ${[...o,e].join(` -> `)}`);if(o.includes(e))throw Error(`Tool profile inheritance cycle detected: ${[...o,e].join(` -> `)}`);let s=_s(e,r),c=[...o,e],l=s.extends?i(s.extends,a+1,c):xs(s.includeCategories,t,n);s.extends&&s.includeCategories?.length&&ys(l,s.includeCategories,t,n),s.excludeCategories?.length&&bs(l,s.excludeCategories,n);for(let e of s.includeTools??[])l.add(e);for(let e of s.excludeTools??[])l.delete(e);return l},a=i(e,0,[]),o=ws(e,r);if(o!==void 0){let e=ms([...a],o);a.clear();for(let t of e)a.add(t)}for(let e of hs)a.add(e);return e===`safe`&&Cs(a,n),a}const Es=new Set([`search`,`analysis`,`knowledge`,`compression`,`forge`,`presentation`,`execution`,`manipulation`,`session`,`git`,`process`,`system`,`meta`,`utilities`,`web`,`queue`,`flow`]);function Ds(e,t,n,r){let i=process.env.AIKIT_TOOLSET||e.toolProfile||`full`,a=Ts(i,t,n,r);if(e.features&&e.features.length>0){let i=e.features.filter(e=>!Es.has(e));if(i.length>0)throw Error(`Unknown feature group(s): ${i.join(`, `)}. Valid categories: ${[...Es].join(`, `)}`);let o={description:`Synthetic profile from features config`,includeCategories:e.features},s=Ts(`_features`,t,n,{...r,_features:o});for(let e of a)!s.has(e)&&!hs.has(e)&&a.delete(e)}if(e.readOnly)for(let e of[...a])n[e]?.annotations?.readOnlyHint===!1&&!hs.has(e)&&a.delete(e);for(let e of hs)a.add(e);return i===`safe`&&Cs(a,n),a}const Os=z.object({mode:z.enum([`wasm`,`regex`,`unknown`]),reason:z.string(),pathsChecked:z.array(z.object({path:z.string(),exists:z.boolean()})),os:z.string(),arch:z.string(),nodeVersion:z.string(),webTreeSitterImportable:z.boolean(),healAttempted:z.boolean(),healSuccess:z.boolean(),healError:z.string().nullable(),initError:z.string().nullable(),wasmDir:z.string().nullable(),grammarCount:z.number()}),ks=z.object({kind:z.enum([`onboard`,`reindex`,`handoff`,`proceed`]),reason:z.string()}),As=z.object({title:z.string(),insight:z.string(),confidence:z.number()}),js=z.object({lessons:z.array(As),conventions:z.array(z.object({title:z.string(),preview:z.string()})),checkpoint:z.string().nullable()});z.object({totalRecords:z.number(),totalFiles:z.number(),lastIndexedAt:z.string().nullable(),onboarded:z.boolean(),onboardDir:z.string(),contentTypes:z.record(z.string(),z.number()),wasmAvailable:z.boolean(),wasmDiagnostics:Os,graphStats:z.object({nodes:z.number(),edges:z.number()}).nullable(),curatedCount:z.number(),serverVersion:z.string(),scaffoldVersion:z.string().nullable(),workspaceScaffoldVersion:z.string().nullable(),upgradeAvailable:z.boolean(),sessionTokens:z.object({callCount:z.number(),totalInputChars:z.number(),totalOutputChars:z.number(),estInputTokens:z.number(),estTotalTokens:z.number(),startTime:z.string()}).optional(),storeBackend:z.string().optional(),storeDiagnostics:z.object({adapterType:z.string(),vectorSearchEnabled:z.boolean(),ftsEnabled:z.boolean(),degradedMode:z.boolean(),dbPath:z.string(),dbSizeBytes:z.number().nullable(),embeddingDim:z.number(),vectorDtype:z.string()}).nullable().optional(),contextPressure:z.number().min(0).max(100).describe(`0–100 score indicating AI Kit saturation`),nextAction:ks,prelude:js.nullable().optional()}).catchall(z.any()),z.object({entries:z.array(z.object({path:z.string(),title:z.string(),category:z.string(),tags:z.array(z.string()),version:z.number(),preview:z.string()})),totalCount:z.number()});const Ms=z.object({ok:z.boolean(),checks:z.array(z.object({name:z.string(),ok:z.boolean(),message:z.string().optional()}))}),Ns=z.object({summary:z.object({totalFiles:z.number(),totalLines:z.number(),totalCodeLines:z.number(),totalFunctions:z.number(),avgComplexity:z.number(),maxComplexity:z.object({value:z.number(),file:z.string()})}),files:z.array(z.object({path:z.string(),lines:z.number(),code:z.number(),complexity:z.number(),functions:z.number()}))}),Ps=z.object({platform:z.string(),arch:z.string(),nodeVersion:z.string(),cwd:z.string(),cpus:z.number(),memoryFreeGb:z.number(),memoryTotalGb:z.number()}),Fs=z.object({iso:z.string(),unix:z.number(),timezone:z.string(),formatted:z.string()}),Is=z.object({passed:z.boolean(),errorCount:z.number(),warningCount:z.number(),topErrors:z.array(z.string())}),Ls=z.object({passed:z.boolean(),tsc:Is,biome:Is}),Rs=z.object({name:z.string(),definedIn:z.object({path:z.string(),line:z.number(),kind:z.string(),signature:z.string().optional()}).nullable(),importedBy:z.array(z.object({path:z.string(),line:z.number(),importStatement:z.string()})),referencedIn:z.array(z.object({path:z.string(),line:z.number(),context:z.string(),scope:z.string().optional()})),graphContext:z.object({definingModule:z.string().optional(),importedByModules:z.array(z.string()),siblingSymbols:z.array(z.string())}).nullable()}),zs=z.object({sourcePath:z.string(),contentType:z.string(),score:z.number(),headingPath:z.string().optional(),startLine:z.number().optional(),endLine:z.number().optional(),origin:z.string().optional(),category:z.string().optional(),tags:z.array(z.string()).optional()}),Bs=z.object({results:z.array(zs),totalResults:z.number(),searchMode:z.string(),query:z.string(),ref:z.string().optional().describe(`Reusable cache reference for later compact(ref, query)`)}),Vs=z.object({path:z.string(),line:z.number().optional(),matchType:z.string(),preview:z.string()}),Hs=z.object({matches:z.array(Vs),totalMatches:z.number(),pattern:z.string(),truncated:z.boolean(),ref:z.string().optional().describe(`Reusable cache reference for later compact(ref, query)`)}),Us=z.object({path:z.string(),relevance:z.number(),estimatedTokens:z.number(),focusLines:z.array(z.string()).optional()}),Ws=z.object({files:z.array(Us),totalFiles:z.number(),totalEstimatedTokens:z.number(),task:z.string()}),Gs=z.object({path:z.string(),impact:z.string(),reason:z.string()}),Ks=z.object({changedFiles:z.array(z.string()),affectedFiles:z.array(Gs),totalAffected:z.number(),riskLevel:z.string()}),qs=z.object({name:z.string(),passed:z.boolean(),message:z.string().optional(),severity:z.string().optional()}),Js=z.object({passed:z.boolean(),score:z.number(),checks:z.array(qs),summary:z.string()}),Ys=z.object({id:z.string(),name:z.string(),type:z.string(),sourcePath:z.string().optional()}),Xs=z.object({fromId:z.string(),toId:z.string(),type:z.string()}),Zs=z.object({nodes:z.array(Ys),edges:z.array(Xs),totalNodes:z.number(),totalEdges:z.number(),query:z.string()}),Qs=z.object({symbols:z.array(z.object({name:z.string(),path:z.string(),line:z.number().optional(),kind:z.string()})),totalDead:z.number()});z.object({files:z.number(),packages:z.number(),languages:z.record(z.string(),z.number()),tree:z.string()});const $s=z.object({path:z.string(),language:z.string(),lines:z.number(),imports:z.number(),exports:z.number(),functions:z.number(),classes:z.number()}),ec=z.object({gitRoot:z.string(),branch:z.string(),commitCount:z.number(),hasUncommitted:z.boolean(),recentCommits:z.array(z.object({hash:z.string(),message:z.string(),author:z.string(),date:z.string()}))}),tc=z.object({text:z.string().describe(`The compressed text output`),ref:z.string().optional().describe(`Reusable cache reference`),originalChars:z.number(),compressedChars:z.number(),ratio:z.number(),segmentsKept:z.number(),segmentsTotal:z.number()}),nc=z.object({sourceId:z.string(),value:z.string()}),rc=z.object({id:z.string(),originalChars:z.number(),keptChars:z.number(),segmentsKept:z.number(),segmentsTotal:z.number()}),ic=z.object({text:z.string().describe(`The compressed digest text output`),ref:z.string().optional().describe(`Reusable cache reference`),fields:z.record(z.string(),z.array(nc)),sourceStats:z.array(rc),totalOriginalChars:z.number(),totalCompressedChars:z.number(),ratio:z.number()}),ac=z.object({passed:z.boolean(),totalTests:z.number(),passedTests:z.number(),failedTests:z.number(),skippedTests:z.number(),duration:z.number().describe(`Duration in milliseconds`),failures:z.array(z.object({name:z.string(),message:z.string(),file:z.string().optional()}))}),oc=L(`utils:enrich`);async function K(e,t){let n={curated:[],graph:[]},r=t.limit??3,[i,a]=await Promise.allSettled([sc(e,t.query,r),cc(e,t.filePath)]);return i.status===`fulfilled`?n.curated=i.value:oc.debug(`Curated enrichment failed`,{error:i.reason}),a.status===`fulfilled`?n.graph=a.value:oc.debug(`Graph enrichment failed`,{error:a.reason}),n}async function sc(e,t,n){if(!e.store||!t)return[];try{let r=await e.store.ftsSearch(t,{origin:`curated`,limit:n});if(r.length>0)return r.map(e=>lc(e.record));if(e.embedder){let r=await e.embedder.embedQuery(t);return(await e.store.search(r,{origin:`curated`,limit:n,minScore:.3})).map(e=>lc(e.record))}return[]}catch(e){return oc.debug(`Curated enrichment failed`,{error:e}),[]}}async function cc(e,t){if(!e.graphStore||!t)return[];try{let n=await e.graphStore.findNodes({sourcePath:t,limit:1});if(n.length===0){let r=t.split(/[/\\]/).pop()?.replace(/\.\w+$/,``)||``;if(!r)return[];let i=await e.graphStore.findNodes({namePattern:r,type:`module`,limit:1});if(i.length===0)return[];n.push(i[0])}let r=n[0],i=await e.graphStore.getNeighbors(r.id,{direction:`both`,limit:10}),a=[];for(let e of i.edges){let t=e.fromId===r.id?e.toId:e.fromId,n=i.nodes.find(e=>e.id===t);if(!n)continue;let o=e.fromId===r.id?`->`:`<-`;a.push(`${o} ${e.type}: ${n.name} (${n.type})`)}return a}catch(e){return oc.debug(`Graph enrichment failed`,{error:e}),[]}}function q(e){let t=[];if(e.curated.length>0){t.push(`**Curated Knowledge:**`);for(let n of e.curated)t.push(`- ${n}`)}if(e.graph.length>0){t.push(`**Graph Context:**`);for(let n of e.graph)t.push(`- ${n}`)}return t.length===0?``:`\n\n---\n### Enrichment\n${t.join(`
|
|
29
|
-
`)}`}function
|
|
24
|
+
`):JSON.stringify(e)}function Xa(e,t=500){return e.length<=t?e:e.slice(0,t)}function Za(e){let t=e.toLowerCase();return[...Wa].some(e=>t===e||t.includes(e))}function Qa(e){let t=e;for(let e of Ua)t=t.replace(e,`[REDACTED]`);return t.length>Ga&&(t=`${t.slice(0,Ga)}\n...[truncated]`),t}function $a(e,t){let n=t?.args??{},r=[];switch(t?.workspace&&r.push(`workspace=${t.workspace}`),e){case`check`:typeof n.cwd==`string`&&r.push(`cwd=${n.cwd}`),Array.isArray(n.files)&&n.files.length>0&&r.push(`files=${n.files.join(`, `)}`);break;case`test_run`:typeof n.cwd==`string`&&r.push(`cwd=${n.cwd}`),typeof n.grep==`string`&&r.push(`grep=${n.grep}`),Array.isArray(n.files)&&n.files.length>0&&r.push(`files=${n.files.join(`, `)}`);break;case`search`:typeof n.query==`string`&&r.push(`query=${n.query}`);break;case`trace`:typeof n.start==`string`&&r.push(`start=${n.start}`),typeof n.direction==`string`&&r.push(`direction=${n.direction}`);break;default:break}return r.length>0?r.join(` | `):void 0}var eo=class{stateStore;curatedStore;rateLimiter;config;constructor(e,t,n){this.stateStore=e,this.curatedStore=t,this.config={...Ka,...n,captureFrom:n?.captureFrom?[...n.captureFrom]:[...Ha]},this.rateLimiter=new qa(this.config.rateLimit)}getConfig(){return{...this.config,captureFrom:[...this.config.captureFrom]}}updateConfig(e){this.config={...this.config,...e,captureFrom:e.captureFrom?[...e.captureFrom]:[...this.config.captureFrom]},e.rateLimit!==void 0&&this.rateLimiter.setLimit(e.rateLimit)}enable(){this.config.enabled=!0}disable(){this.config.enabled=!1}registerTool(e){this.config.captureFrom.includes(e)||this.config.captureFrom.push(e)}unregisterTool(e){this.config.captureFrom=this.config.captureFrom.filter(t=>t!==e)}async processToolResult(e,t,n){if(!this.config.enabled||Za(e)||!this.config.captureFrom.includes(e)||!this.rateLimiter.canCapture())return null;let r=this.extractObservation(e,t,n);if(!r)return null;let i=Qa(r.content).trim();if(i.length<this.config.minContentLength)return null;let a={...r,content:Xa(i).trim()},o={...a,content:i};this.rateLimiter.record();try{await this.storeObservation(o)}catch(t){Va.warn(`Failed to store observation`,{toolName:e,error:t instanceof Error?t.message:String(t)})}return a}extractObservation(e,t,n){let r=Ya(t);if(r.trim().length===0)return null;switch(e){case`check`:return this.extractFromCheck(t,r,n);case`test_run`:return this.extractFromTestRun(t,r,n);case`search`:return this.extractFromSearch(r,n);case`trace`:return this.extractFromTrace(r,n);default:return null}}extractFromCheck(e,t,n){return Ja(e)&&e.isError===!0||/\berror\b/i.test(t)||/failed/i.test(t)?this.buildObservation(`check`,`error`,t,n):null}extractFromTestRun(e,t,n){let r=Ja(e)&&Ja(e.structuredContent)?e.structuredContent:void 0,i=typeof r?.failedTests==`number`?r.failedTests:void 0;return Ja(e)&&e.isError===!0||typeof i==`number`&&i>0||/\bFAIL\b/.test(t)||/failed/i.test(t)?this.buildObservation(`test_run`,`test_failure`,t,n):null}extractFromSearch(e,t){if(!/\b(convention|pattern)\b/i.test(e))return null;let n=/\bconvention\b/i.test(e)?`convention`:`pattern`;return this.buildObservation(`search`,n,e,t)}extractFromTrace(e,t){return this.buildObservation(`trace`,`insight`,e,t)}buildObservation(e,t,n,r){return{id:ce(),source:e,type:t,content:n,context:$a(e,r),timestamp:new Date().toISOString()}}async storeObservation(e){let t=`Observation ${e.source} ${e.type} ${e.timestamp}`,n=[`Source: ${e.source}`,`Type: ${e.type}`,`Captured: ${e.timestamp}`,e.context?`Context: ${e.context}`:null,``,e.content].filter(e=>e!==null).join(`
|
|
25
|
+
`),r=await this.curatedStore.remember(t,n,`context`,[`observation`,`source-${e.source}`,`type-${e.type}`]);this.stateStore.memoryMetaCreate(r.path,`working`)}};function to(e){let t=[e.cwd,e.workspace,e.root_path,e.path];for(let e of t)if(typeof e==`string`&&e.length>0)return e}function no(e){return async(t,n)=>{let r=await n();try{await e.processToolResult(t.toolName,r,{workspace:to(t.args),args:t.args})}catch(e){Va.warn(`Observation capture failed`,{toolName:t.toolName,requestId:t.requestId,error:e instanceof Error?e.message:String(e)})}return r}}const ro=L(`procedural-memory`),io=`Use when these user-facing tools are run in this order within a single session.`,ao={minSequenceLength:3,minRepetitions:3,maxSequenceLength:10,confidenceIncrement:10,confidenceDecrement:20},oo=new Set([`status`,`guide`,`health`,`onboard`,`reindex`,`replay`,`session_digest`,`process`,`watch`,`produce_knowledge`,`list_tools`,`describe_tool`,`search_tools`]);function so(e){return e.join(`→`)}function co(e){return{...e,steps:[...e.steps]}}function lo(e){return e.every(e=>e.success)}var uo=class{config;history=[];sequences=new Map;procedures=new Map;pendingProcedures=new Map;constructor(e=ao){this.config=e}record(e,t){let n=new Date().toISOString();this.history.push({toolName:e,timestamp:n,success:t}),this.history.length>100&&(this.history=this.history.slice(-100));let r=this.detectSequences(n);this.updateMatchedProcedures(n,r)}getExtractableSequences(){return[...this.sequences.entries()].filter(([,e])=>e.count>=this.config.minRepetitions).map(([e,t])=>({steps:e.split(`→`),count:t.count,lastSeen:t.lastSeen})).sort((e,t)=>t.count===e.count?t.steps.length-e.steps.length:t.count-e.count)}listProcedures(){return[...this.procedures.values()].map(e=>co(e)).sort((e,t)=>t.occurrences===e.occurrences?t.steps.length-e.steps.length:t.occurrences-e.occurrences)}drainNewProcedures(){let e=[...this.pendingProcedures.values()].map(e=>co(e));return this.pendingProcedures.clear(),e}requeueProcedures(e){for(let t of e)this.pendingProcedures.set(so(t.steps),co(t))}extractProcedure(e,t){return{id:ce(),steps:[...e],occurrences:t,confidence:Math.min(50+(t-this.config.minRepetitions)*this.config.confidenceIncrement,100),lastSeen:new Date().toISOString(),conditions:io}}adjustConfidence(e,t){return e.confidence=t?Math.min(100,e.confidence+this.config.confidenceIncrement):Math.max(0,e.confidence-this.config.confidenceDecrement),e.confidence}getHistoryLength(){return this.history.length}clear(){this.history=[],this.sequences.clear(),this.procedures.clear(),this.pendingProcedures.clear()}detectSequences(e){let t=this.history.map(e=>e.toolName),n=Math.min(this.config.maxSequenceLength,t.length),r=new Set,i=Math.max(1,Math.min(2,this.config.minRepetitions));for(let a=this.config.minSequenceLength;a<=n;a+=1){let n=t.slice(-a),o=so(n),s=0;for(let e=0;e<=t.length-a;e+=1)so(t.slice(e,e+a))===o&&(s+=1);if(!(s<i)&&(this.sequences.set(o,{count:s,lastSeen:e}),s>=this.config.minRepetitions&&!this.procedures.has(o))){let t=this.extractProcedure(n,s);t.lastSeen=e,this.procedures.set(o,t),this.pendingProcedures.set(o,co(t)),r.add(o)}}return r}updateMatchedProcedures(e,t){for(let[n,r]of this.procedures.entries()){if(t.has(n))continue;let i=n.split(`→`);if(this.history.length<i.length)continue;let a=this.history.slice(-i.length);so(a.map(e=>e.toolName))===n&&(r.occurrences+=1,r.lastSeen=e,this.adjustConfidence(r,lo(a)))}}};async function fo(e,t,n){let r=await t.remember(`Procedure: ${n.steps.join(` → `)}`,po(n),`patterns`,[`procedure`,`auto-extracted`]);return e.memoryMetaCreate(r.path,`procedural`),r.path}function po(e){return[`## Procedure: ${e.steps.join(` → `)}`,``,`**Confidence:** ${e.confidence}/100`,`**Occurrences:** ${e.occurrences}`,`**Last Seen:** ${e.lastSeen}`,``,`### Steps`,...e.steps.map((e,t)=>`${t+1}. \`${e}\``),``,`### When to Use`,e.conditions??io].join(`
|
|
26
|
+
`)}function mo(e,t,n={}){return async(r,i)=>{if(!ho(r.toolName,n))return i();try{let n=await i();return e.record(r.toolName,n.isError!==!0),await go(e,t,r.toolName),n}catch(n){throw e.record(r.toolName,!1),await go(e,t,r.toolName),n}}}function ho(e,t){return t.trackedTools&&!t.trackedTools.has(e)?!1:!(t.ignoredTools??oo).has(e)}async function go(e,t,n){if(Ee.instance().isDegraded(`embedder`)){ro.debug?.(`Skipping procedural memory persist — embedder degraded`);return}let r=e.drainNewProcedures();if(r.length===0)return;let i=[];for(let e of r)try{await fo(t.stateStore,t.curatedStore,e)}catch(t){let r=t instanceof Error?t.message:String(t),a=/circuit breaker|timed out|worker.*killed|respawn/i.test(r);ro.warn(`Failed to store procedural memory`,{toolName:n,sequence:e.steps.join(` -> `),error:r}),a||i.push(e)}i.length>0&&e.requeueProcedures(i)}const _o=L(`tool-pipeline`);function vo(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function yo(e,t){return e.tools?(Array.isArray(e.tools)?e.tools:[e.tools]).includes(t):!0}function bo(e){return e.middleware.critical===!0}var xo=class{entries=[];use(e,t){this.entries.push({middleware:e,order:t?.order??100,tools:t?.tools,name:t?.name??e.name??`anonymous`})}useFor(e,t,n){this.use(t,{order:n?.order,tools:e,name:n?.name})}wrap(e,t,n,r){let i=this.entries.filter(t=>yo(t,e)).sort((e,t)=>e.order-t.order);return async(a,o)=>{let s={toolName:e,args:vo(a)?a:{},requestId:ce(),meta:r,extra:o,toolConfig:n},c=async n=>{let r=i[n];if(!r)return await t(s.args,o);let a=!1,l=!1,u,d=async()=>{a=!0;let e=await c(n+1);return l=!0,u=e,e};try{return await r.middleware(s,d)}catch(t){if(bo(r))throw t;if(_o.warn(`Middleware failed for tool`,{middleware:r.name,tool:e,error:String(t)}),a){if(l&&u)return u;throw t}return c(n+1)}};return c(0)}}getMiddlewareNames(){return this.entries.map(e=>e.name)}};const So=L(`auto-gc`);let Co=`warming`,wo=null,To=0;function Eo(){let e=[...Bo()];if(e.length<10)return 0;e.sort((e,t)=>e-t);let t=Math.floor(e.length*.95);return e[Math.min(t,e.length-1)]}function Do(e){let t=Eo();if(t===0){Co=`warming`;return}if(t>500){Co=`degraded`;let n=Date.now();if(wo&&n-wo<36e5){So.debug(`GC cooldown active — skipping`,{lastGcAgoMs:n-wo});return}wo=n,To++,So.warn(`p95 latency exceeds threshold, triggering GC`,{p95:t,cycle:To}),e&&e().catch(e=>So.error(`GC callback failed`,{err:String(e)}))}else t<200&&(Co=`healthy`)}function Oo(){return{state:Co,p95:Eo(),lastGcAt:wo,gcCount:To,bufferSize:Bo().length}}const ko=/key|token|secret|auth|password|bearer/i,Ao=new Set([`eval`,`env`]);function jo(e){if(typeof e==`string`)return/^(Bearer |sk-|ghp_|glpat-|ghu_|ghs_|github_pat_)/i.test(e)?`[REDACTED]`:e;if(Array.isArray(e))return e.map(jo);if(e&&typeof e==`object`){let t={};for(let[n,r]of Object.entries(e))/(?:token|secret|password|passphrase|key|auth|credential|api.?key)/i.test(n)?t[n]=`[REDACTED]`:t[n]=jo(r);return t}return e}function Mo(e,t){if(Ao.has(e))return JSON.stringify({_redacted:!0,tool:e});let n=jo(t);if(e===`http`&&n.headers&&typeof n.headers==`object`){let e={};for(let[t,r]of Object.entries(n.headers))e[t]=ko.test(t)?`[REDACTED]`:r;return n.headers=e,JSON.stringify(n).slice(0,2e3)}return JSON.stringify(n).slice(0,2e3)}let No={totalInputChars:0,totalOutputChars:0,callCount:0,startTime:new Date().toISOString()};function Po(e,t){No.totalInputChars+=e,No.totalOutputChars+=t,No.callCount++}function Fo(){return{...No}}const Io=new Map,Lo=[];function Ro(e,t,n,r,i){let a=Io.get(e);a||(a={callCount:0,totalDurationMs:0,totalInputChars:0,totalOutputChars:0,errorCount:0},Io.set(e,a)),a.callCount++,a.totalDurationMs+=t,a.totalInputChars+=n,a.totalOutputChars+=r,i&&a.errorCount++,Lo.push(t),Lo.length>100&&Lo.shift(),Lo.length>=10&&Lo.length%20==0&&Do()}function zo(){return Array.from(Io.entries()).map(([e,t])=>({tool:e,...t}))}function Bo(){return Lo}function Vo(){return async(e,t)=>{let n=Date.now(),r=JSON.stringify(e.args??{}).length;try{let i=await t(),a=Date.now()-n,o=JSON.stringify(i);return nn({ts:new Date().toISOString(),source:`mcp`,tool:e.toolName,input:Mo(e.toolName,e.args),durationMs:a,status:`ok`,output:o,traceId:e.requestId,outputChars:o.length,inputChars:r}),Ro(e.toolName,a,r,o.length,!1),Po(r,o.length),i}catch(t){let i=Date.now()-n,a=t instanceof Error?t.message:String(t);throw nn({ts:new Date().toISOString(),source:`mcp`,tool:e.toolName,input:Mo(e.toolName,e.args),durationMs:i,status:`error`,output:a,traceId:e.requestId,outputChars:0,inputChars:r}),Ro(e.toolName,i,r,0,!0),Po(r,a.length),t}}}function Ho(e,t){e.registerResource(`aikit-curated-index`,`aikit://curated`,{description:`Index of all curated knowledge entries`,mimeType:`text/markdown`},async()=>{let e=await t.listPage({limit:200,orderBy:`updated`,order:`desc`}),n=e.entries,r=n.map(e=>`- [${e.title}](aikit://curated/${e.path}) — ${e.category}`),i=e.hasMore?`\n\n_Showing ${n.length} of ${e.totalCount} entries. Use knowledge list for pagination._`:``;return{contents:[{uri:`aikit://curated`,text:`# Curated Knowledge Index\n\n${r.length>0?r.join(`
|
|
27
|
+
`):`_No curated entries yet._`}${i}`,mimeType:`text/markdown`}]}});let n=new Vn(`aikit://curated/{+path}`,{list:async()=>({resources:(await t.listPage({limit:200,orderBy:`updated`,order:`desc`})).entries.map(e=>({uri:`aikit://curated/${e.path}`,name:e.title,description:`[${e.category}] ${e.contentPreview?.slice(0,80)??``}`,mimeType:`text/markdown`}))})});e.registerResource(`aikit-curated-entry`,n,{description:`A curated knowledge entry`,mimeType:`text/markdown`},async(e,n)=>{let r=n.path;if(!r)throw Error(`Missing path variable in curated resource URI`);let i=await t.read(r);return{contents:[{uri:e.toString(),text:`---\ntitle: ${i.title}\ncategory: ${i.category}\ntags: ${i.tags?.join(`, `)??``}\nversion: ${i.version??1}\n---\n\n${i.content??i.contentPreview??``}`,mimeType:`text/markdown`}]}})}const Uo=`aikit://schemas/channel-surface`,Wo=new URL(`../../../blocks-core/schemas/channel-surface.schema.json`,import.meta.url);let Go;function Ko(){return Go??=Mn(Wo,`utf8`),Go}const qo=[{type:`markdown`,valueShape:`string`,example:`**bold**`},{type:`table`,valueShape:`{headers: string[], rows: string[][]}`,example:`{headers:["Name"], rows:[["Alice"]]}`},{type:`metrics`,valueShape:`{label:string, value:string|number}[]`,example:`[{label:"Pass", value:42}]`},{type:`checklist`,valueShape:`{label:string, checked:boolean}[]`,example:`[{label:"Done", checked:true}]`},{type:`chart`,valueShape:`{chartType, data, xKey, yKeys}`,example:`{chartType:"line", data:[{x:1}], xKey:"x", yKeys:["y"]}`},{type:`code`,valueShape:`string`,example:`const x = 1;`},{type:`heading`,valueShape:`string`,example:`## Section`},{type:`mermaid`,valueShape:`string`,example:`graph TD; A-->B;`},{type:`timeline`,valueShape:`{title, timestamp?, status?}[]`,example:`[{title:"Release", status:"done"}]`},{type:`cards`,valueShape:`{title, body?, status?}[]`,example:`[{title:"Card", body:"Content"}]`},{type:`comparison`,valueShape:`{title, items}[]`,example:`[{title:"Option A", items:["Fast"]}]`},{type:`kv`,valueShape:`Record<string, string>`,example:`{key: "value"}`},{type:`tree`,valueShape:`{name, children?}`,example:`{name:"root", children:[{name:"leaf"}]}`},{type:`status-board`,valueShape:`{category, items}[]`,example:`[{category:"Services", items:[{label:"API", status:"healthy"}]}]`},{type:`progress`,valueShape:`{label, value, max?}`,example:`{label:"Progress", value:75}`},{type:`separator`,valueShape:`none`,example:`separator`}];function Jo(e){let t={schema:JSON.parse(e),blockCatalog:qo,presetCatalog:`aikit://present/presets`,templateCatalog:`aikit://present/templates`};return JSON.stringify(t,null,2)}function Yo(e,t,n){e.registerResource(`aikit-status`,`aikit://status`,{description:`Current AI Kit status and statistics`,mimeType:`text/plain`},async()=>{let e=await t.getStats();return{contents:[{uri:`aikit://status`,text:`AI Kit: ${e.totalRecords} records from ${e.totalFiles} files. Last indexed: ${e.lastIndexedAt??`Never`}`,mimeType:`text/plain`}]}}),e.registerResource(`aikit-file-tree`,`aikit://file-tree`,{description:`List of all indexed source files`,mimeType:`text/plain`},async()=>({contents:[{uri:`aikit://file-tree`,text:(await t.listSourcePaths()).sort().join(`
|
|
28
|
+
`),mimeType:`text/plain`}]})),e.registerResource(`aikit-channel-surface-schema`,Uo,{description:`Composite catalog: ChannelSurface JSON Schema, block types, and resource URIs`,mimeType:`application/json`},async()=>({contents:[{uri:Uo,text:Jo(await Ko()),mimeType:`application/json`}]})),Ho(e,n)}const Xo=[`er_push`,`er_pull`,`er_sync_status`],Zo=[...Xo,`er_update_policy`,`er_evolve_review`],Qo=new Set(Zo);function $o(e){return e.toolProfiles}const es=5e3,ts=L(`structured-content-guard`);function ns(){let e=(async(e,t)=>{let n;try{n=await t()}catch(e){n={content:[{type:`text`,text:`[ERROR:INTERNAL] ${e instanceof Error?e.message:String(e)}`}],isError:!0}}let r=(e.toolConfig??{}).outputSchema;if(r==null)return n;let i=null;if(n.structuredContent==null){let t=rs(r);n.structuredContent=t,i=`synthesize`,n.structuredContent??(n.structuredContent={},i=`synthesize-null-fallback`,ts.error(`synthesizeStructuredContent returned null/undefined — using empty fallback`,{tool:e.toolName}))}let a=is(r,n.structuredContent);if(a.action!=null&&(n.structuredContent=a.structuredContent,i=a.action),os(n.structuredContent)||(n.isError=!0,n.structuredContent={},i=`fallback-error`),as(r,n.structuredContent)===!1){let e=rs(r);n.structuredContent=e??{},as(r,n.structuredContent)===!1?(n.structuredContent=os(n.structuredContent)?n.structuredContent:{},i=`final-validation-failed`):i??=`final-heal`}return n});return e.critical=!0,e}function rs(e){try{return ss(e)??{}}catch{return{}}}function is(e,t){if(as(e,t)!==!1)return{structuredContent:t,action:null};try{let n=rs(e);if(os(n)&&os(t)){let r={...n,...t};if(as(e,r)!==!1)return{structuredContent:r,action:`heal`}}return{structuredContent:n,action:`fallback-zero-value`}}catch{return{structuredContent:t,action:null}}}function as(e,t){let n=e.safeParse;if(typeof n==`function`)try{return n(t).success}catch{return}}function os(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function ss(e){if(!e)return{};if(e.anyOf){let t=e.anyOf.find(e=>e.type!==`null`);return t?ss(t):null}let t=e._def?.typeName;if(t&&!e.type)switch(t){case`ZodObject`:{let t={},n=null;try{n=e.shape??(typeof e._def?.shape==`function`?e._def.shape():e._def?.shape)}catch{n=null}if(n)for(let[e,r]of Object.entries(n))try{t[e]=ss(r)}catch{t[e]=null}return t}case`ZodArray`:return[];case`ZodString`:return``;case`ZodNumber`:return 0;case`ZodBoolean`:return!1;case`ZodNullable`:return null;case`ZodOptional`:return;case`ZodRecord`:return{};case`ZodEnum`:return e._def?.values?.[0]??``;default:return{}}switch(e.type){case`object`:{let t={},n=e.properties??e.shape;if(n)for(let[e,r]of Object.entries(n))t[e]=ss(r);return t}case`array`:return[];case`string`:return``;case`number`:case`integer`:return 0;case`boolean`:return!1;case`nullable`:return null;case`optional`:return;case`record`:return{};case`enum`:return e.options?.[0]??Object.values(e.enum??e._def?.entries??{})[0]??``;default:return{}}}function cs(e){if(!e)return{};try{let t=ss(e);return os(t)?t:{}}catch{return{}}}const ls=Symbol(`toolPipelineState`);function us(e){return e[ls]}function ds(e,t){e[ls]=t}function fs(e,t){return t?async(...n)=>{let r=await e(...n);if(!r||typeof r!=`object`)return r;let i=r;return!(`content`in i)||i.structuredContent!=null&&typeof i.structuredContent==`object`?r:(i.structuredContent=cs(t),i.structuredContent??={},r)}:e}function ps(e,t,n=``){let r=us(e);if(r){r.pipeline=t,r.prefix=n;return}ds(e,{originalRegisterTool:e.registerTool.bind(e),pipeline:t,prefix:n}),e.registerTool=(n,r,i)=>{let a=us(e),o=a?.prefix?`${a.prefix}${n}`:n;if(!i)return a?.originalRegisterTool(o,r);let s=r?.outputSchema;if((a?.pipeline??t).getMiddlewareNames().length===0){let e=fs(i,s);return a?.originalRegisterTool(o,r,e)}let c=K(n),l=fs((a?.pipeline??t).wrap(n,i,r,c),s);return a?.originalRegisterTool(o,r,l)}}const ms={analyze:1,audit:1,blast_radius:1,changelog:1,check:2,checkpoint:2,codemod:2,compact:1,config:0,data_transform:1,dead_symbols:1,delegate:3,describe_tool:1,diff_parse:1,digest:1,encode:1,env:0,eval:2,evidence_map:2,file_summary:1,find:1,flow:3,forge_classify:1,forge_ground:2,git_context:1,graph:1,guide:0,health:0,http:1,lane:2,list_tools:1,lookup:1,measure:1,onboard:3,parse_output:1,present:1,process:3,produce_knowledge:3,queue:3,regex_test:1,reindex:3,rename:2,replay:1,restore:2,schema_validate:1,scope_map:1,search:1,search_tools:1,signal:2,session_digest:2,stash:2,status:0,stratum_card:1,symbol:1,test_run:2,time:0,trace:1,watch:3,web_fetch:1,web_search:1,workset:2};function hs(e,t){return e.filter(e=>(ms[e]??0)<=t)}const gs=new Set([`status`,`config`,`guide`,`health`]),_s={full:{description:`All tools enabled (default)`,includeCategories:[]},safe:{description:`Read-only tools — no file/state modifications`,includeCategories:[`search`,`analysis`,`compression`,`utilities`,`system`,`git`,`flow`],excludeTools:[`reindex`,`onboard`]},research:{description:`Search, analysis, knowledge, and web access`,includeCategories:[`search`,`analysis`,`knowledge`,`compression`,`web`,`system`,`flow`]},minimal:{description:`Essential tools only — search, status, basic operations`,includeCategories:[`search`,`system`],includeTools:[`compact`,`file_summary`,`check`,`test_run`]},discovery:{description:`Full toolset plus discovery-oriented meta-tools for guided tool exploration`,includeCategories:[],includeTools:[`list_tools`,`describe_tool`,`search_tools`]}};function vs(e,t){let n=_s[e];if(n)return n;let r=t?.[e];if(r)return r;throw Error(`Unknown tool profile: ${e}`)}function ys(e,t,n){return t.includes(`*`)?!0:(n[e]?.category??[]).some(e=>t.includes(e))}function bs(e,t,n,r){if(t.includes(`*`)){for(let t of n)e.add(t);return}for(let i of n)ys(i,t,r)&&e.add(i)}function xs(e,t,n){if(t.includes(`*`)){e.clear();return}for(let r of[...e])ys(r,t,n)&&e.delete(r)}function Ss(e,t,n){if(!e||e.length===0||e.includes(`*`))return new Set(t);let r=new Set;return bs(r,e,t,n),r}function Cs(e,t){return e===void 0?t:t===void 0?e:Math.min(e,t)}function ws(e,t){for(let n of[...e])t[n]?.annotations?.readOnlyHint===!1&&e.delete(n)}function Ts(e,t,n=0,r=[]){if(n>10)throw Error(`Tool profile inheritance exceeded max depth 10: ${[...r,e].join(` -> `)}`);if(r.includes(e))throw Error(`Tool profile inheritance cycle detected: ${[...r,e].join(` -> `)}`);let i=vs(e,t);return Cs(i.extends?Ts(i.extends,t,n+1,[...r,e]):void 0,i.maxTier)}function Es(e,t,n,r){let i=(e,a,o)=>{if(a>10)throw Error(`Tool profile inheritance exceeded max depth 10: ${[...o,e].join(` -> `)}`);if(o.includes(e))throw Error(`Tool profile inheritance cycle detected: ${[...o,e].join(` -> `)}`);let s=vs(e,r),c=[...o,e],l=s.extends?i(s.extends,a+1,c):Ss(s.includeCategories,t,n);s.extends&&s.includeCategories?.length&&bs(l,s.includeCategories,t,n),s.excludeCategories?.length&&xs(l,s.excludeCategories,n);for(let e of s.includeTools??[])l.add(e);for(let e of s.excludeTools??[])l.delete(e);return l},a=i(e,0,[]),o=Ts(e,r);if(o!==void 0){let e=hs([...a],o);a.clear();for(let t of e)a.add(t)}for(let e of gs)a.add(e);return e===`safe`&&ws(a,n),a}const Ds=new Set([`search`,`analysis`,`knowledge`,`compression`,`forge`,`presentation`,`execution`,`manipulation`,`session`,`git`,`process`,`system`,`meta`,`utilities`,`web`,`queue`,`flow`]);function Os(e,t,n,r){let i=process.env.AIKIT_TOOLSET||e.toolProfile||`full`,a=Es(i,t,n,r);if(e.features&&e.features.length>0){let i=e.features.filter(e=>!Ds.has(e));if(i.length>0)throw Error(`Unknown feature group(s): ${i.join(`, `)}. Valid categories: ${[...Ds].join(`, `)}`);let o={description:`Synthetic profile from features config`,includeCategories:e.features},s=Es(`_features`,t,n,{...r,_features:o});for(let e of a)!s.has(e)&&!gs.has(e)&&a.delete(e)}if(e.readOnly)for(let e of[...a])n[e]?.annotations?.readOnlyHint===!1&&!gs.has(e)&&a.delete(e);for(let e of gs)a.add(e);return i===`safe`&&ws(a,n),a}const ks=B.object({mode:B.enum([`wasm`,`regex`,`unknown`]),reason:B.string(),pathsChecked:B.array(B.object({path:B.string(),exists:B.boolean()})),os:B.string(),arch:B.string(),nodeVersion:B.string(),webTreeSitterImportable:B.boolean(),healAttempted:B.boolean(),healSuccess:B.boolean(),healError:B.string().nullable(),initError:B.string().nullable(),wasmDir:B.string().nullable(),grammarCount:B.number()}),As=B.object({kind:B.enum([`onboard`,`reindex`,`handoff`,`proceed`]),reason:B.string()}),js=B.object({title:B.string(),insight:B.string(),confidence:B.number()}),Ms=B.object({lessons:B.array(js),conventions:B.array(B.object({title:B.string(),preview:B.string()})),checkpoint:B.string().nullable()});B.object({totalRecords:B.number(),totalFiles:B.number(),lastIndexedAt:B.string().nullable(),onboarded:B.boolean(),onboardDir:B.string(),contentTypes:B.record(B.string(),B.number()),wasmAvailable:B.boolean(),wasmDiagnostics:ks,graphStats:B.object({nodes:B.number(),edges:B.number()}).nullable(),curatedCount:B.number(),serverVersion:B.string(),scaffoldVersion:B.string().nullable(),workspaceScaffoldVersion:B.string().nullable(),upgradeAvailable:B.boolean(),sessionTokens:B.object({callCount:B.number(),totalInputChars:B.number(),totalOutputChars:B.number(),estInputTokens:B.number(),estTotalTokens:B.number(),startTime:B.string()}).optional(),storeBackend:B.string().optional(),storeDiagnostics:B.object({adapterType:B.string(),vectorSearchEnabled:B.boolean(),ftsEnabled:B.boolean(),degradedMode:B.boolean(),dbPath:B.string(),dbSizeBytes:B.number().nullable(),embeddingDim:B.number(),vectorDtype:B.string()}).nullable().optional(),contextPressure:B.number().min(0).max(100).describe(`0–100 score indicating AI Kit saturation`),nextAction:As,prelude:Ms.nullable().optional()}).catchall(B.any()),B.object({entries:B.array(B.object({path:B.string(),title:B.string(),category:B.string(),tags:B.array(B.string()),version:B.number(),preview:B.string()})),totalCount:B.number()});const Ns=B.object({ok:B.boolean(),checks:B.array(B.object({name:B.string(),ok:B.boolean(),message:B.string().optional()}))}),Ps=B.object({summary:B.object({totalFiles:B.number(),totalLines:B.number(),totalCodeLines:B.number(),totalFunctions:B.number(),avgComplexity:B.number(),maxComplexity:B.object({value:B.number(),file:B.string()})}),files:B.array(B.object({path:B.string(),lines:B.number(),code:B.number(),complexity:B.number(),functions:B.number()}))}),Fs=B.object({platform:B.string(),arch:B.string(),nodeVersion:B.string(),cwd:B.string(),cpus:B.number(),memoryFreeGb:B.number(),memoryTotalGb:B.number()}),Is=B.object({iso:B.string(),unix:B.number(),timezone:B.string(),formatted:B.string()}),Ls=B.object({passed:B.boolean(),errorCount:B.number(),warningCount:B.number(),topErrors:B.array(B.string())}),Rs=B.object({passed:B.boolean(),tsc:Ls,biome:Ls}),zs=B.object({name:B.string(),definedIn:B.object({path:B.string(),line:B.number(),kind:B.string(),signature:B.string().optional()}).nullable(),importedBy:B.array(B.object({path:B.string(),line:B.number(),importStatement:B.string()})),referencedIn:B.array(B.object({path:B.string(),line:B.number(),context:B.string(),scope:B.string().optional()})),graphContext:B.object({definingModule:B.string().optional(),importedByModules:B.array(B.string()),siblingSymbols:B.array(B.string())}).nullable()}),Bs=B.object({sourcePath:B.string(),contentType:B.string(),score:B.number(),headingPath:B.string().optional(),startLine:B.number().optional(),endLine:B.number().optional(),origin:B.string().optional(),category:B.string().optional(),tags:B.array(B.string()).optional()}),Vs=B.object({results:B.array(Bs),totalResults:B.number(),searchMode:B.string(),query:B.string(),ref:B.string().optional().describe(`Reusable cache reference for later compact(ref, query)`)}),Hs=B.object({path:B.string(),line:B.number().optional(),matchType:B.string(),preview:B.string()}),Us=B.object({matches:B.array(Hs),totalMatches:B.number(),pattern:B.string(),truncated:B.boolean(),ref:B.string().optional().describe(`Reusable cache reference for later compact(ref, query)`)}),Ws=B.object({path:B.string(),relevance:B.number(),estimatedTokens:B.number(),focusLines:B.array(B.string()).optional()}),Gs=B.object({files:B.array(Ws),totalFiles:B.number(),totalEstimatedTokens:B.number(),task:B.string()}),Ks=B.object({path:B.string(),impact:B.string(),reason:B.string()}),qs=B.object({changedFiles:B.array(B.string()),affectedFiles:B.array(Ks),totalAffected:B.number(),riskLevel:B.string()}),Js=B.object({name:B.string(),passed:B.boolean(),message:B.string().optional(),severity:B.string().optional()}),Ys=B.object({passed:B.boolean(),score:B.number(),checks:B.array(Js),summary:B.string()}),Xs=B.object({id:B.string(),name:B.string(),type:B.string(),sourcePath:B.string().optional()}),Zs=B.object({fromId:B.string(),toId:B.string(),type:B.string()}),Qs=B.object({nodes:B.array(Xs),edges:B.array(Zs),totalNodes:B.number(),totalEdges:B.number(),query:B.string()}),$s=B.object({symbols:B.array(B.object({name:B.string(),path:B.string(),line:B.number().optional(),kind:B.string()})),totalDead:B.number()});B.object({files:B.number(),packages:B.number(),languages:B.record(B.string(),B.number()),tree:B.string()});const ec=B.object({path:B.string(),language:B.string(),lines:B.number(),imports:B.number(),exports:B.number(),functions:B.number(),classes:B.number()}),tc=B.object({gitRoot:B.string(),branch:B.string(),commitCount:B.number(),hasUncommitted:B.boolean(),recentCommits:B.array(B.object({hash:B.string(),message:B.string(),author:B.string(),date:B.string()}))}),nc=B.object({text:B.string().describe(`The compressed text output`),ref:B.string().optional().describe(`Reusable cache reference`),originalChars:B.number(),compressedChars:B.number(),ratio:B.number(),segmentsKept:B.number(),segmentsTotal:B.number()}),rc=B.object({sourceId:B.string(),value:B.string()}),ic=B.object({id:B.string(),originalChars:B.number(),keptChars:B.number(),segmentsKept:B.number(),segmentsTotal:B.number()}),ac=B.object({text:B.string().describe(`The compressed digest text output`),ref:B.string().optional().describe(`Reusable cache reference`),fields:B.record(B.string(),B.array(rc)),sourceStats:B.array(ic),totalOriginalChars:B.number(),totalCompressedChars:B.number(),ratio:B.number()}),oc=B.object({passed:B.boolean(),totalTests:B.number(),passedTests:B.number(),failedTests:B.number(),skippedTests:B.number(),duration:B.number().describe(`Duration in milliseconds`),failures:B.array(B.object({name:B.string(),message:B.string(),file:B.string().optional()}))}),sc=L(`utils:enrich`);async function q(e,t){let n={curated:[],graph:[]},r=t.limit??3,[i,a]=await Promise.allSettled([cc(e,t.query,r),lc(e,t.filePath)]);return i.status===`fulfilled`?n.curated=i.value:sc.debug(`Curated enrichment failed`,{error:i.reason}),a.status===`fulfilled`?n.graph=a.value:sc.debug(`Graph enrichment failed`,{error:a.reason}),n}async function cc(e,t,n){if(!e.store||!t)return[];try{let r=await e.store.ftsSearch(t,{origin:`curated`,limit:n});if(r.length>0)return r.map(e=>uc(e.record));if(e.embedder){let r=await e.embedder.embedQuery(t);return(await e.store.search(r,{origin:`curated`,limit:n,minScore:.3})).map(e=>uc(e.record))}return[]}catch(e){return sc.debug(`Curated enrichment failed`,{error:e}),[]}}async function lc(e,t){if(!e.graphStore||!t)return[];try{let n=await e.graphStore.findNodes({sourcePath:t,limit:1});if(n.length===0){let r=t.split(/[/\\]/).pop()?.replace(/\.\w+$/,``)||``;if(!r)return[];let i=await e.graphStore.findNodes({namePattern:r,type:`module`,limit:1});if(i.length===0)return[];n.push(i[0])}let r=n[0],i=await e.graphStore.getNeighbors(r.id,{direction:`both`,limit:10}),a=[];for(let e of i.edges){let t=e.fromId===r.id?e.toId:e.fromId,n=i.nodes.find(e=>e.id===t);if(!n)continue;let o=e.fromId===r.id?`->`:`<-`;a.push(`${o} ${e.type}: ${n.name} (${n.type})`)}return a}catch(e){return sc.debug(`Graph enrichment failed`,{error:e}),[]}}function J(e){let t=[];if(e.curated.length>0){t.push(`**Curated Knowledge:**`);for(let n of e.curated)t.push(`- ${n}`)}if(e.graph.length>0){t.push(`**Graph Context:**`);for(let n of e.graph)t.push(`- ${n}`)}return t.length===0?``:`\n\n---\n### Enrichment\n${t.join(`
|
|
29
|
+
`)}`}function uc(e){let t=dc(e.metadata,`title`)||e.sourcePath||`Untitled`;return`[${dc(e.metadata,`category`)}] ${t}: ${e.content.slice(0,200)}`}function dc(e,t){let n=e?.[t];return typeof n==`string`?n:``}function Y(e,t,n){return{content:[{type:`text`,text:`[ERROR:${e}] ${t}`}],isError:!0,...n==null?{}:{structuredContent:n}}}function X(e,t){return async(n,r)=>{let i=Date.now(),a=await t(n,r),o=Date.now()-i;return a._meta={...a._meta??{},durationMs:o,toolName:e},a}}const fc=L(`tools`),pc=B.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`);function mc(e,t){return t?z(e,t):e}function hc(){let e=[];return ir.get()||e.push(`Tree-sitter unavailable — using regex fallback, symbol/pattern confidence reduced`),e.length===0?``:`\n\n> **⚠ Caveats:** ${e.join(`; `)}`}function gc(e){return(e??[]).map(e=>{if(typeof e==`string`)return e;if(e&&typeof e==`object`&&`path`in e)return typeof e.path==`string`?e.path:void 0}).filter(e=>!!e)}function _c(e){let t=[],n=e.filter(e=>/\.(ts|tsx|js|jsx)$/.test(e)&&/(service|store|model|schema|migration)/i.test(e)),r=e.filter(e=>/\.(ts|tsx|js|jsx)$/.test(e)&&!n.includes(e)),i=e.filter(e=>!/\.(ts|tsx|js|jsx)$/.test(e));return(n.length>0||r.length>0||i.length>0)&&(t.push(`
|
|
30
30
|
|
|
31
31
|
### Risk Assessment`),n.length>0&&t.push(`- 🔴 **High risk** (${n.length}): ${n.slice(0,5).map(e=>`\`${e}\``).join(`, `)}`),r.length>0&&t.push(`- 🟡 **Medium risk** (${r.length}): source files`),i.length>0&&t.push(`- 🟢 **Low risk** (${i.length}): non-source files`)),t.join(`
|
|
32
|
-
`)}function
|
|
32
|
+
`)}function vc(e){let t=e.replace(/\\/g,`/`);return/(^|\/)__tests__\/|\.(test|spec)\.[jt]sx?$/i.test(t)?`Tests`:/(controller|route|handler|api)/i.test(t)?`API`:/(service|store|model|schema|migration|repo|repository|db|database)/i.test(t)?`Core/Data`:/\.(ts|tsx|js|jsx)$/.test(t)?`Source`:`Config/Docs`}function yc(e){if(e.length===0)return``;let t=[`Core/Data`,`API`,`Source`,`Tests`,`Config/Docs`],n=new Map;for(let t of e){let e=vc(t),r=n.get(e)??[];r.push(t),n.set(e,r)}let r=[`
|
|
33
33
|
|
|
34
34
|
### Layer Classification`];for(let e of t){let t=n.get(e);if(!t?.length)continue;let i=t.slice(0,5).map(e=>`\`${e}\``).join(`, `),a=t.length>5?`, ... and ${t.length-5} more`:``;r.push(`- **${e}** (${t.length}): ${i}${a}`)}return r.join(`
|
|
35
|
-
`)}async function
|
|
36
|
-
`),p.length>20&&(m+=`\n- ... and ${p.length-20} more`))}catch{}let h=
|
|
35
|
+
`)}async function bc(e,t){if(!e||t.length===0)return[];let n=new Set;for(let r of t){let i=await e.findNodes({sourcePath:r,limit:10});for(let r of i){let i=await e.getNeighbors(r.id,{direction:`incoming`,edgeType:`imports`});for(let e of i.nodes){let r=e.sourcePath??e.name;t.includes(r)||n.add(r)}}}return[...n]}async function xc(e,t,n,r,i){try{let a=`produced/analysis/${n}/${A(`sha256`).update(r).digest(`hex`).slice(0,12)}.md`,o=A(`sha256`).update(i).digest(`hex`).slice(0,16),s=new Date().toISOString(),c=i.length>2e3?i.split(/(?=^## )/m).filter(e=>e.trim().length>0):[i],l=c.map((e,t)=>({id:A(`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:[`analysis`,n],category:`analysis`,version:1})),u=await t.embedBatch(l.map(e=>e.content));await e.upsert(l,u),fc.info(`Auto-persisted analysis`,{analyzerName:n,chunkCount:l.length})}catch(e){fc.warn(`Auto-persist analysis failed`,{analyzerName:n,...R(e)})}}const Sc=B.enum([`structure`,`dependencies`,`symbols`,`patterns`,`entry_points`,`diagram`]),Cc=B.string().describe(`Root path to analyze`),wc=B.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.`),Tc=B.object({path:Cc,max_depth:B.number().min(1).max(10).default(6).describe(`Maximum directory depth`),format:B.enum([`json`,`markdown`]).default(`markdown`).describe(`Output format`),max_tokens:pc,enrich:wc}),Ec=B.object({path:Cc,format:B.enum([`json`,`markdown`,`mermaid`]).default(`markdown`).describe(`Output format`),max_tokens:pc,enrich:wc}),Dc=B.object({path:Cc,filter:B.string().optional().describe(`Filter symbols by name substring`),format:B.enum([`json`,`markdown`]).default(`markdown`).describe(`Output format`),enrich:wc}),Oc=B.object({path:Cc,enrich:wc}),kc=B.object({path:Cc,enrich:wc}),Ac=B.object({path:Cc,diagram_type:B.enum([`architecture`,`dependencies`]).default(`architecture`).describe(`Type of diagram`),enrich:wc}),jc=B.object({aspect:Sc.describe(`Analysis aspect to execute`),path:Cc,max_depth:B.number().min(1).max(10).optional(),format:B.enum([`json`,`markdown`,`mermaid`]).optional(),max_tokens:pc,filter:B.string().optional().describe(`Filter symbols by name substring`),diagram_type:B.enum([`architecture`,`dependencies`]).optional().describe(`Type of diagram when aspect="diagram"`),enrich:wc});async function Mc(e,t,n,r){return!n||!r?e:e+J(await q(r,{query:t,filePath:t}))}async function Nc(e,{store:t,embedder:n,enrichDeps:r}){let i=new tr,{path:a,max_depth:o,format:s,max_tokens:c,enrich:l}=Tc.parse(e),u=await i.analyze(a,{format:s,maxDepth:o,maxTokens:c});xc(t,n,`structure`,a,u.output);let d=u.data;return{content:[{type:`text`,text:mc(await Mc(u.output+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "dependencies", ... })` for import graphs, or `analyze({ aspect: "patterns", ... })` to detect architecture patterns._',a,l,r),c)}],structuredContent:{files:d.fileCount??u.meta.fileCount,packages:d.packageCount??0,languages:d.languages??{},tree:u.output.slice(0,2e3)}}}async function Pc(e,{store:t,embedder:n,enrichDeps:r}){let i=new Xn,{path:a,format:o,max_tokens:s,enrich:c}=Ec.parse(e),l=await i.analyze(a,{format:o});return xc(t,n,`dependencies`,a,l.output),{content:[{type:`text`,text:mc(await Mc(l.output+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "symbols", ... })` to explore exported symbols, or `analyze({ aspect: "diagram", ... })` for visual representation._',a,c,r),s)}]}}async function Fc(e,{store:t,embedder:n,enrichDeps:r}){let i=new nr,{path:a,filter:o,format:s,enrich:c}=Dc.parse(e),l=await i.analyze(a,{format:s,filter:o});return xc(t,n,`symbols`,a,l.output),{content:[{type:`text`,text:await Mc(l.output+hc()+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "dependencies", ... })` to see import relationships, or `search` to find usage patterns._',a,c,r)}]}}async function Ic(e,{store:t,embedder:n,enrichDeps:r}){let i=new er,{path:a,enrich:o}=Oc.parse(e),s=await i.analyze(a);return xc(t,n,`patterns`,a,s.output),{content:[{type:`text`,text:await Mc(s.output+hc()+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "entry_points", ... })` to find Lambda handlers and main exports, or `produce_knowledge` for full analysis._',a,o,r)}]}}async function Lc(e,{store:t,embedder:n,enrichDeps:r}){let i=new Qn,{path:a,enrich:o}=kc.parse(e),s=await i.analyze(a);return xc(t,n,`entry-points`,a,s.output),{content:[{type:`text`,text:await Mc(s.output+hc()+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "dependencies", ... })` to see what each entry point imports, or `produce_knowledge` for comprehensive analysis._',a,o,r)}]}}async function Rc(e,{store:t,embedder:n,enrichDeps:r}){let i=new Zn,{path:a,diagram_type:o,enrich:s}=Ac.parse(e),c=await i.analyze(a,{diagramType:o});return xc(t,n,`diagram`,a,c.output),{content:[{type:`text`,text:await Mc(c.output+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "structure", ... })` for detailed file tree, or `produce_knowledge` for comprehensive analysis._',a,s,r)}]}}async function zc(e,t,n){switch(e){case`structure`:return Nc(t,n);case`dependencies`:return Pc(t,n);case`symbols`:return Fc(t,n);case`patterns`:return Ic(t,n);case`entry_points`:return Lc(t,n);case`diagram`:return Rc(t,n)}}function Bc(e,t,n,r){let i=K(`analyze`);e.registerTool(`analyze`,{title:i.title,description:"Analyze a codebase using one of the supported aspects. Set `aspect` to structure, dependencies, symbols, patterns, entry_points, or diagram.",inputSchema:jc.shape,annotations:i.annotations},X(`analyze`,async e=>{try{let i=jc.parse(e);return await zc(i.aspect,i,{store:t,embedder:n,enrichDeps:r})}catch(e){return fc.error(`Analysis failed`,R(e)),Y(`INTERNAL`,`Analysis failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Vc(e,t,n,r,i){let a=new Yn,o=K(`blast_radius`);e.registerTool(`blast_radius`,{title:o.title,description:`Given a list of changed files, trace the dependency graph to find all affected files (direct + transitive importers) and their tests. Useful for scoping code reviews and impact analysis.`,outputSchema:qs,inputSchema:{path:B.string().describe(`Root path of the codebase`),files:B.array(B.string()).optional().describe(`Changed file paths (relative to root). If omitted, auto-detects from git status.`),max_depth:B.number().min(1).max(20).default(5).describe(`Maximum transitive dependency depth`),format:B.enum([`json`,`markdown`]).default(`markdown`).describe(`Output format`),max_tokens:pc,enrich:B.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},X(`blast_radius`,async({path:e,files:o,max_depth:s,format:c,max_tokens:l,enrich:u})=>{try{let d=o??[];if(d.length===0)try{let t=await yt({cwd:e,includeDiff:!1});if(d=Array.from(new Set([...gc(t.status?.staged),...gc(t.status?.modified),...gc(t.status?.untracked)])),d.length===0)return{content:[{type:`text`,text:"No changed files detected from git status. Provide `files` explicitly or make changes first."}]}}catch{return Y(`VALIDATION`,"Could not detect changed files from git. Provide `files` explicitly.")}let f=await a.analyze(e,{files:d,maxDepth:s,format:c}),p=[],m=``;if(r)try{p=await bc(r,d),p.length>0&&(m=`\n\n### Graph-discovered importers (${p.length})\n`+p.slice(0,20).map(e=>`- \`${e}\``).join(`
|
|
36
|
+
`),p.length>20&&(m+=`\n- ... and ${p.length-20} more`))}catch{}let h=yc(d),g=_c(d),_=f.output+m+h+g+hc()+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "dependencies", ... })` to see the full import graph, or `analyze({ aspect: "symbols", ... })` to inspect affected exports._';if(u&&i){let t=await q(i,{query:e,filePath:e});_+=J(t)}xc(t,n,`blast-radius`,e,_);let v=p.map(e=>({path:e,impact:`transitive`,reason:`imports changed file`})),y=d.length>10?`high`:d.length>3?`medium`:`low`;return{content:[{type:`text`,text:mc(_,l)}],structuredContent:{changedFiles:d,affectedFiles:v,totalAffected:v.length,riskLevel:y}}}catch(e){return fc.error(`Blast radius analysis failed`,R(e)),Y(`INTERNAL`,`Blast radius analysis failed: ${e instanceof Error?e.message:String(e)}`)}}))}const Hc=L(`task-manager`);let Uc=0;function Wc(e){let t=typeof e?.sendNotification==`function`;return{createTask(n,r){let i=`aikit-task-${++Uc}`,a=(n,r,a)=>{t&&e.sendNotification?.({method:`notifications/progress`,params:{progressToken:i,progress:n,total:r,...a?{message:a}:{}}}).catch(e=>{Hc.debug(`Progress notification failed`,{token:i,error:String(e)})})};return t&&Hc.debug(`Task created`,{token:i,title:n,totalSteps:r}),{progress(e,t){a(e,r,t??`${n}: step ${e+1}/${r}`)},complete(e){a(r,r,e??`${n}: complete`)},fail(e){a(r,r,e??`${n}: failed`)}}}}}const Gc=L(`tools`);function Kc(e,t,n,r){let i=K(`audit`);e.registerTool(`audit`,{title:i.title,description:`Run a unified audit: structure, dependencies, patterns, health, dead_symbols, check, entry_points. Returns synthesized report with score, recommendations, and next steps. 6 round-trips → 1.`,outputSchema:Ys,inputSchema:{path:B.string().default(`.`).describe(`Root path to audit`),checks:B.array(B.enum([`structure`,`dependencies`,`patterns`,`health`,`dead_symbols`,`check`,`entry_points`])).optional().describe(`Which checks to run (default: all)`),detail:B.enum(ke).optional().describe(`'efficient' for overview (~500 tokens), 'full' includes pattern table`)},annotations:i.annotations},async({path:e,checks:i,detail:a},o)=>{try{let s=await ze(t,n,{path:e,checks:i,detail:a??r??`efficient`});return Wc(o).createTask(`Audit`,1).complete(`Audit complete: ${s.data?.recommendations?.length??0} recommendations`),{content:[{type:`text`,text:s.ok?`${s.summary}\n\n---\n_Audit score: ${s.data?.score}/100 | ${s.meta.durationMs}ms${s.next&&s.next.length>0?` | Next: ${s.next.map(e=>`\`${e.tool}\` (${e.reason})`).join(`, `)}`:``}_`:s.error?.message??`Audit failed`}],isError:!s.ok,...s.ok&&s.data?{structuredContent:{passed:s.ok,score:s.data.score??0,checks:(s.data.recommendations??[]).map(e=>({name:e.area,passed:e.priority!==`high`,message:e.message,severity:e.priority})),summary:s.summary??``}}:{}}}catch(e){return Gc.error(`Audit failed`,R(e)),Y(`INTERNAL`,`Audit failed: ${e instanceof Error?e.message:String(e)}`)}})}const qc=L(`tools`);function Jc(e){if(!e?.enabled)return;let t=process.env.AIKIT_ER_API_KEY;if(!t){qc.warn(`ER bridge enabled but AIKIT_ER_API_KEY not set; disabling`);return}return{enabled:!0,baseUrl:e.baseUrl,apiKey:t,timeoutMs:e.timeoutMs??5e3,cacheTtlMs:e.cacheTtlMs??360*60*1e3,cacheMaxEntries:e.cacheMaxEntries??100,fallbackThreshold:e.fallbackThreshold??.45}}function Yc(e){let t=Jc(e);if(t)try{let e=new sr(t),n=new or({maxEntries:t.cacheMaxEntries,defaultTtl:t.cacheTtlMs}),r=new ur(e);try{let e=new URL(t.baseUrl).hostname;qc.info(`ER bridge initialized`,{host:e})}catch{qc.info(`ER bridge initialized`)}return{client:e,cache:n,pushAdapter:r,config:t}}catch(e){qc.warn(`ER bridge initialization failed`,R(e));return}}function Xc(e,t,n){let r=K(`er_push`);e.registerTool(`er_push`,{title:r.title,description:`Push a curated knowledge entry to Enterprise RAG. The entry is stored via ER's curated_remember tool and becomes immediately searchable in the enterprise AI Kit.`,inputSchema:{title:B.string().min(3).max(120).describe(`Title for the knowledge entry`),content:B.string().min(10).max(1e5).describe(`Markdown content to push (max 100KB)`),category:B.string().regex(/^[a-z][a-z0-9-]*$/).default(`conventions`).describe(`Category slug (e.g., "decisions", "patterns", "conventions")`),tags:B.array(B.string()).default([]).describe(`Optional tags`),rule_id:B.string().optional().describe(`ID of the classification rule that motivated this push (from remember classification signals). Improves rule effectiveness tracking.`)},annotations:r.annotations},X(`er_push`,async({title:e,content:r,category:i,tags:a,rule_id:o})=>{try{let s=`${i}/${e.toLowerCase().replace(/[^a-z0-9]+/g,`-`)}`,c=await t.pushAdapter.push(s,{title:e,content:r,category:i,tags:a});return c.pushed?(n&&n.recordPush(s,c.pushed,o),{content:[{type:`text`,text:`Pushed to ER: **${e}**\n\nRemote path: \`${c.remotePath??`unknown`}\`\nTimestamp: ${c.timestamp}\n\n---\n_Next: Use \`er_pull\` to verify the entry is searchable in ER, or \`er_sync_status\` to see push history._`}]}):(n&&n.recordPush(s,!1,o),Y(`INTERNAL`,`ER push failed: ${c.error??`Unknown error`}\n\n_The local AI Kit is unaffected. You can retry or check ER health with \`er_sync_status\`._`))}catch(t){if(qc.error(`ER push failed`,R(t)),n){let t=`${i}/${e.toLowerCase().replace(/[^a-z0-9]+/g,`-`)}`;n.recordPush(t,!1,o)}return Y(`INTERNAL`,`ER push failed: operation unsuccessful
|
|
37
37
|
|
|
38
|
-
_The local AI Kit is unaffected. You can retry or check ER health with \`er_sync_status\`._`)}}))}function
|
|
38
|
+
_The local AI Kit is unaffected. You can retry or check ER health with \`er_sync_status\`._`)}}))}function Zc(e,t){let n=K(`er_pull`);e.registerTool(`er_pull`,{title:n.title,description:`Explicitly search the Enterprise RAG AI Kit. Returns results from the enterprise system only (not local AI Kit). Uses a cache with 6-hour TTL to reduce API calls.`,inputSchema:{query:B.string().min(1).max(2e3).describe(`Search query for Enterprise RAG AI Kit (max 2000 chars)`),max_results:B.number().min(1).max(20).default(5).describe(`Maximum results to return`),bypass_cache:B.boolean().default(!0).describe(`Skip cache and fetch fresh results from ER (default: true per DR-001)`)},annotations:n.annotations},X(`er_pull`,async({query:e,max_results:n,bypass_cache:r})=>{try{if(!r){let r=t.cache.get(e);if(r)return{content:[{type:`text`,text:`${r.slice(0,n).map((e,t)=>`### Result ${t+1} (score: ${e.score.toFixed(3)}, source: ER cached)\n- **Source**: ${e.sourcePath}\n\n${e.content}`).join(`
|
|
39
39
|
|
|
40
40
|
---
|
|
41
41
|
|
|
@@ -43,15 +43,15 @@ _The local AI Kit is unaffected. You can retry or check ER health with \`er_sync
|
|
|
43
43
|
|
|
44
44
|
---
|
|
45
45
|
|
|
46
|
-
`)}\n\n---\n_Source: Enterprise RAG (${i.length} results) | Results cached for ${Math.floor(t.config.cacheTtlMs/36e5)}h_`}]}}catch(e){return
|
|
46
|
+
`)}\n\n---\n_Source: Enterprise RAG (${i.length} results) | Results cached for ${Math.floor(t.config.cacheTtlMs/36e5)}h_`}]}}catch(e){return qc.error(`ER pull failed`,R(e)),Y(`INTERNAL`,`ER pull failed: search request unsuccessful
|
|
47
47
|
|
|
48
|
-
_Enterprise RAG may be unavailable. Local AI Kit search is unaffected._`)}}))}function
|
|
48
|
+
_Enterprise RAG may be unavailable. Local AI Kit search is unaffected._`)}}))}function Qc(e,t){let n=K(`er_sync_status`);e.registerTool(`er_sync_status`,{title:n.title,description:`Show the status of the Enterprise RAG bridge: health, cache stats, and push history.`,inputSchema:{check_health:B.boolean().default(!0).describe(`Whether to ping ER health endpoint (adds latency)`)},annotations:n.annotations},X(`er_sync_status`,async({check_health:e})=>{try{let n=t.cache.stats(),r=t.pushAdapter.getStatus(),i=new URL(t.config.baseUrl),a=`${i.protocol}//${i.hostname}${i.port?`:${i.port}`:``}`,o=`_Health check skipped_`;if(e){let e=await t.client.health();o=e.healthy?`✅ Healthy (HTTP ${e.status})`:`❌ Unhealthy${e.status?` (HTTP ${e.status})`:``}`}let s=[`## ER Bridge Status
|
|
49
49
|
`,`**Endpoint**: \`${a}\``,`**Health**: ${o}`,`**Threshold**: ${t.config.fallbackThreshold} (vector similarity for auto-fallback)`,``,`### Cache`,`- Entries: ${n.size} / ${n.maxEntries}`,`- TTL: ${Math.floor(n.defaultTtlMs/36e5)}h`,``,`### Push History`,`- Total pushed: ${r.totalPushed}`,`- Successful: ${r.successCount}`,`- Failed: ${r.failCount}`];return r.lastPush&&s.push(`- Last push: "${r.lastPush.title}" at ${r.lastPush.pushedAt} (${r.lastPush.status})`),s.push("\n---\n_Next: Use `er_push` to send knowledge to ER, or `er_pull` to search ER._"),{content:[{type:`text`,text:s.join(`
|
|
50
|
-
`)}]}}catch(e){return
|
|
50
|
+
`)}]}}catch(e){return qc.error(`ER sync status failed`,R(e)),Y(`INTERNAL`,`ER sync status failed: ${e instanceof Error?e.message:String(e)}`)}}))}const $c=L(`tools`);function el(e){let t=[`Compliance score: ${e.score}/100`,`Calls scored: ${e.totalCalls}`,`Summary: ${e.summary}`];if(e.violations.length===0)return`${t.join(`
|
|
51
51
|
`)}\n\nNo violations detected.`;let n=e.violations.map(e=>`- ${e.ruleId} | ${e.tool} | ${e.timestamp}\n ${e.rule}\n Suggestion: ${e.suggestion}`);return`${t.join(`
|
|
52
52
|
`)}\n\nViolations:\n${n.join(`
|
|
53
|
-
`)}`}function
|
|
54
|
-
`)}function
|
|
53
|
+
`)}`}function tl(e){let t=K(`compliance_score`);e.registerTool(`compliance_score`,{title:t.title,description:`Score replay log compliance against AI Kit tool-routing rules and surface violations with remediation guidance.`,inputSchema:{last_n:B.number().min(1).max(500).default(50).describe(`Maximum number of recent replay entries to score (default: 50)`)},annotations:t.annotations},X(`compliance_score`,async({last_n:e})=>{try{return{content:[{type:`text`,text:el(dn(an({last:e}),{lastN:e}))}]}}catch(e){return $c.error(`Compliance score failed`,R(e)),Y(`INTERNAL`,`Compliance score failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Z(e){return String(e??``).replace(/&/g,`&`).replace(/</g,`<`).replace(/>/g,`>`).replace(/"/g,`"`)}const nl=B.object({action:B.enum([`view`,`update`]).default(`view`).describe(`Action to perform: view current configuration or update it`),updates:B.record(B.string(),B.unknown()).optional().describe(`Partial configuration to merge when action is "update". Supports nested paths like { "indexing": { "chunkSize": 2000 } }`)}),rl=L(`config-tool`),il=`ui://aikit/config.html`,al=[`serverName`,`toolPrefix`,`autoIndex`,`sources`,`indexing`,`tokenBudget`];function ol(){let e=process.env.AIKIT_CONFIG_PATH;if(e&&M(e))return e;let t=I(process.cwd(),`aikit.config.json`);return M(t)?t:``}function sl(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function cl(e,t){let n={...e};for(let[e,r]of Object.entries(t)){let t=n[e];if(sl(t)&&sl(r)){n[e]=cl(t,r);continue}n[e]=r}return n}function ll(e){return e===void 0?`undefined`:JSON.stringify(e)}function ul(e,t,n,r=``){let i=[];for(let[a,o]of Object.entries(n)){let n=r?`${r}.${a}`:a,s=e[a],c=t[a];if(sl(o)&&sl(s)&&sl(c)){i.push(...ul(s,c,o,n));continue}ll(s)!==ll(c)&&i.push(`- ${n}: ${ll(s)} -> ${ll(c)}`)}return i}function dl(e){let t=[];for(let[n,r]of Object.entries(e)){if(n===`store`||n===`embedding`||n===`er`){t.push(`Field "${n}" cannot be updated through this tool because it requires a restart.`);continue}if(n===`onboardDir`||n===`stateDir`||n===`curated`){t.push(`Field "${n}" cannot be updated through this tool because it requires a restart.`);continue}if(n===`autoIndex`){typeof r!=`boolean`&&t.push(`autoIndex must be a boolean.`);continue}if(n===`serverName`||n===`toolPrefix`){typeof r!=`string`&&t.push(`${n} must be a string.`);continue}if(n===`sources`){(!Array.isArray(r)||r.length===0)&&t.push(`sources must be a non-empty array.`);continue}if(n===`indexing`){if(!sl(r)){t.push(`indexing must be an object.`);continue}for(let[e,n]of Object.entries(r)){if(e!==`chunkSize`&&e!==`chunkOverlap`&&e!==`minChunkSize`&&e!==`concurrency`){t.push(`indexing.${e} is not updatable through this tool.`);continue}(typeof n!=`number`||!Number.isFinite(n)||n<=0)&&t.push(`indexing.${e} must be a positive number.`)}continue}if(n===`tokenBudget`){(typeof r!=`string`||!ke.includes(r))&&t.push(`tokenBudget must be one of: ${ke.join(`, `)}.`);continue}t.push(`Field "${n}" is not updatable through this tool.`)}return t}function fl(e){let t=[];if(`autoIndex`in e&&typeof e.autoIndex!=`boolean`&&t.push(`autoIndex must be a boolean.`),`serverName`in e&&e.serverName!==void 0&&typeof e.serverName!=`string`&&t.push(`serverName must be a string.`),`toolPrefix`in e&&e.toolPrefix!==void 0&&typeof e.toolPrefix!=`string`&&t.push(`toolPrefix must be a string.`),(!Array.isArray(e.sources)||e.sources.length===0)&&t.push(`sources must be a non-empty array.`),!sl(e.indexing))return t.push(`indexing must be an object.`),t;for(let n of[`chunkSize`,`chunkOverlap`,`minChunkSize`,`concurrency`]){let r=e.indexing[n];r!==void 0&&(typeof r!=`number`||!Number.isFinite(r)||r<=0)&&t.push(`indexing.${n} must be a positive number.`)}return t}function pl(e){let t=JSON.parse(P(e,`utf-8`));if(!sl(t))throw Error(`Config file must contain a JSON object.`);return t}function ml(e,t){return[`AI Kit Configuration`,`Config file: ${t}`,``,JSON.stringify(e,null,2)].join(`
|
|
54
|
+
`)}function hl(e){return e===void 0?``:sl(e)||Array.isArray(e)?JSON.stringify(e,null,2):String(e)}function gl(e){let t=e.metrics??[],n={success:`#22c55e`,warning:`#f59e0b`,error:`#ef4444`,info:`#38bdf8`},r={up:`↑`,down:`↓`,neutral:`→`};return`
|
|
55
55
|
<style>
|
|
56
56
|
.db-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:14px}
|
|
57
57
|
.db-card{padding:14px;border:1px solid var(--aikit-border,#3c3c3c);border-left-width:4px;border-radius:8px;background:var(--aikit-surface,#252526)}
|
|
@@ -64,11 +64,11 @@ _Enterprise RAG may be unavailable. Local AI Kit search is unaffected._`)}}))}fu
|
|
|
64
64
|
.db-list{margin-top:8px;display:grid;gap:4px}
|
|
65
65
|
.db-list-row{display:flex;justify-content:space-between;padding:4px 0;color:var(--aikit-muted,#9ca3af);font:400 12px var(--aikit-font-sans,system-ui,sans-serif);border-bottom:1px solid var(--aikit-border,#3c3c3c)}
|
|
66
66
|
</style>
|
|
67
|
-
<div class="db-grid">${t.map(e=>{let t=n[e.status??`info`]??n.info,i=e.trend?`<span class="db-trend ${e.trend.direction}">${r[e.trend.direction]??``} ${
|
|
67
|
+
<div class="db-grid">${t.map(e=>{let t=n[e.status??`info`]??n.info,i=e.trend?`<span class="db-trend ${e.trend.direction}">${r[e.trend.direction]??``} ${Z(e.trend.value)}</span>`:``,a=`<div class="db-value">${Z(String(e.value))}</div>${i}`;return e.type===`progress`&&e.progress!=null&&(a+=`<div class="db-progress"><div class="db-progress-bar" style="width:${Math.min(100,Math.max(0,e.progress))}%;background:${t}"></div></div>`),e.type===`list`&&e.items?.length&&(a+=`<div class="db-list">${e.items.map(e=>`<div class="db-list-row"><span>${Z(e.label)}</span><span>${Z(e.value)}</span></div>`).join(``)}</div>`),`
|
|
68
68
|
<div class="db-card" style="border-left-color:${t}">
|
|
69
|
-
<div class="db-label">${
|
|
69
|
+
<div class="db-label">${Z(e.label)}</div>
|
|
70
70
|
${a}
|
|
71
|
-
</div>`}).join(``)}</div>`}function
|
|
71
|
+
</div>`}).join(``)}</div>`}function _l(e){let t=e.fields??[];return`
|
|
72
72
|
<style>
|
|
73
73
|
.fm-container{display:grid;grid-template-columns:1fr 280px;gap:24px}
|
|
74
74
|
@media(max-width:640px){.fm-container{grid-template-columns:1fr}}
|
|
@@ -94,7 +94,7 @@ _Enterprise RAG may be unavailable. Local AI Kit search is unaffected._`)}}))}fu
|
|
|
94
94
|
</style>
|
|
95
95
|
<div class="fm-container">
|
|
96
96
|
<div class="fm-fields" id="fmFields">
|
|
97
|
-
${t.map(e=>{let t=e.type??`text`,n;if(t===`select`&&e.options){let t=e.options.map(t=>`<option value="${
|
|
97
|
+
${t.map(e=>{let t=e.type??`text`,n;if(t===`select`&&e.options){let t=e.options.map(t=>`<option value="${Z(t)}"${t===e.value?` selected`:``}>${Z(t)}</option>`).join(``);n=`<select class="fm-input" data-field="${Z(e.name)}">${t}</select>`}else n=t===`textarea`?`<textarea class="fm-input fm-textarea" data-field="${Z(e.name)}" rows="4">${Z(e.value??``)}</textarea>`:t===`multi-select`&&e.options?`<div class="fm-multi">${e.options.map(t=>`<label class="fm-check-label"><input type="checkbox" data-field="${Z(e.name)}" value="${Z(t)}"${e.value?.includes(t)?` checked`:``}> ${Z(t)}</label>`).join(``)}</div>`:`<input class="fm-input" type="${Z(t)}" data-field="${Z(e.name)}" value="${Z(e.value??``)}">`;return`<div class="fm-group"><label class="fm-label">${Z(e.label)}</label>${n}</div>`}).join(``)}
|
|
98
98
|
<button class="fm-submit" id="fmSubmit">Submit</button>
|
|
99
99
|
</div>
|
|
100
100
|
<div class="fm-preview">
|
|
@@ -133,9 +133,9 @@ _Enterprise RAG may be unavailable. Local AI Kit search is unaffected._`)}}))}fu
|
|
|
133
133
|
}
|
|
134
134
|
});
|
|
135
135
|
})();
|
|
136
|
-
<\/script>`}function
|
|
137
|
-
`)}`}],ui:{type:`resource`,uri:
|
|
138
|
-
`)}`}],ui:{type:`resource`,uri:
|
|
136
|
+
<\/script>`}function vl(e){return gl({metrics:Object.entries(e).map(([e,t])=>({label:e,value:sl(t)||Array.isArray(t)?JSON.stringify(t,null,2):String(t),status:`info`}))})}function yl(e){return _l({fields:al.map(t=>{let n=e[t];return typeof n==`boolean`?{name:t,label:t,type:`select`,options:[`true`,`false`],value:String(n)}:{name:t,label:t,type:sl(n)||Array.isArray(n)?`textarea`:`text`,value:hl(n)}})})}function bl(e,t){return`<!DOCTYPE html><html><head><meta charset="utf-8"><title>${e}</title><style>:root{--aikit-bg:#1e1e1e;--aikit-surface:#252526;--aikit-surface2:#2d2d30;--aikit-border:#3c3c3c;--aikit-text:#e5e7eb;--aikit-muted:#9ca3af;--aikit-accent:#60a5fa;--aikit-success:#22c55e;font-family:system-ui,sans-serif}body{margin:0;padding:20px;background:var(--aikit-bg);color:var(--aikit-text);font-family:system-ui,sans-serif}h2{margin:0 0 16px}</style></head><body><h2>${e}</h2>${t}</body></html>`}function xl(e){let t=``,n=``,r=!1;return function(i,a){t=i,n=a,!r&&(r=!0,mr(e,`AI Kit Config App`,il,{description:`View and update AI Kit configuration`},async()=>({contents:[{uri:il,mimeType:fr,text:bl(t,n)}]})))}}function Sl(e,t){let n=K(`config`),r=xl(e);hr(e,`config`,{title:n.title,description:`View and update AI Kit server configuration. Use action "view" to see current settings, or "update" to modify configuration values. Changes are written to aikit.config.json and take effect on next server restart. Some settings (store, embedding) require a full restart.`,inputSchema:nl,annotations:n.annotations,_meta:{ui:{resourceUri:il}}},X(`config`,async e=>{let{action:n,updates:i}=e;if(t.readOnly&&n!==`view`)return Y(`PERMISSION`,`Configuration updates are disabled in read-only mode`);if(n===`view`){let e=ol(),n=e||`(runtime config only; no aikit.config.json found)`;try{let i=e?pl(e):t,a=ml(i,n);return r(`Configuration`,vl(i)),{content:[{type:`text`,text:a}],ui:{type:`resource`,uri:il}}}catch(t){return rl.error(`Failed to read config for view`,{configPath:e,error:t instanceof Error?t.message:String(t)}),{content:[{type:`text`,text:`Failed to read configuration from ${n}: ${t instanceof Error?t.message:String(t)}`}]}}}if(!i)return r(`Configuration Form`,yl(t)),{content:[{type:`text`,text:`No updates provided. Pass an updates object when action is "update".`}],ui:{type:`resource`,uri:il}};let a=ol();if(!a)return r(`Configuration Form`,yl(t)),{content:[{type:`text`,text:`No config file found to update.`}],ui:{type:`resource`,uri:il}};let o=dl(i);if(o.length>0)return r(`Configuration Form`,yl(pl(a))),{content:[{type:`text`,text:`Configuration update rejected:\n${o.map(e=>`- ${e}`).join(`
|
|
137
|
+
`)}`}],ui:{type:`resource`,uri:il}};try{let e=pl(a),t=cl(e,i),n=fl(t);if(n.length>0)return r(`Configuration Form`,yl(e)),{content:[{type:`text`,text:`Configuration update rejected:\n${n.map(e=>`- ${e}`).join(`
|
|
138
|
+
`)}`}],ui:{type:`resource`,uri:il}};me(a,JSON.stringify(t,null,2),`utf-8`);let o=ul(e,t,i),s=`Configuration updated successfully.
|
|
139
139
|
|
|
140
140
|
Config file: ${a}
|
|
141
141
|
|
|
@@ -143,27 +143,27 @@ Changed values:
|
|
|
143
143
|
${o.length>0?o.join(`
|
|
144
144
|
`):`- No effective changes; requested values already matched the file.`}
|
|
145
145
|
|
|
146
|
-
These changes take effect on the next server restart.`;return r(`Configuration`,
|
|
147
|
-
`);if(p&&a){let e=await
|
|
148
|
-
`)+"\n\n---\n_Next: Use `search` to dive into specific files, or `compact` to compress file contents for context._";if(s&&r){let t=await
|
|
149
|
-
No search strategies were activated. Provide at least one of: query, glob, or pattern.`:``}`;if(p&&i){let n=await
|
|
150
|
-
`);if(p&&i){let t=await
|
|
151
|
-
`);if(c&&i){let t=await
|
|
152
|
-
`);if(c&&a){let t=await
|
|
153
|
-
`)}function
|
|
154
|
-
`)}function
|
|
146
|
+
These changes take effect on the next server restart.`;return r(`Configuration`,vl(t)),{content:[{type:`text`,text:s}],ui:{type:`resource`,uri:il}}}catch(e){return rl.error(`Failed to update config`,{configPath:a,error:e instanceof Error?e.message:String(e)}),{content:[{type:`text`,text:`Failed to update configuration in ${a}: ${e instanceof Error?e.message:String(e)}`}]}}})),r(`Configuration`,vl(t))}const Cl=L(`cross-workspace`);function wl(e,t){if(!Pe())return[];let n=Fe();if(n.length===0)return[];if(e.includes(`*`))return t?n.filter(e=>e.partition!==t):n;let r=[];for(let i of e){let e=n.find(e=>e.partition===i);if(e){e.partition!==t&&r.push(e);continue}let a=n.filter(e=>e.partition!==t&&e.partition.replace(/-[a-f0-9]{8}$/,``)===i.toLowerCase());r.push(...a)}let i=new Set;return r.filter(e=>i.has(e.partition)?!1:(i.add(e.partition),!0))}async function Tl(e){let t=new Map;for(let n of e){let e=Ne(n.partition),r=F(e,`aikit.db`);try{let e=await br({backend:`sqlite-vec`,path:r});await e.initialize(),t.set(n.partition,e)}catch(t){Cl.warn(`Failed to open workspace store`,{partition:n.partition,partitionDir:e,storePath:r,error:R(t)})}}return{stores:t,closeAll:async()=>{for(let[,e]of t)try{await e.close()}catch{}}}}async function El(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 Cl.warn(`Cross-workspace search failed for partition`,{partition:e,err:t}),[]}});return(await Promise.all(r)).flat().sort((e,t)=>t.score-e.score).slice(0,n.limit)}async function Dl(e,t,n){let r=[...e.entries()].map(async([e,r])=>{try{return(await r.ftsSearch(t,n)).map(t=>({...t,workspace:e}))}catch(t){return Cl.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 Ol(e){return e.toLowerCase().replace(/[-_]/g,``)}function kl(e){let t=ge(e),n=Ol(he(e));try{let e=le(t);for(let r of e)if(Ol(r)===n){let e=I(t,r);if(M(e))return e}}catch{}}function Al(e,t,n){if(_e(e))return M(e)?e:kl(e)||e;let r=I(t,e);if(M(r))return r;let i=kl(r);if(i)return i;if(n)for(let r of n){if(r===t)continue;let n=I(r,e);if(M(n))return n;let i=kl(n);if(i)return i}try{let n=le(t,{withFileTypes:!0});for(let r of n){if(!r.isDirectory()||r.name.startsWith(`.`)||r.name===`node_modules`)continue;let n=I(t,r.name,e);if(M(n))return n;let i=kl(n);if(i)return i}}catch{}return r}function jl(e){if(e.length!==0)return yn({kind:`compact`,text:e,originalChars:e.length,compressedChars:e.length})?.ref??void 0}function Ml(e,t){return t?`${e}\n\nRef: ${t}`:e}const Nl=L(`tools:context`),Pl=/^ctx[cd]_[a-z0-9]+$/;function Fl(e){return e instanceof Error?(`code`in e?e.code:void 0)===`ENOENT`||e.message.startsWith(`File not found:`)||e.message.startsWith(`Path not found:`):!1}function Il(e,t){return Fl(t)?(Nl.warn(`${e} failed`,{error:`File not found`}),Y(`NOT_FOUND`,`File not found`)):(Nl.error(`${e} failed`,R(t)),Y(`INTERNAL`,`${e} failed: ${t instanceof Error?t.message:String(t)}`))}function Ll(e){return Pl.test(e)}function Rl({text:e,path:t,ref:n,query:r}){let i=typeof e==`string`&&e.length>0,a=typeof t==`string`&&t.length>0,o=typeof n==`string`&&n.length>0,s=typeof r==`string`&&r.trim().length>0;if(!o&&a&&Ll(t))return`Cached reversible refs must be passed as "ref", not "path".`;if(o&&(i||a))return`Provide "ref" by itself, not together with "text" or "path".`;if(!o&&!i&&!a)return`Either "text", "path", or "ref" must be provided.`;if(!o&&!s)return`A focus query is required unless you are restoring a cached ref.`}function zl(e,t,n,r){if(!r||!e)return;let i=e.replace(/\\/g,`/`);if(![t,...n??[]].map(e=>e.replace(/\\/g,`/`)).some(e=>{let t=e.endsWith(`/`)?e.slice(0,-1):e;return i===t||i.startsWith(`${t}/`)}))try{r(e)}catch{}}function Bl(e,t,n,r,i,a,o){let s=K(`compact`);e.registerTool(`compact`,{title:s.title,description:"Compress text to relevant sections using embedding similarity (no LLM). Provide `text`, `path`, or a cached `ref` from compact/digest/search/find/knowledge. Segments by paragraph/sentence/line.",outputSchema:nc,inputSchema:{text:B.string().optional().describe(`The text to compress (provide this OR path, not both)`),path:B.string().optional().describe("File path to read server-side — avoids read_file round-trip + token doubling. Use `ref` for cached ctxc_/ctxd_ reads."),ref:B.string().optional().describe(`Reusable cached string ref from compact/digest/search/find/knowledge output`),query:B.string().optional().describe("Focus query — required with `text` or `path`, optional when restoring from `ref`."),max_chars:B.number().min(100).max(5e4).default(3e3).describe(`Target output size in characters`),segmentation:B.enum([`paragraph`,`sentence`,`line`]).default(`paragraph`).describe(`How to split the text for scoring`),token_budget:B.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:B.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context for the file/query.`)},annotations:s.annotations},X(`compact`,async({text:e,path:s,ref:c,query:l,max_chars:u,segmentation:d,token_budget:f,enrich:p})=>{try{let m=Rl({text:e,path:s,ref:c,query:l});if(m)return Y(`VALIDATION`,m);let h=s?Al(s,r,i):void 0,g=typeof l==`string`&&l.trim().length>0,_=c?await Ze(t,{ref:c,query:l,maxChars:u,tokenBudget:f,segmentation:d,cache:n}):h?await Ze(t,{path:h,query:l??``,maxChars:u,tokenBudget:f,segmentation:d,cache:n}):await Ze(t,{text:e??``,query:l??``,maxChars:u,tokenBudget:f,segmentation:d,cache:n});zl(h,r,i,o);let v=!!(c&&!g),y=[v?`Retrieved cached ref ${_.ref??c} (${_.compressedChars} chars)`:`Compressed ${_.originalChars} → ${_.compressedChars} chars (${(_.ratio*100).toFixed(0)}%)`,v?void 0:`Kept ${_.segmentsKept}/${_.segmentsTotal} segments`,_.ref?`Ref: ${_.ref}`:void 0,``,_.text].filter(e=>typeof e==`string`).join(`
|
|
147
|
+
`);if(p&&a){let e=await q(a,{query:l,filePath:h});y+=J(e)}return{content:[{type:`text`,text:y}],structuredContent:{text:y,ref:_.ref,originalChars:_.originalChars,compressedChars:_.compressedChars,ratio:_.ratio,segmentsKept:_.segmentsKept,segmentsTotal:_.segmentsTotal}}}catch(e){return{...Il(`Compact`,e),structuredContent:{text:``,originalChars:0,compressedChars:0,ratio:0,segmentsKept:0,segmentsTotal:0}}}}))}function Vl(e,t,n,r){let i=K(`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:Gs,inputSchema:{task:B.string().describe(`Description of the task to scope`),max_files:B.number().min(1).max(50).default(15).describe(`Maximum files to include`),content_type:B.enum(Ce).optional().describe(`Filter by content type`),max_tokens:B.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:B.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},X(`scope_map`,async({task:e,max_files:i,content_type:a,max_tokens:o,enrich:s})=>{try{let c=await un(t,n,{task:e,maxFiles:i,contentType:a}),l=[`## Scope Map: ${e}`,`Total estimated tokens: ~${c.totalEstimatedTokens}`,``,`### Files (by relevance)`,...c.files.map((e,t)=>`${t+1}. **${e.path}** (~${e.estimatedTokens} tokens, ${(e.relevance*100).toFixed(0)}% relevant)\n ${e.reason}\n Focus: ${e.focusRanges.map(e=>`L${e.start}-${e.end}`).join(`, `)}`),``,`### Suggested Reading Order`,...c.readingOrder.map((e,t)=>`${t+1}. ${e}`),``,`### Suggested Compact Calls`,`_Estimated compressed total: ~${Math.ceil(c.totalEstimatedTokens/5)} tokens_`,...c.compactCommands.map((e,t)=>`${t+1}. ${e}`)].join(`
|
|
148
|
+
`)+"\n\n---\n_Next: Use `search` to dive into specific files, or `compact` to compress file contents for context._";if(s&&r){let t=await q(r,{query:e});l+=J(t)}return{content:[{type:`text`,text:o?z(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 Il(`Scope map`,e)}}))}function Hl(e,t,n,r,i,a){let o=K(`find`);e.registerTool(`find`,{title:o.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:Us,inputSchema:{query:B.string().optional().describe(`Semantic/keyword search query (required for mode "examples")`),glob:B.string().optional().describe(`File glob pattern (search mode only)`),pattern:B.string().optional().describe(`Regex pattern to match in content (search mode only)`),limit:B.number().min(1).max(50).default(10).describe(`Max results`),content_type:B.enum(Ce).optional().describe(`Filter by content type`),mode:B.enum([`search`,`examples`]).default(`search`).describe(`Mode: "search" (default) for federated search, "examples" to find usage examples of a symbol/pattern`),max_tokens:B.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),workspaces:B.array(B.string()).optional().describe(`Cross-workspace search: partition names or folder basenames to include. Use ["*"] for all. User-level mode only.`),enrich:B.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},X(`find`,async({query:e,glob:o,pattern:s,limit:c,content_type:l,mode:u,max_tokens:d,workspaces:f,enrich:p})=>{try{if(u===`examples`){if(!e)return Y(`VALIDATION`,`"query" is required for mode "examples".`);let r=await ht(t,n,{query:e,limit:c,contentType:l}),a=jl(JSON.stringify(r)),o=JSON.stringify(a?{ref:a,...r}:r);if(p&&i){let t=await q(i,{query:e});o+=J(t)}return{content:[{type:`text`,text:d?z(o,d):o}]}}let m=await pt(t,n,{query:e,glob:o,pattern:s,limit:c,contentType:l,cwd:r}),h=``;if(f&&f.length>0&&e){let n=wl(f,a);if(n.length>0){let{stores:r,closeAll:i}=await Tl(n);try{let i=await El(r,await t.embedQuery(e),{limit:c,contentType:l});for(let e of i)m.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)});m.results.sort((e,t)=>t.score-e.score),m.results=m.results.slice(0,c),m.totalFound=m.results.length,h=` + ${n.length} workspace(s)`}finally{await i()}}}if(m.results.length===0){let t=`No results found.${m.failedStrategies?.length?`\nStrategies attempted: ${m.strategies.join(`, `)}\nFailed: ${m.failedStrategies.map(e=>`${e.strategy} (${e.reason})`).join(`, `)}`:m.strategies.length===0?`
|
|
149
|
+
No search strategies were activated. Provide at least one of: query, glob, or pattern.`:``}`;if(p&&i){let n=await q(i,{query:e});t+=J(n)}let n=d?z(t,d):t,r=jl(n);return{content:[{type:`text`,text:Ml(n,r)}],structuredContent:{matches:[],totalMatches:0,pattern:e??o??s??``,truncated:!1,ref:r}}}let g=[`Found ${m.totalFound} results via ${m.strategies.join(` + `)}${h}`,``,...m.results.map(e=>{let t=e.lineRange?`:${e.lineRange.start}-${e.lineRange.end}`:``,n=e.preview?`\n ${e.preview.slice(0,100)}...`:``;return`- [${e.source}] ${e.path}${t} (${(e.score*100).toFixed(0)}%)${n}`})].join(`
|
|
150
|
+
`);if(p&&i){let t=await q(i,{query:e,filePath:m.results[0]?.path});g+=J(t)}let _=d?z(g,d):g,v=jl(_);return{content:[{type:`text`,text:Ml(_,v)}],structuredContent:{matches:m.results.map(e=>({path:e.path,...e.lineRange?{line:e.lineRange.start}:{},matchType:e.source,preview:e.preview?.slice(0,200)??``})),totalMatches:m.totalFound,pattern:e??o??s??``,truncated:m.results.length<m.totalFound,ref:v}}}catch(e){return Il(`Find`,e)}}))}function Ul(e,t,n,r,i,a){let o=K(`symbol`);e.registerTool(`symbol`,{title:o.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:B.string().describe(`Symbol name to look up (function, class, type, etc.)`),limit:B.number().min(1).max(50).default(20).describe(`Max results per category`),workspaces:B.array(B.string()).optional().describe(`Cross-workspace search: partition names or folder basenames to include. Use ["*"] for all. User-level mode only.`),max_tokens:B.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:B.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)},outputSchema:zs,annotations:o.annotations},X(`symbol`,async({name:e,limit:o,workspaces:s,max_tokens:c,enrich:l})=>{try{let u=await Sn(t,n,{name:e,limit:o,graphStore:r});if(s&&s.length>0){let n=wl(s,a);if(n.length>0){let{stores:r,closeAll:i}=await Tl(n);try{for(let[n,i]of r){let r=await Sn(t,i,{name:e,limit:o});r.definedIn&&!u.definedIn&&(u.definedIn={...r.definedIn,path:`[${n}] ${r.definedIn.path}`});for(let e of r.referencedIn)u.referencedIn.push({...e,path:`[${n}] ${e.path}`});if(r.importedBy){u.importedBy=u.importedBy??[];for(let e of r.importedBy)u.importedBy.push({...e,path:`[${n}] ${e.path}`})}}}finally{await i()}}}let d={name:u.name,definedIn:u.definedIn??null,importedBy:u.importedBy??[],referencedIn:u.referencedIn??[],graphContext:u.graphContext??null},f=ql(u);if(l&&i){let t=await q(i,{query:`symbol ${e}`});f+=J(t)}return{content:[{type:`text`,text:c?z(f,c):f}],structuredContent:d}}catch(e){return Il(`Symbol lookup`,e)}}))}function Wl(e,t,n,r,i,a){let o=new tr,s=K(`file_summary`);e.registerTool(`file_summary`,{title:s.title,description:`Create a concise structural summary of a source file: imports, exports, functions, classes, interfaces, and types.`,outputSchema:ec,inputSchema:{path:B.string().describe(`Absolute path to the file to summarize`),max_tokens:B.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response.`),enrich:B.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context for the file/query.`)},annotations:s.annotations},X(`file_summary`,async({path:e,max_tokens:s,enrich:c})=>{try{let l=Al(e,n,r);if((await Fn(l)).isDirectory()){let t=await o.analyze(l,{format:`markdown`,maxDepth:3,maxTokens:s});zl(l,n,r,a);let u=t.data.stats?.languages??{},d=Object.entries(u).sort((e,t)=>t[1]-e[1])[0]?.[0],f=`📁 **Directory**: \`${e}\`\n\n${t.output}\n\n---\n_Path is a directory. Showing structure analysis. Use \`analyze({ aspect: "structure", ... })\` for deeper analysis with custom depth._`;if(c&&i){let t=await q(i,{query:e,filePath:l});f+=J(t)}return{content:[{type:`text`,text:s?z(f,s):f}],structuredContent:{path:l,language:d??`directory`,lines:0,imports:0,exports:0,functions:0,classes:0}}}let u=await ft({path:l,content:(await t.get(l)).content,maxTokens:s});zl(l,n,r,a);let d=Jl(u);if(c&&i){let t=await q(i,{query:e,filePath:l});d+=J(t)}return{content:[{type:`text`,text:d}],structuredContent:{path:u.path,language:u.language,lines:u.lines,imports:u.importCount??u.imports?.length??0,exports:u.exports?.length??0,functions:u.functions?.length??0,classes:u.classes?.length??0}}}catch(e){return Il(`File summary`,e)}}))}function Gl(e,t,n,r,i){let a=K(`trace`);e.registerTool(`trace`,{title:a.title,description:`Follow data flow forward/backward across imports and call sites from a starting symbol or file:line. For finding a single symbol definition use symbol instead.`,inputSchema:{start:B.string().describe(`Starting point — symbol name or file:line reference`),direction:B.enum([`forward`,`backward`,`both`]).describe(`Which direction to trace relationships`),max_depth:B.number().min(1).max(10).default(3).optional().describe(`Maximum trace depth`),max_tokens:B.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:B.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)},annotations:a.annotations},X(`trace`,async({start:e,direction:a,max_depth:o,max_tokens:s,enrich:c})=>{try{let l=await Tn(t,n,{start:e,direction:a,maxDepth:o,graphStore:r}),u=[`## Trace: ${l.start}`,`Direction: ${l.direction} | Depth: ${l.depth}`,``];if(l.graphContext&&(u.push(`### Graph Context`),l.graphContext.definingModule&&u.push(`- Module: ${l.graphContext.definingModule}`),l.graphContext.community&&u.push(`- Community: ${l.graphContext.community}`),l.graphContext.importedByModules.length>0&&u.push(`- Imported by modules: ${l.graphContext.importedByModules.join(`, `)}`),l.graphContext.siblingSymbols.length>0&&u.push(`- Sibling symbols: ${l.graphContext.siblingSymbols.join(`, `)}`),u.push(``)),l.nodes.length===0)u.push(`No connections found.`);else{let e=l.nodes.filter(e=>e.relationship===`calls`),t=l.nodes.filter(e=>e.relationship===`called-by`),n=l.nodes.filter(e=>e.relationship===`imports`),r=l.nodes.filter(e=>e.relationship===`imported-by`),i=l.nodes.filter(e=>e.relationship===`references`);if(e.length>0){u.push(`### Calls (${e.length})`);for(let t of e){let e=t.scope?` (from ${t.scope}())`:``;u.push(`- ${t.symbol}() — ${t.path}:${t.line}${e}`)}u.push(``)}if(t.length>0){u.push(`### Called by (${t.length})`);for(let e of t){let t=e.scope?` in ${e.scope}()`:``;u.push(`- ${e.symbol}()${t} — ${e.path}:${e.line}`)}u.push(``)}if(n.length>0){u.push(`### Imports (${n.length})`);for(let e of n)u.push(`- ${e.symbol} — ${e.path}:${e.line}`);u.push(``)}if(r.length>0){u.push(`### Imported by (${r.length})`);for(let e of r)u.push(`- ${e.path}:${e.line}`);u.push(``)}if(i.length>0){u.push(`### References (${i.length})`);for(let e of i)u.push(`- ${e.path}:${e.line}`);u.push(``)}}u.push(`---`,"_Next: `symbol` for definition details | `compact` to read a referenced file | `blast_radius` for impact analysis_");let d=u.join(`
|
|
151
|
+
`);if(c&&i){let t=await q(i,{query:`trace ${e}`});d+=J(t)}return{content:[{type:`text`,text:s?z(d,s):d}],structuredContent:{start:l.start,direction:l.direction,depth:l.depth,nodes:l.nodes,graphContext:l.graphContext??null}}}catch(e){return Il(`Trace`,e)}}))}function Kl(e,t,n,r,i,a){let o=K(`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:$s,inputSchema:{path:B.string().optional().describe(`Root path to scope the search (default: cwd)`),limit:B.number().min(1).max(500).default(100).optional().describe(`Maximum exported symbols to scan`),max_tokens:B.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:B.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},X(`dead_symbols`,async({path:e,limit:o,max_tokens:s,enrich:c})=>{try{let l=e&&r?Al(e,r,i):e,u=await mt(t,n,{rootPath:l,limit:o}),d=[`## Dead Symbol Analysis`,``,`**Exports scanned:** ${u.totalExports}`,`**Dead in source:** ${u.totalDeadSource} (actionable)`,`**Dead in docs:** ${u.totalDeadDocs} (informational — code samples in .md files)`,``];if(u.deadInSource.length>0){d.push(`### Dead in Source (actionable)`);for(let e of u.deadInSource)d.push(`- \`${e.name}\` (${e.kind}) — ${e.path}:${e.line}`);d.push(``)}if(u.deadInDocs.length>0){d.push(`### Dead in Docs (informational)`),d.push(`_${u.totalDeadDocs} symbol(s) found only in documentation code samples — not actionable dead code._`);for(let e of u.deadInDocs.slice(0,5))d.push(`- \`${e.name}\` — ${e.path}:${e.line}`);u.deadInDocs.length>5&&d.push(`- _... ${u.deadInDocs.length-5} more omitted_`)}u.totalDeadSource>0?d.push(``,`---`,`_Next: \`codemod\` to remove ${u.totalDeadSource} unused exports | \`symbol\` to verify usage before removing_`):d.push(``,`---`,"_Next: `check` — no dead symbols found, validate types and lint_");let f=d.join(`
|
|
152
|
+
`);if(c&&a){let t=await q(a,{query:`dead symbols ${e??l??``}`});f+=J(t)}return{content:[{type:`text`,text:s?z(f,s):f}],structuredContent:{symbols:[...u.deadInSource,...u.deadInDocs].map(e=>({name:e.name,path:e.path,...e.line===void 0?{}:{line:e.line},kind:e.kind})),totalDead:u.totalDeadSource+u.totalDeadDocs}}}catch(e){return Il(`Dead symbol scan`,e)}}))}function ql(e){let t=[`Symbol: ${e.name}`];if(e.definedIn){let n=`Defined in: ${e.definedIn.path}:${e.definedIn.line} (${e.definedIn.kind})`;e.definedIn.signature&&(n+=`\nSignature: ${e.definedIn.signature}`),t.push(n)}else t.push(`Defined in: not found`);if(t.push(``,`Imported by:`),e.importedBy.length===0)t.push(` none`);else for(let n of e.importedBy)t.push(` - ${n.path}:${n.line} ${n.importStatement}`);if(t.push(``,`Referenced in:`),e.referencedIn.length===0)t.push(` none`);else for(let n of e.referencedIn){let e=`scope`in n&&n.scope?` in ${n.scope}()`:``;t.push(` - ${n.path}:${n.line}${e} ${n.context}`)}if(e.graphContext){let n=e.graphContext;t.push(``,`Graph context:`),n.definingModule&&t.push(` Module: ${n.definingModule}`),n.importedByModules.length>0&&t.push(` Imported by modules: ${n.importedByModules.join(`, `)}`),n.siblingSymbols.length>0&&t.push(` Sibling symbols: ${n.siblingSymbols.join(`, `)}`)}return t.join(`
|
|
153
|
+
`)}function Jl(e){let t=[e.path,`Language: ${e.language}`,`Lines: ${e.lines}`,`Estimated tokens: ~${e.estimatedTokens}`,``,`Imports (${e.importCount??e.imports.length}):`,...Yl(e.imports),``,`Exports (${e.exports.length}):`,...Yl(e.exports),``,`Functions (${e.functions.length}):`,...Yl(e.functions.map(e=>`${e.name} @ line ${e.line}${e.exported?` [exported]`:``}${`signature`in e&&e.signature?` — ${e.signature}`:``}`)),``,`Classes (${e.classes.length}):`,...Yl(e.classes.map(e=>`${e.name} @ line ${e.line}${e.exported?` [exported]`:``}${e.signature?` — ${e.signature}`:``}`)),``,`Interfaces (${e.interfaces.length}):`,...Yl(e.interfaces.map(e=>`${e.name} @ line ${e.line}${`exported`in e&&e.exported?` [exported]`:``}`)),``,`Types (${e.types.length}):`,...Yl(e.types.map(e=>`${e.name} @ line ${e.line}${`exported`in e&&e.exported?` [exported]`:``}`))];if(`importDetails`in e&&e.importDetails&&e.importDetails.length>0){let n=e.importDetails.filter(e=>e.isExternal).length,r=e.importDetails.length-n;t.push(``,`Import breakdown: ${n} external, ${r} internal`)}if(`callEdges`in e&&e.callEdges&&e.callEdges.length>0){t.push(``,`Call edges (${e.callEdgeCount??e.callEdges.length} intra-file):`);for(let n of e.callEdges.slice(0,30))t.push(` - ${n.caller}() → ${n.callee}() @ line ${n.line}`);e.callEdges.length>30&&t.push(` - ... ${e.callEdges.length-30} more`)}return t.join(`
|
|
154
|
+
`)}function Yl(e){return e.length===0?[` none`]:e.map(e=>` - ${e}`)}const Xl=L(`tools`);function Zl(e,t){let n=K(`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:B.boolean().default(!0).describe(`Include detailed breakdowns (top missed queries, rule stats)`),reset_after:B.boolean().default(!1).describe(`Reset collected metrics after review`)},annotations:n.annotations},async({include_details:e,reset_after:n})=>{try{let r=t.getMetrics(),i=[`## ER Evolution Review
|
|
155
155
|
`,`**Period**: ${r.period.startedAt} → ${r.period.queriedAt}`,`**Total events**: ${r.period.totalEvents}\n`,`### Search`,`- Total searches: ${r.search.totalSearches}`,`- ER fallback triggered: ${r.search.erFallbackCount} (${(r.search.erFallbackRate*100).toFixed(1)}%)`,`- ER cache hits: ${r.search.erCacheHitCount} (${(r.search.erCacheHitRate*100).toFixed(1)}% of fallbacks)`];if(e&&r.search.topMissedQueries.length>0){i.push(`
|
|
156
|
-
**Top missed queries** (triggered ER fallback):`);for(let e of r.search.topMissedQueries.slice(0,10)){let t=e.query.length>60?`${e.query.slice(0,57)}...`:e.query;i.push(` - "${t}" (${e.count}x)`)}}if(i.push(``,`### Push`,`- Total pushes: ${r.push.totalPushes} (${r.push.successCount} ok, ${r.push.failCount} failed)`,`- Classification match rate: ${(r.push.classificationMatchRate*100).toFixed(1)}%`,`- Push acceptance rate: ${(r.push.pushAcceptanceRate*100).toFixed(1)}%`),i.push(``,`### Rule Effectiveness`),Object.keys(r.rules.matchCounts).length>0)for(let[e,t]of Object.entries(r.rules.matchCounts)){let n=r.rules.pushCounts[e]??0,a=t>0?(n/t*100).toFixed(0):`0`;i.push(`- **${e}**: ${t} matches → ${n} pushes (${a}% conversion)`)}else i.push(`- _No rule activity recorded yet_`);if(e&&r.rules.lowConversionRules.length>0){i.push(``,`### ⚠️ Low Conversion Rules (potential false positives)`);for(let e of r.rules.lowConversionRules)i.push(`- **${e.ruleId}**: ${e.matchCount} matches, ${e.pushCount} pushes (${(e.conversionRate*100).toFixed(0)}% conversion) — consider tightening patterns`)}return i.push(``,`---`,"_Next: Use `er_update_policy` to refine rules based on these metrics, or `er_push` to share high-value knowledge._"),n&&(
|
|
156
|
+
**Top missed queries** (triggered ER fallback):`);for(let e of r.search.topMissedQueries.slice(0,10)){let t=e.query.length>60?`${e.query.slice(0,57)}...`:e.query;i.push(` - "${t}" (${e.count}x)`)}}if(i.push(``,`### Push`,`- Total pushes: ${r.push.totalPushes} (${r.push.successCount} ok, ${r.push.failCount} failed)`,`- Classification match rate: ${(r.push.classificationMatchRate*100).toFixed(1)}%`,`- Push acceptance rate: ${(r.push.pushAcceptanceRate*100).toFixed(1)}%`),i.push(``,`### Rule Effectiveness`),Object.keys(r.rules.matchCounts).length>0)for(let[e,t]of Object.entries(r.rules.matchCounts)){let n=r.rules.pushCounts[e]??0,a=t>0?(n/t*100).toFixed(0):`0`;i.push(`- **${e}**: ${t} matches → ${n} pushes (${a}% conversion)`)}else i.push(`- _No rule activity recorded yet_`);if(e&&r.rules.lowConversionRules.length>0){i.push(``,`### ⚠️ Low Conversion Rules (potential false positives)`);for(let e of r.rules.lowConversionRules)i.push(`- **${e.ruleId}**: ${e.matchCount} matches, ${e.pushCount} pushes (${(e.conversionRate*100).toFixed(0)}% conversion) — consider tightening patterns`)}return i.push(``,`---`,"_Next: Use `er_update_policy` to refine rules based on these metrics, or `er_push` to share high-value knowledge._"),n&&(Xl.info(`Evolution metrics reset requested`,{requestedAt:new Date().toISOString(),clearedEvents:r.period.totalEvents}),t.reset(),i.push(`
|
|
157
157
|
_Metrics have been reset._`)),{content:[{type:`text`,text:i.join(`
|
|
158
|
-
`)}]}}catch(e){return
|
|
159
|
-
`);if(s&&t){let e=await
|
|
160
|
-
`).replace(/\\t/g,` `),t);return{content:[{type:`text`,text:JSON.stringify(n)}]}}catch(e){return
|
|
161
|
-
`)}const
|
|
162
|
-
`);if(e&&typeof e==`object`&&`type`in e){let t=e;if(t.type===`text`&&typeof t.text==`string`)return t.text}return JSON.stringify(e)}function
|
|
163
|
-
`);return{content:n,tokens:Math.ceil(n.length/4)}}};function
|
|
164
|
-
`),i=Math.ceil(n.length/4);return{content:`**Recalled Knowledge:**\n${n}`,tokens:Math.min(i,200)}}catch{return null}}}}const
|
|
158
|
+
`)}]}}catch(e){return Xl.error(`Evolution review failed`,R(e)),Y(`INTERNAL`,`Evolution review failed: unable to compute metrics`)}})}const Ql=L(`tools:execution`);function $l(e,t,n){let r=K(`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:B.array(B.string()).optional().describe(`Specific files to check (if omitted, checks all)`),cwd:B.string().optional().describe(`Working directory`),skip_types:B.boolean().default(!1).describe(`Skip TypeScript typecheck`),skip_lint:B.boolean().default(!1).describe(`Skip Biome lint`),detail:B.enum(ke).optional().describe(`Output detail level: efficient (default, ~300 tokens — pass/fail + counts + top errors), normal (parsed error objects), full (includes raw terminal output)`),enrich:B.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:Rs,annotations:r.annotations},X(`check`,async({files:e,cwd:r,skip_types:i,skip_lint:a,detail:o,enrich:s},c)=>{try{let l=o??n??`efficient`,u=await He({files:e,cwd:r,skipTypes:i,skipLint:a,detail:l===`efficient`?`normal`:l}),d=Wc(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=xn(u),n=[];if(u.passed)n.push({tool:`test_run`,reason:`Types and lint clean — run tests next`});else{let t=u.tsc.errors[0]?.file??u.biome.errors[0]?.file,r=e.tsc.topErrors[0]??e.biome.topErrors[0]??`reported errors`;t&&n.push({tool:`compact`,reason:`Inspect failing code with compact({ path: ${JSON.stringify(t)}, query: ${JSON.stringify(r)} })`,suggested_args:{path:t,query:r}}),n.push({tool:`check`,reason:`Re-check after fixing errors`,suggested_args:{detail:`normal`}})}let r=[`## Check ${e.passed?`✅ PASS`:`❌ FAIL`}`,``,`**tsc**: ${e.tsc.passed?`✅`:`❌`} ${e.tsc.errorCount} errors, ${e.tsc.warningCount} warnings`];if(e.tsc.topErrors.length>0)for(let t of e.tsc.topErrors)r.push(` - ${t}`);if(r.push(`**biome**: ${e.biome.passed?`✅`:`❌`} ${e.biome.errorCount} errors, ${e.biome.warningCount} warnings`),e.biome.topErrors.length>0)for(let t of e.biome.topErrors)r.push(` - ${t}`);if(n.length>0){r.push(``,`**Next steps:**`);for(let e of n)r.push(`- \`${e.tool}\`: ${e.reason}`)}let i=r.join(`
|
|
159
|
+
`);if(s&&t){let e=await q(t,{query:`known issues failures`});i+=J(e)}return{content:[{type:`text`,text:i}],structuredContent:{...e}}}let f=JSON.stringify(u);if(s&&t){let e=await q(t,{query:`known issues failures`});f+=J(e)}return{content:[{type:`text`,text:f}]}}catch(e){return Ql.error(`Check failed`,R(e)),Y(`INTERNAL`,`Check failed: ${e instanceof Error?e.message:String(e)}`)}}))}function eu(e){let t=K(`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:B.string().max(1e5).describe(`Code snippet to execute`),lang:B.enum([`js`,`ts`]).default(`js`).optional().describe(`Language mode: js executes directly, ts strips common type syntax first`),timeout:B.number().min(1).max(6e4).default(5e3).optional().describe(`Execution timeout in milliseconds`)},annotations:t.annotations},X(`eval`,async({code:e,lang:t,timeout:n})=>{try{let r=await ut({code:e,lang:t,timeout:n});return r.success?{content:[{type:`text`,text:`Eval succeeded in ${r.durationMs}ms\n\n${r.output}`}]}:Y(`INTERNAL`,`Eval failed in ${r.durationMs}ms: ${r.error??`Unknown error`}`)}catch(e){return Ql.error(`Eval failed`,R(e)),Y(`INTERNAL`,`Eval failed: ${e instanceof Error?e.message:String(e)}`)}}))}function tu(e,t){let n=K(`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:B.array(B.string()).optional().describe(`Specific test files or patterns to run`),grep:B.string().optional().describe(`Only run tests whose names match this pattern`),cwd:B.string().optional().describe(`Working directory for the test run`),enrich:B.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:oc},X(`test_run`,async({files:e,grep:n,cwd:r,enrich:i},a)=>{try{let o=await Cn({files:e,grep:n,cwd:r}),s=Wc(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=iu(o);if(i&&t){let e=await q(t,{query:`test patterns known failures`});l+=J(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 Ql.error(`Test run failed`,R(e)),Y(`INTERNAL`,`Test run failed: ${e instanceof Error?e.message:String(e)}`)}}))}function nu(e){let t=K(`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:B.string().max(5e5).describe(`Raw output text from a build tool`),tool:B.enum([`tsc`,`vitest`,`biome`,`git-status`]).optional().describe(`Tool to parse as (auto-detects if omitted)`)},annotations:t.annotations},async({output:e,tool:t})=>{try{let n=It(e.replace(/\\n/g,`
|
|
160
|
+
`).replace(/\\t/g,` `),t);return{content:[{type:`text`,text:JSON.stringify(n)}]}}catch(e){return Ql.error(`Parse failed`,R(e)),Y(`INTERNAL`,`Parse failed: ${e instanceof Error?e.message:String(e)}`)}})}function ru(e,t){let n=K(`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:B.string().max(2e5).describe(`The task or question to send to the local model`),model:B.string().optional().describe(`Ollama model name (default: first available model)`),system:B.string().optional().describe(`System prompt for the model`),context:B.string().max(5e5).optional().describe(`Context text to include before the prompt (e.g. file contents)`),temperature:B.number().min(0).max(2).default(.3).optional().describe(`Sampling temperature (0=deterministic, default 0.3)`),timeout:B.number().min(1e3).max(6e5).default(12e4).optional().describe(`Timeout in milliseconds (default 120000)`),action:B.enum([`generate`,`list_models`]).default(`generate`).optional().describe(`Action: generate a response or list available models`)},annotations:n.annotations},async({prompt:e,model:n,system:r,context:i,temperature:a,timeout:o,action:s})=>{try{if(s===`list_models`){let e=await rt();return{content:[{type:`text`,text:JSON.stringify({models:e,count:e.length,_Next:`Use delegate with a model name`},null,2)}]}}if(t?.available)try{let n=await t.createMessage({prompt:e,systemPrompt:r,context:i,maxTokens:4e3,modelPreferences:{intelligencePriority:.8,speedPriority:.5,costPriority:.3}});return{content:[{type:`text`,text:JSON.stringify({model:n.model??`sampling`,response:n.text,provider:`mcp-sampling`,_Next:`Use the response in your workflow. stash to save it.`},null,2)}]}}catch{Ql.debug(`Sampling failed, falling back to Ollama`)}let c=await nt({prompt:e,model:n,system:r,context:i,temperature:a,timeout:o});return c.error?Y(`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 Ql.error(`Delegate failed`,R(e)),Y(`INTERNAL`,`Delegate failed: ${e instanceof Error?e.message:String(e)}`)}})}function iu(e){let t=[`Vitest run: ${e.passed?`passed`:`failed`}`,`Duration: ${e.durationMs}ms`,`Passed: ${e.summary.passed}`,`Failed: ${e.summary.failed}`,`Skipped: ${e.summary.skipped}`];e.summary.suites!==void 0&&t.push(`Suites: ${e.summary.suites}`);let n=e.summary.tests.filter(e=>e.status===`fail`);if(n.length>0){t.push(``,`Failed tests:`);for(let e of n)t.push(`- ${e.name}${e.file?` (${e.file})`:``}`),e.error&&t.push(` ${e.error}`)}return t.join(`
|
|
161
|
+
`)}const au=L(`sampling`);function ou(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 su(e){if(Array.isArray(e))return e.map(e=>su(e)).filter(e=>e.length>0).join(`
|
|
162
|
+
`);if(e&&typeof e==`object`&&`type`in e){let t=e;if(t.type===`text`&&typeof t.text==`string`)return t.text}return JSON.stringify(e)}function cu(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:ou(e),maxTokens:e.maxTokens??4e3});return{text:su(n.content),model:n.model,stopReason:n.stopReason}}catch(e){throw au.warn(`Sampling createMessage failed`,{error:String(e)}),e}}}}const lu=[],uu=[`_docs-sync`],du=new Map([[`_docs-sync`,`Synchronize project documentation — update docs/ folder based on changes made during the flow.`]]);function fu(e){function t(t,n,r){let i=n?.installPath?he(n.installPath):t.replaceAll(`:`,`-`),a=I(Rn(),`.copilot`,`flows`,i).replaceAll(`\\`,`/`);if(M(a))return a;let o=I(Rn(),`.claude`,`flows`,i).replaceAll(`\\`,`/`);if(M(o))return o;let s=I(r??e(),`.github`,`flows`,i).replaceAll(`\\`,`/`);return M(s)?s:n?.installPath&&M(n.installPath)?n.installPath.replaceAll(`\\`,`/`):null}function n(e,n,r){let i=t(e.name,e,r);return i?I(i,n).replaceAll(`\\`,`/`):n}function r(t,n){let r=t.replace(/^_/,``),i=n??e(),a=[F(i,`.github`,`flows`,`_epilogue`,`steps`,r,`README.md`),F(i,`.github`,`flows`,`_epilogue`,r,`README.md`)];for(let e of a)if(M(e))return e.replaceAll(`\\`,`/`);return null}function i(e){return[...lu,...e.manifest.steps.map(e=>e.id),...uu]}function a(e,t,r){let i=t?e.manifest.steps.find(e=>e.id===t)??null:null,a=t?du.get(t)??null:null;return{currentStep:i,epilogueStep:a?{id:t,description:a}:null,instructionPath:i&&t?n(e,i.instruction,r):null,description:i?.description??a}}function o(){try{let e=F(Cr(`npm root -g`,{encoding:`utf-8`}).trim(),`@fission-ai`,`openspec`);if(M(e))return{path:e,sourceType:`npm-global`,isGit:!1}}catch{}return{path:`https://github.com/Fission-AI/OpenSpec.git`,sourceType:`git`,isGit:!0}}function s(e){let t=I(e);if(M(F(t,`.claude-plugin`,`plugin.json`)))return{path:t,sourceType:`claude-plugin`};let n=Rn(),r=F(n,`.claude`,`plugins`,e);if(M(F(r,`.claude-plugin`,`plugin.json`)))return{path:r,sourceType:`claude-plugin`};let i=F(n,`.claude`,`plugins`);if(!M(i))return null;for(let t of le(i,{withFileTypes:!0})){if(!t.isDirectory())continue;let n=F(i,t.name,`.claude-plugin`,`plugin.json`);if(M(n))try{if(JSON.parse(P(n,`utf-8`)).name===e)return{path:F(i,t.name),sourceType:`claude-plugin`}}catch{}}return null}return{resolveInstallPath:t,resolveInstructionPath:n,resolveEpilogueInstructionPath:r,getStepSequence:i,resolveCurrentStepInfo:a,resolveOpenSpecSource:o,resolveClaudePluginSource:s}}function pu(e){function t(){return e.sources?.[0]?.path??process.cwd()}function n(){return e.allRoots?.length?e.allRoots:[t()]}function r(e){return e.map(e=>e.replaceAll(`\\`,`/`))}function i(e){let t=[];try{let n=le(e,{withFileTypes:!0});for(let r of n){if(!r.isDirectory()||r.name.startsWith(`.`))continue;let n=F(e,r.name);M(F(n,`.git`))&&t.push(n)}}catch{}return t}function a(){let e=n(),t=new Set(e);for(let n of e)for(let e of i(n))t.add(e);return[...t]}function o(e){let t=e.replaceAll(`\\`,`/`);if(r(a()).includes(t))return!0;let i=r(n());for(let n of i)if(t.startsWith(`${n}/`)&&M(F(e,`.git`)))return!0;return!1}function s(e){return F(e??t(),`.flows`)}async function c(){let e=a();for(let t of e){let e=s(t);if(M(e))for(let n of le(e,{withFileTypes:!0})){if(!n.isDirectory())continue;let r=F(e,n.name,`meta.json`);if(M(r))try{let e=JSON.parse(P(r,`utf-8`));if(e.status===`active`)return e.primaryRoot?e.primaryRoot:t}catch{}}}return null}async function l(e){return e||(await c()??t())}function u(){let e=t(),i=r(n()),o=a(),s=r(o),c=s.filter(e=>!i.includes(e));return{workspaceRoot:e,allRoots:o,normalizedAllRoots:s,discoveredRepos:c.length>0?c:void 0}}function d(e,t,n){let r=F(s(t),e,`meta.json`),i=P(r,`utf-8`),a=JSON.parse(i);a.roots=n.map(e=>e.replaceAll(`\\`,`/`)),a.primaryRoot=t.replaceAll(`\\`,`/`);let o=`${r}.tmp`;me(o,JSON.stringify(a,null,2),`utf-8`),ue(o,r)}function f(e,t){let n=F(s(t),e,`meta.json`);if(!M(n))return;let r=P(n,`utf-8`),i=JSON.parse(r),a=i.roots;if(!a||a.length<=1)return;let o=t.replaceAll(`\\`,`/`);for(let t of a){if(t===o)continue;let n=F(t,`.flows`,e);N(n,{recursive:!0});let a=F(n,`meta.json`),s=`${a}.tmp`;me(s,r,`utf-8`),ue(s,a),N(F(n,i.artifactsDir??`.spec`),{recursive:!0})}}return{getWorkspaceRoot:t,getAllRoots:a,getFlowsDir:s,isValidFlowRoot:o,resolveFlowRoot:l,resolveRoots:u,patchMetaRoots:d,syncMetaToRoots:f}}const mu={name:`flow-context`,order:40,maxTokens:120,runInBrief:!1,async execute(e){let t=["**Flow Context:** Call `knowledge({ action: 'withdraw', scope: 'flow', profile: 'implementer', budget: 4000 })` as FIRST action for prior context.","Remember decisions: `knowledge({ action: 'remember', title: '...', content: '...', category: 'flow-context', scope: 'flow' })`"];e.completedSteps.length>0&&t.push(`Completed steps: ${e.completedSteps.join(`, `)}`);let n=t.join(`
|
|
163
|
+
`);return{content:n,tokens:Math.ceil(n.length/4)}}};function hu(e){return{name:`knowledge-recall`,order:20,maxTokens:200,runInBrief:!1,async execute(t){if(!e.store)return null;let n=[t.stepDescription,t.topic].filter(e=>typeof e==`string`&&e.trim().length>0);if(n.length===0)return null;let r=[...n,t.flowName].filter(Boolean).join(` `);if(!r.trim())return null;try{let t=await e.store.search(r,{limit:3});if(!t||t.length===0)return null;let n=t.map(e=>`• ${e.content.slice(0,200)}`).join(`
|
|
164
|
+
`),i=Math.ceil(n.length/4);return{content:`**Recalled Knowledge:**\n${n}`,tokens:Math.min(i,200)}}catch{return null}}}}const gu=[`**Read Code:** Structure → file_summary(). Specific section → compact(path, query).`,`Multiple files → digest(). Cached ref → compact(ref, query?). Repeated file ref → stratum_card(). Edit lines → read_file().`,`NEVER read_file >50 lines to understand. Use search() for discovery.`].join(` `),_u={name:`token-efficiency`,order:30,maxTokens:80,runInBrief:!1,runOnce:!0,async execute(e){return{content:gu,tokens:25}}},vu=[`**Tool Routing:** search() not grep_search. file_summary() or compact() not read_file (for understanding).`,`check() not terminal tsc/lint. test_run() not terminal test. trace() for data flow.`,`read_file ONLY for exact lines before editing. symbol() for definition+refs.`].join(` `),yu={name:`tool-routing`,order:10,maxTokens:100,runInBrief:!0,runOnce:!0,async execute(e){return{content:vu,tokens:30}}};function bu(e,t){return Promise.race([e,new Promise(e=>setTimeout(()=>e(null),t))])}var xu=class{hooks=[];firedOnce=new Set;sealed=!1;log;constructor(e){this.log=e?.log}seal(){this.sealed=!0}register(e){if(this.sealed){this.log?.warn(`Attempted to register hook "%s" on sealed pipeline`,e.name);return}this.hooks.push(e),this.hooks.sort((e,t)=>e.order-t.order)}get hookCount(){return this.hooks.length}async enrich(e,t,n){let r=this.resolveBudget(t.mode,n),i=new Set(n?.disable??[]),a=this.hooks.filter(e=>!(i.has(e.name)||t.mode===`brief`&&!e.runInBrief||e.runOnce&&this.firedOnce.has(e.name)));if(a.length===0)return e;let o=[],s=0;for(let e of a){if(s>=r){this.log?.debug(`[step-hooks] Budget exhausted (${s}/${r}), skipping remaining hooks`);break}try{let n=await bu(e.execute(t),5e3);if(!n||n.content.length===0)continue;e.runOnce&&this.firedOnce.add(e.name);let i=n.content.replace(/<\/(step-context|step-hints)>/gi,``);if(i.length===0)continue;let a=this.truncateToTokens(i,e.maxTokens),c=Math.min(n.tokens,e.maxTokens);if(s+c<=r){o.push({content:a,tokens:c}),s+=c;continue}let l=r-s;if(l<=0)break;o.push({content:this.truncateToTokens(a,l),tokens:l}),s=r}catch(t){this.log?.warn(`[step-hooks] Hook "${e.name}" failed: ${t instanceof Error?t.message:String(t)}`)}}if(o.length===0)return e;let c=t.mode===`full`?`<step-context>`:`<step-hints>`,l=t.mode===`full`?`</step-context>`:`</step-hints>`;return`${e}\n\n${c}\n${o.map(e=>e.content).join(`
|
|
165
165
|
|
|
166
|
-
`)}\n${l}`}resolveBudget(e,t){return e===`full`?t?.tokenBudget?.full??500:t?.tokenBudget?.brief??150}truncateToTokens(e,t){let n=t*4;return e.length<=n?e:`${e.slice(0,n).trimEnd()}…`}};function
|
|
166
|
+
`)}\n${l}`}resolveBudget(e,t){return e===`full`?t?.tokenBudget?.full??500:t?.tokenBudget?.brief??150}truncateToTokens(e,t){let n=t*4;return e.length<=n?e:`${e.slice(0,n).trimEnd()}…`}};function Su(e={}){let t=new xu({log:e.log});return t.register(yu),t.register(hu({store:e.store,graphStore:e.graphStore,embedder:e.embedder})),t.register(_u),t.register(mu),t.seal(),t}const Cu=L(`flow-tools`);function wu(e){return Array.isArray(e)?e.filter(e=>typeof e==`string`&&e.trim().length>0):[]}function Tu(e){return{content:[{type:`text`,text:e}]}}function Eu(e){return e instanceof Error?e.message:String(e)}const Du={before:[],after:[{id:`_docs-sync`,description:`Synchronize project documentation — update docs/ folder based on changes made during the flow.`,position:`after`,skills:[`docs`]}]};function Ou(e,t,n){let r=pu(t),i=fu(r.getWorkspaceRoot),a=Su({store:n?.store,graphStore:n?.graphStore,embedder:n?.embedder,log:Cu});function o(){return F(Me(),`flows`,`registry.json`)}function s(){let t=cu(e);return async({content:e,sourceFormat:n,stepName:r,metadata:i})=>{let a=r.charAt(0).toUpperCase()+r.slice(1),o=i?JSON.stringify(i,null,2):void 0,s=`You are converting a flow step definition from "${n}" format to aikit native flow step README.md format.
|
|
167
167
|
|
|
168
168
|
Convert the provided content into a well-structured README.md for a flow step named "${r}".
|
|
169
169
|
|
|
@@ -176,23 +176,23 @@ The output must:
|
|
|
176
176
|
6. Preserve ALL tool restrictions, constraints, and requirements from the source
|
|
177
177
|
7. Be formatted as clean Markdown
|
|
178
178
|
|
|
179
|
-
Output ONLY the README.md content, nothing else.`;if(t.available)try{let i=(await t.createMessage({prompt:e,systemPrompt:s,context:o?`Step name: ${r}\nSource format: ${n}\nMetadata:\n${o}`:`Step name: ${r}\nSource format: ${n}`,maxTokens:4096,modelPreferences:{intelligencePriority:.8,speedPriority:.4,costPriority:.2}})).text.trim();if(i.length>0)return i}catch(e){
|
|
179
|
+
Output ONLY the README.md content, nothing else.`;if(t.available)try{let i=(await t.createMessage({prompt:e,systemPrompt:s,context:o?`Step name: ${r}\nSource format: ${n}\nMetadata:\n${o}`:`Step name: ${r}\nSource format: ${n}`,maxTokens:4096,modelPreferences:{intelligencePriority:.8,speedPriority:.4,costPriority:.2}})).text.trim();if(i.length>0)return i}catch(e){Cu.debug(`Flow transform sampling failed; using fallback formatting`,{error:Eu(e),sourceFormat:n,stepName:r})}let c=typeof i?.description==`string`&&i.description.trim().length>0?i.description.trim():null,l=wu(i?.produces),u=wu(i?.requires);return[`# ${a}`,``,`## Purpose`,``,c??`${a} step.`,``,`## Instructions`,``,e.trim(),``,`## Artifacts`,``,...l.length>0?l.map(e=>`- ${e}`):[`- ${r}.md`],...u.length>0?[``,`## Prerequisites`,``,...u.map(e=>`- ${e}`)]:[],``].join(`
|
|
180
180
|
`).trimEnd().concat(`
|
|
181
|
-
`)}}async function c(e){let{FlowRegistryManager:n,FlowStateMachine:i,FlowLoader:a,GitInstaller:s}=await import(`../../flows/dist/index.js`),c=F(t.stateDir??``,`flows`,`installed`);return{registry:new n(o()),stateMachine:new i(r.getFlowsDir(e),
|
|
182
|
-
`),t.lastIndexOf(` `),t.lastIndexOf(` `));return`${(n>=Math.floor(t.length*.6)?t.slice(0,n):t).trimEnd()}…`}function
|
|
181
|
+
`)}}async function c(e){let{FlowRegistryManager:n,FlowStateMachine:i,FlowLoader:a,GitInstaller:s}=await import(`../../flows/dist/index.js`),c=F(t.stateDir??``,`flows`,`installed`);return{registry:new n(o()),stateMachine:new i(r.getFlowsDir(e),Du),loader:new a,installer:new s(c)}}return{server:e,config:t,log:Cu,toTextResponse:Tu,toErrorText:Eu,createFlowTransform:s,getFlows:c,stepPipeline:a,stateDir:t.stateDir??``,...r,...i}}var ku=class extends Error{code;constructor(e,t){super(t),this.code=e,this.name=`FlowError`}};function Au(e){return e instanceof ku}async function ju(e){let{entry:t,stepId:n,runDir:r,slug:i,primaryRoot:a,roots:o,activeRoot:s,resolveInstructionPath:c,resolveEpilogueInstructionPath:l}=e;if(!n)return null;try{let e=t.manifest.steps.find(e=>e.id===n||e.name===n),u;if(e)u=await Mn(c(t,e.instruction,s),`utf-8`);else{let e=l(n,s);if(!e)return null;u=await Mn(e,`utf-8`)}let d=F(r,t.manifest.artifacts_dir).replaceAll(`\\`,`/`),f=r.replaceAll(`\\`,`/`);u=u.replaceAll(`{{artifacts_path}}`,d).replaceAll(`{{run_dir}}`,f).replaceAll(`{{workspace_root}}`,(a??s).replaceAll(`\\`,`/`)).replaceAll(`{{all_roots}}`,JSON.stringify(o??[s.replaceAll(`\\`,`/`)],null,2));for(let e of[`spec-driven`])u=u.replaceAll(`${e}/${i}/`,`${d}/`);return u}catch{return null}}async function Mu(e,t){let{getFlows:n,log:r,resolveEpilogueInstructionPath:i,resolveFlowRoot:a,resolveInstructionPath:o,stepPipeline:s,toErrorText:c,toTextResponse:l}=t,{step:u}=e;try{let e=await a(),{registry:t,stateMachine:r}=await n(e),c=r.getStatus();if(!c.success||!c.data)throw new ku(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let d=c.data,f=t.get(d.flow);if(!f)throw new ku(`FLOW_NOT_FOUND`,`Flow "${d.flow}" not found in registry.`);let p=u??d.currentStep;if(!p)throw new ku(`STEP_OUT_OF_RANGE`,`No current step is available for the active flow.`);let m=await ju({entry:f,stepId:p,runDir:d.runDir,slug:d.slug,primaryRoot:d.primaryRoot,roots:d.roots,activeRoot:e,resolveInstructionPath:o,resolveEpilogueInstructionPath:i});if(!m)throw new ku(`STEP_OUT_OF_RANGE`,`Step "${p}" not found in flow "${d.flow}".`);let h=f.manifest.steps.find(e=>e.id===p||e.name===p),g=F(d.runDir,f.manifest.artifacts_dir).replaceAll(`\\`,`/`),_={stepId:p,flowName:d.flow,flowSlug:d.slug,phase:d.phase??`flow`,runDir:d.runDir,artifactsPath:g,completedSteps:d.completedSteps??[],stepDescription:h?.description,agents:h?.agents??[],mode:`full`,topic:d.topic??``,activeRoot:e};return l(await s.enrich(m,_,f.manifest.hooks))}catch(e){return Au(e)?l(e.message):(r.error(`flow action read failed`,R(e)),e instanceof Error&&`code`in e&&e.code===`ENOENT`?l(`Could not read instruction file: ${e.message}`):l(`Error: ${c(e)}`))}}async function Nu(e,t){let{registry:n,loader:r,installer:i}=await e.getFlows(),a=e.createFlowTransform(),o=I(t.source);if(!M(o))return e.toTextResponse(`Source path no longer exists: ${o}`);let s=`${t.installPath}.updating`,c=`${t.installPath}.backup`;M(s)&&de(s,{recursive:!0,force:!0}),M(c)&&de(c,{recursive:!0,force:!0});let l=i.copyLocal(o,he(s));if(!l.success||!l.data)return e.toTextResponse(`Failed to copy flow: ${l.error}`);let u=await r.load(s,{forceAssetSync:!0,transform:a});if(!u.success||!u.data)return i.remove(s),e.toTextResponse(`Failed to load flow manifest: ${u.error}`);let d=!1;try{ue(t.installPath,c),ue(s,t.installPath);let e=await r.load(t.installPath,{forceAssetSync:!0,transform:a});if(!e.success||!e.data)throw Error(`Failed to load flow manifest: ${e.error}`);let o=e.data.manifest,l=e.data.format,u=n.register({...t,version:o.version,format:l,installPath:t.installPath,manifest:o,updatedAt:new Date().toISOString()});if(!u.success)throw Error(`Failed to refresh flow registry entry: ${u.error}`);if(d=!0,o.install.length>0){let e=i.runInstallDeps(o.install);if(!e.success)throw Error(`Dependency install failed: ${e.error}`)}de(c,{recursive:!0,force:!0})}catch(r){return M(s)&&de(s,{recursive:!0,force:!0}),M(c)&&(M(t.installPath)&&de(t.installPath,{recursive:!0,force:!0}),ue(c,t.installPath)),d&&n.register(t),e.toTextResponse(e.toErrorText(r))}return e.toTextResponse(`Flow "${t.name}" updated from ${t.sourceType} source successfully.`)}async function Pu(e,t){let{registry:n,loader:r}=await e.getFlows(),i=e.createFlowTransform();try{Cr(`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 Fu(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 Iu(e,t){let{createFlowTransform:n,getFlows:r,log:i,resolveClaudePluginSource:a,resolveOpenSpecSource:o,toErrorText:s,toTextResponse:c}=t,{source:l,name:u,token:d}=e;try{let{registry:e,loader:t,installer:i}=await r(),s=n(),f=l===`openspec`||l.startsWith(`openspec:`),p,m=l,h;if(f){let e=o();m=e.path,p=e.sourceType}let g=f?null:a(m);g&&(m=g.path,p=g.sourceType);let _=/^https?:\/\/|^git@/.test(m),v;if(_){let e=i.clone(m,d);if(!e.success||!e.data)return c(`Failed to clone flow: ${e.error}`);v=e.data}else{let e=I(m);h=e;let t=u||he(e)||`custom-flow`,n=i.copyLocal(e,t);if(!n.success||!n.data)return c(`Failed to copy flow: ${n.error}`);v=n.data}let y=await t.load(v,{forceAssetSync:!0,transform:s});if(!y.success||!y.data)return i.remove(v),c(`Failed to load flow manifest: ${y.error}`);let{manifest:b,format:x}=y.data,S=u||b.name,C=p??(_?`git`:`local`);if(e.has(S))return i.remove(v),c(`Flow "${S}" is already installed. Use flow({ action: "update", name: "${S}" }) to update it, or flow({ action: "remove", name: "${S}" }) then flow({ action: "add", source: "..." }) to replace.`);if(b.install.length>0){let e=i.runInstallDeps(b.install);if(!e.success)return i.remove(v),c(`Dependency install failed: ${e.error}`)}let w=new Date().toISOString(),T=_?i.getLocalCommit(v):void 0,E=e.register({name:S,version:b.version,source:C===`local`||C===`claude-plugin`?h??l:l,sourceType:C,installPath:v,format:x,registeredAt:w,updatedAt:w,manifest:b,...T?{commitSha:T}:{}});if(!E.success)return i.remove(v),c(`Failed to register flow: ${E.error}`);let D=b.steps.length;return c(`Flow "${S}" installed successfully (${D} steps). Use flow({ action: "start", name: "${S}" }) to begin.`)}catch(e){return i.error(`flow action add failed`,R(e)),c(`Error: ${s(e)}`)}}async function Lu(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`,R(e)),a(`Error: ${i(e)}`)}}async function Ru(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`?Nu(s,t):t.sourceType===`npm-global`?Pu(s,t):Fu(s,t)}catch(e){return r.error(`flow action update failed`,R(e)),a(`Error: ${i(e)}`)}}const zu=`IMPORTANT: Start/status/step only include a brief. Call flow({ action: "read" }) before executing this flow step.`,Bu=1200,Vu=/artifact|output contract|gate|completion criteria|deliverable|must|do not|forbidden/i;function Hu(){return{artifactsPath:null,currentStepInstruction:null,currentStepDescription:null,currentStepContent:null,currentStepBrief:null,currentStepPins:null,stepSequence:[]}}function Uu(e){if(e.length<=Bu)return e;let t=e.slice(0,Bu-1),n=Math.max(t.lastIndexOf(`
|
|
182
|
+
`),t.lastIndexOf(` `),t.lastIndexOf(` `));return`${(n>=Math.floor(t.length*.6)?t.slice(0,n):t).trimEnd()}…`}function Wu(e){if(!e?.trim())return{brief:null,pins:null};let t=/^##\s+/m.exec(e),n=(t?e.slice(0,t.index):e).trim(),r=null;if(n){let e=n.split(/\n\s*\n/).filter(e=>e.trim().length>0),t=(e[0]?.startsWith(`#`)&&e[1]?e.slice(0,2):e.slice(0,1)).join(`
|
|
183
183
|
|
|
184
|
-
`).trim();r=t?
|
|
184
|
+
`).trim();r=t?Uu(t):null}let i=Array.from(e.matchAll(/^##\s+.*$/gm)),a=[];for(let[t,n]of i.entries()){let r=n[0];if(!Vu.test(r))continue;let o=n.index??0,s=i[t+1]?.index??e.length;a.push(e.slice(o,s).replace(/\s+$/,``))}return{brief:r,pins:a.length>0?a.join(`
|
|
185
185
|
|
|
186
|
-
`):null}}function Wu(e,t){return t(e)}async function Gu(e){let{context:t,entry:n,state:r,activeRoot:i,primaryRoot:a,roots:o}=e,{instructionPath:s,description:c}=t.resolveCurrentStepInfo(n,r.currentStep,i),l=Wu(n,t.getStepSequence),u=await Au({entry:n,stepId:r.currentStep,runDir:r.runDir,slug:r.slug,primaryRoot:a,roots:o,activeRoot:i,resolveInstructionPath:t.resolveInstructionPath,resolveEpilogueInstructionPath:t.resolveEpilogueInstructionPath}),{brief:d,pins:f}=Uu(u),p=d;if(d&&r.currentStep){let e=n.manifest.steps.find(e=>e.id===r.currentStep),a={stepId:r.currentStep,flowName:r.flow,flowSlug:r.slug,phase:`flow`,runDir:r.runDir,artifactsPath:F(r.runDir,n.manifest.artifacts_dir).replaceAll(`\\`,`/`),completedSteps:r.completedSteps??[],stepDescription:e?.description??c??void 0,agents:e?.agents??[],mode:`brief`,topic:r.topic??``,activeRoot:i};p=await t.stepPipeline.enrich(d,a,n.manifest.hooks)}return{artifactsPath:F(r.runDir,n.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStepInstruction:s,currentStepDescription:c,currentStepContent:u,currentStepBrief:p,currentStepPins:f,stepSequence:l}}function Ku(e){let{state:t,data:n,started:r,includeStatus:i,action:a,includeInstructionPath:o}=e,s={};return r&&(s.started=!0),s.flow=t.flow,t.flowOrigin&&(s.flowOrigin=t.flowOrigin),i&&(s.status=t.status),a&&(s.action=a),s.slug=t.slug,s.topic=t.topic,s.runDir=t.runDir,s.artifactsPath=n.artifactsPath,s.currentStep=t.currentStep,s.currentStepInstruction=n.currentStepInstruction,o&&(s.instructionPath=n.currentStepInstruction),s.currentStepDescription=n.currentStepDescription,s.currentStepContent=null,s.currentStepBrief=n.currentStepBrief,s.currentStepPins=n.currentStepPins,s.fullContentHint=`Call flow({ action: 'read' }) for the complete step instructions.`,s}function qu(e){return e.sourceType===`local`?{source:`local`,sourceType:e.sourceType,format:e.format,...e.commitSha?{commitSha:e.commitSha}:{}}:{source:e.source,sourceType:e.sourceType,format:e.format,...e.commitSha?{commitSha:e.commitSha}:{}}}async function Ju(e,t){let{getAllRoots:n,getFlows:r,getWorkspaceRoot:i,isValidFlowRoot:a,log:o,patchMetaRoots:s,stateDir:c,toErrorText:l,toTextResponse:u}=t,{flow:d,topic:f,roots:p}=e;try{if(p&&p.length>0){let e=n().map(e=>e.replaceAll(`\\`,`/`)),t=p.filter(e=>!a(e));if(t.length>0)return u(`Invalid roots — not part of the workspace or a recognized sub-repository: ${t.join(`, `)}. Available roots: ${e.join(`, `)}`)}let e=n(),o=e.map(e=>e.replaceAll(`\\`,`/`)),l=i(),m=e.length>1,h=!p&&m,g=p?.[0]??l,{registry:_,stateMachine:v}=await r(g),y=_.get(d);if(!y)throw new Ou(`UNKNOWN_FLOW`,`Flow "${d}" not found. Use flow({ action: "list" }) to see available flows.`);let b=v.start(y.name,y.manifest,f,qu(y));if(!b.success||!b.data){let e=b.error??`Unknown flow start error.`;return e.includes(`already active`)?u(`Cannot start: ${new Ou(`FLOW_ALREADY_ACTIVE`,e).message}`):u(`Cannot start: ${e}`)}let x=b.data;if(p&&p.length>1)try{s(x.slug,g,p),t.syncMetaToRoots(x.slug,g)}catch(e){return v.reset(),u(`Flow created but failed to sync to secondary roots — rolled back. Error: ${e instanceof Error?e.message:String(e)}`)}let S=F(c,`flow-context`),C=typeof Pn==`function`?await Pn(S).catch(()=>[]):[];for(let e of C)e!==x.slug&&typeof Fn==`function`&&await Fn(F(S,e),{recursive:!0,force:!0}).catch(()=>{});if(typeof Mn==`function`)try{await Mn(F(S,x.slug),{recursive:!0})}catch{}let w=await Gu({context:t,entry:y,state:x,activeRoot:g,primaryRoot:null,roots:p??null}),T={...Ku({state:x,data:w,started:!0}),phase:x.phase,isEpilogue:x.isEpilogue,totalSteps:w.stepSequence.length,stepSequence:w.stepSequence,artifactsDir:y.manifest.artifacts_dir,roots:p??[g.replaceAll(`\\`,`/`)],_hint:Ru,...h?{multiRootWarning:`No roots specified in multi-root workspace. Flow created at workspace root. Pass roots parameter with target repo for precise placement.`,availableRoots:o}:{}};return u(JSON.stringify(T,null,2))}catch(e){return ku(e)?u(e.message):(o.error(`flow action start failed`,R(e)),u(`Error: ${l(e)}`))}}async function Yu(e){let{getFlows:t,log:n,resolveFlowRoot:r,resolveRoots:i,toErrorText:a,toTextResponse:o}=e;try{let n=await r(),{registry:a,stateMachine:s}=await t(n),c=s.getStatus();if(!c.success||!c.data)throw new Ou(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let l=c.data,u=a.get(l.flow),d=u?await Gu({context:e,entry:u,state:l,activeRoot:n,primaryRoot:l.primaryRoot,roots:l.roots}):Vu(),f={...Ku({state:l,data:d,includeStatus:!0,includeInstructionPath:!0}),_hint:l.currentStep?Ru:void 0,phase:l.phase,isEpilogue:l.isEpilogue,completedSteps:l.completedSteps,skippedSteps:l.skippedSteps,artifacts:l.artifacts,startedAt:l.startedAt,updatedAt:l.updatedAt,totalSteps:d.stepSequence.length,progress:u?`${l.completedSteps.length+l.skippedSteps.length}/${d.stepSequence.length}`:`unknown`,workspaceRoot:n.replaceAll(`\\`,`/`),primaryRoot:(l.primaryRoot??n).replaceAll(`\\`,`/`),roots:l.roots??[n.replaceAll(`\\`,`/`)],allRoots:i().normalizedAllRoots,discoveredRepos:i().discoveredRepos};return o(JSON.stringify(f,null,2))}catch(e){return ku(e)?o(e.message):(n.error(`flow action status failed`,R(e)),o(`Error: ${a(e)}`))}}async function Xu(e){let{getFlows:t,log:n,resolveFlowRoot:r,stateDir:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=e;try{let e=await r(),{stateMachine:n}=await t(e),o=n.getStatus(),c=n.reset();if(!c.success)return s(`Reset failed: ${c.error}`);if(o.success&&o.data&&a(o.data.slug,e),o.success&&o.data?.slug)try{await Fn(F(i,`flow-context`,o.data.slug),{recursive:!0,force:!0})}catch{}return s(`Flow abandoned. Use flow({ action: "start", name: "<flow>" }) to begin a new flow.`)}catch(e){return n.error(`flow action reset failed`,R(e)),s(`Error: ${o(e)}`)}}async function Zu(e,t){let{getFlows:n,log:r,resolveFlowRoot:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=t,{action:c}=e;try{let e=await i(),{registry:r,stateMachine:o}=await n(e),l=o.getStatus();if(!l.success||!l.data)throw new Ou(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let u=r.get(l.data.flow);if(!u)throw new Ou(`FLOW_NOT_FOUND`,`Flow "${l.data.flow}" not found in registry.`);let d=o.step(c,u.manifest);if(!d.success||!d.data)return s(`Cannot ${c}: ${d.error}`);a(d.data.slug,e);let f=d.data,p=[];if(f.status===`completed`){let e=F(t.stateDir,`flow-context`,f.slug);for(let t of[`decision`,`pattern`]){let n=F(e,t);try{let e=await Pn(n);for(let r of e){if(!r.endsWith(`.md`))continue;let e=await Nn(F(n,r),`utf-8`);e.length>100&&p.push({type:t,title:r.replace(/\.md$/,``).replace(/-/g,` `),content:e.length>500?`${e.slice(0,497)}...`:e})}}catch{}}typeof Fn==`function`&&await Fn(e,{recursive:!0,force:!0}).catch(()=>{})}let m=await Gu({context:t,entry:u,state:f,activeRoot:e,primaryRoot:f.primaryRoot,roots:f.roots}),h={...Ku({state:f,data:m,includeStatus:!0,action:c}),_hint:f.currentStep?Ru:void 0,phase:f.phase,isEpilogue:f.isEpilogue,completedSteps:f.completedSteps,skippedSteps:f.skippedSteps,totalSteps:m.stepSequence.length,remaining:m.stepSequence.filter(e=>!f.completedSteps.includes(e)&&!f.skippedSteps.includes(e)&&e!==f.currentStep),...p.length>0?{promotionCandidates:p}:{}};return s(JSON.stringify(h,null,2))}catch(e){return ku(e)?s(e.message):(r.error(`flow action step failed`,R(e)),s(`Error: ${o(e)}`))}}async function Qu(e){let{getFlows:t,log:n,resolveFlowRoot:r,resolveRoots:i,toErrorText:a,toTextResponse:o}=e;try{let{registry:e,stateMachine:n,installer:a}=await t(await r()),s=e.list(),c=n.getStatus(),l={flows:s.map(e=>{let t={name:e.name,version:e.version,source:e.source,sourceType:e.sourceType,format:e.format,steps:e.manifest.steps.map(e=>e.id)};if(e.sourceType===`git`&&e.commitSha){let n=a.hasUpdates(e.installPath);return{...t,commitSha:e.commitSha,updateAvailable:n.success&&n.data?n.data.hasUpdates:void 0}}return t}),activeFlow:c.success&&c.data?{flow:c.data.flow,flowOrigin:c.data.flowOrigin,status:c.data.status,currentStep:c.data.currentStep,slug:c.data.slug,topic:c.data.topic,runDir:c.data.runDir}:null,allRoots:i().normalizedAllRoots,discoveredRepos:i().discoveredRepos};return o(JSON.stringify(l,null,2))}catch(e){return n.error(`flow action list failed`,R(e)),o(`Error: ${a(e)}`)}}async function $u(e,t){let{getFlows:n,log:r,resolveInstallPath:i,resolveInstructionPath:a,toErrorText:o,toTextResponse:s}=t,{name:c}=e;try{let{registry:e,installer:t}=await n(),r=e.get(c);if(!r)throw new Ou(`UNKNOWN_FLOW`,`Flow "${c}" not found. Use flow({ action: "list" }) to see available flows.`);let o=r.commitSha??null,l;if(r.sourceType===`git`&&r.installPath){let e=t.hasUpdates(r.installPath);l=e.success&&e.data?e.data.hasUpdates:void 0}let u={name:r.name,version:r.version,description:r.manifest.description,source:r.source,sourceType:r.sourceType,format:r.format,commitSha:o,updateAvailable:l,installPath:i(r.name,r),registeredAt:r.registeredAt,updatedAt:r.updatedAt,steps:r.manifest.steps.map(e=>({id:e.id,name:e.name,instruction:a(r,e.instruction),produces:e.produces,requires:e.requires,description:e.description})),agents:r.manifest.agents,artifactsDir:r.manifest.artifacts_dir,install:r.manifest.install};return s(JSON.stringify(u,null,2))}catch(e){return ku(e)?s(e.message):(r.error(`flow action info failed`,R(e)),s(`Error: ${o(e)}`))}}async function ed(e,t){let{getAllRoots:n,getFlows:r,log:i,toErrorText:a,toTextResponse:o}=t,{flow:s,status:c,limit:l=50}=e,u=e=>{for(let t of[`updatedAt`,`startedAt`,`createdAt`]){let n=e[t];if(typeof n==`number`&&Number.isFinite(n))return n;if(typeof n==`string`){let e=Date.parse(n);if(!Number.isNaN(e))return e}}return null};try{let e=n(),t=[];for(let n of e){let{stateMachine:e}=await r(n),i=e.listRuns({flow:s,status:c});for(let e of i)t.push({...JSON.parse(JSON.stringify(e)),root:n.replaceAll(`\\`,`/`)})}let i=new Set,a=t.filter(e=>{let t=e.id;return i.has(t)?!1:(i.add(t),!0)});if(a.length===0)return o(`No flow runs found.`);let d=a.map((e,t)=>({run:e,index:t,recency:u(e)})).sort((e,t)=>e.recency==null&&t.recency==null?e.index-t.index:e.recency==null?1:t.recency==null?-1:t.recency===e.recency?e.index-t.index:t.recency-e.recency).map(({run:e})=>e).slice(0,l);return o(JSON.stringify({total:a.length,returned:d.length,truncated:a.length>d.length,runs:d},null,2))}catch(e){return i.error(`flow action runs failed`,R(e)),o(`Error: ${a(e)}`)}}function td(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 nd(e,t,n,r){let i=n&&typeof n!=`function`?n:void 0,a=typeof n==`function`?n:r,o=Du(e,t,i),s=G(`flow`);e.registerTool(`flow`,{title:s.title,description:`Manage development flows — list available flows, start/stop runs, navigate steps, read instructions, and install/remove/update flows. Use action parameter to select operation.`,annotations:s.annotations,inputSchema:{action:z.enum([`list`,`info`,`start`,`step`,`status`,`reset`,`read`,`runs`,`add`,`remove`,`update`]).describe(`The flow operation to perform.`),name:z.string().optional().describe(`Flow name — required for info, start, remove, update. Optional override for add.`),topic:z.string().optional().describe(`Human-readable topic for the run (used by start).`),roots:z.array(z.string()).optional().describe(`Workspace roots participating in this flow (used by start).`),advance:z.enum([`next`,`skip`,`redo`]).optional().describe(`Step navigation action — required for step.`),step:z.string().optional().describe(`Step id or name to read (used by read). Defaults to current step.`),source:z.string().optional().describe(`Git URL, local path, or "openspec" shorthand — required for add.`),token:z.string().optional().describe(`Auth token for private repos (used by add).`),filter_flow:z.string().optional().describe(`Filter runs by flow name (used by runs).`),filter_status:z.string().optional().describe(`Filter runs by status: active, completed, abandoned (used by runs).`),limit:z.number().int().positive().optional().describe(`Max runs to return (default 50).`)}},Y(`flow`,async e=>{switch(e.action){case`list`:return Qu(o);case`info`:return e.name?$u({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`start`:{if(!e.name)return o.toTextResponse(`Missing required parameter: name (flow to start)`);let t=await Ju({flow:e.name,topic:e.topic,roots:e.roots},o),n=td(t);return n&&a&&a(n),t}case`step`:return e.advance?Zu({action:e.advance},o):o.toTextResponse(`Missing required parameter: advance (next/skip/redo)`);case`status`:{let e=await Yu(o);return a&&a(td(e)),e}case`reset`:{let e=await Xu(o);return a&&a(null),e}case`read`:return ju({step:e.step},o);case`runs`:return ed({flow:e.filter_flow,status:e.filter_status,limit:e.limit},o);case`add`:return e.source?Fu({source:e.source,name:e.name,token:e.token},o):o.toTextResponse(`Missing required parameter: source`);case`remove`:return e.name?Iu({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`update`:return e.name?Lu({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);default:return o.toTextResponse(`Unknown action: ${e.action}`)}}))}const rd=L(`tools`);function id(e){let t=G(`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:z.enum([`create`,`add`,`update`,`get`,`gate`,`list`,`delete`]).describe(`Operation to perform`),task_id:z.string().optional().describe(`Task identifier (required for all except list)`),tier:z.enum([`floor`,`standard`,`critical`]).optional().describe(`FORGE tier (required for create)`),claim:z.string().optional().describe(`Critical-path claim text (for add)`),status:z.enum([`V`,`A`,`U`]).optional().describe(`Evidence status: V=Verified, A=Assumed, U=Unresolved`),receipt:z.string().optional().describe(`Evidence receipt: tool→ref for V, reasoning for A, attempts for U`),id:z.number().optional().describe(`Entry ID (for update)`),critical_path:z.boolean().default(!0).describe(`Whether this claim is on the critical path`),unknown_type:z.enum([`contract`,`convention`,`freshness`,`runtime`,`data-flow`,`impact`]).optional().describe(`Typed unknown classification`),safety_gate:z.enum([`provenance`,`commitment`,`coverage`]).optional().describe(`Safety gate tag: provenance (claim→evidence), commitment (user-approved), coverage (nothing dropped)`),retry_count:z.number().default(0).describe(`Retry count for gate evaluation (0 = first attempt)`),max_retries:z.number().int().min(0).optional().describe(`Maximum retries before escalating. Default: 3`),timeout_action:z.enum([`iterate`,`retry`,`manual`,`terminate`]).optional().describe(`Action to take when gate retries are exhausted. Default: manual`),cwd:z.string().optional().describe(`Working directory for evidence map storage (default: server cwd). Use root_path from forge_ground to match.`)},annotations:t.annotations},Y(`evidence_map`,async({action:e,task_id:t,tier:n,claim:r,status:i,receipt:a,id:o,critical_path:s,unknown_type:c,safety_gate:l,retry_count:u,max_retries:d,timeout_action:f,cwd:p})=>{try{switch(e){case`create`:if(!t)throw Error(`task_id required for create`);if(!n)throw Error(`tier required for create`);return dt({action:`create`,taskId:t,tier:n},p),{content:[{type:`text`,text:`Created evidence map "${t}" (tier: ${n}).\n\n---\n_Next: Use \`evidence_map\` with action "add" to record critical-path claims._`}]};case`add`:{if(!t)throw Error(`task_id required for add`);if(!r)throw Error(`claim required for add`);if(!i)throw Error(`status required for add`);let e=dt({action:`add`,taskId:t,claim:r,status:i,receipt:a??``,criticalPath:s,unknownType:c,safetyGate:l},p),n=e.autoCreated?[`⚠️ Evidence map "${t}" was auto-created with tier "standard". Use \`create\` action to set a specific tier.`,``,`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`]:[`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`];return e.summary&&n.push(``,e.summary),{content:[{type:`text`,text:n.join(`
|
|
186
|
+
`):null}}function Gu(e,t){return t(e)}async function Ku(e){let{context:t,entry:n,state:r,activeRoot:i,primaryRoot:a,roots:o}=e,{instructionPath:s,description:c}=t.resolveCurrentStepInfo(n,r.currentStep,i),l=Gu(n,t.getStepSequence),u=await ju({entry:n,stepId:r.currentStep,runDir:r.runDir,slug:r.slug,primaryRoot:a,roots:o,activeRoot:i,resolveInstructionPath:t.resolveInstructionPath,resolveEpilogueInstructionPath:t.resolveEpilogueInstructionPath}),{brief:d,pins:f}=Wu(u),p=d;if(d&&r.currentStep){let e=n.manifest.steps.find(e=>e.id===r.currentStep),a={stepId:r.currentStep,flowName:r.flow,flowSlug:r.slug,phase:`flow`,runDir:r.runDir,artifactsPath:F(r.runDir,n.manifest.artifacts_dir).replaceAll(`\\`,`/`),completedSteps:r.completedSteps??[],stepDescription:e?.description??c??void 0,agents:e?.agents??[],mode:`brief`,topic:r.topic??``,activeRoot:i};p=await t.stepPipeline.enrich(d,a,n.manifest.hooks)}return{artifactsPath:F(r.runDir,n.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStepInstruction:s,currentStepDescription:c,currentStepContent:u,currentStepBrief:p,currentStepPins:f,stepSequence:l}}function qu(e){let{state:t,data:n,started:r,includeStatus:i,action:a,includeInstructionPath:o}=e,s={};return r&&(s.started=!0),s.flow=t.flow,t.flowOrigin&&(s.flowOrigin=t.flowOrigin),i&&(s.status=t.status),a&&(s.action=a),s.slug=t.slug,s.topic=t.topic,s.runDir=t.runDir,s.artifactsPath=n.artifactsPath,s.currentStep=t.currentStep,s.currentStepInstruction=n.currentStepInstruction,o&&(s.instructionPath=n.currentStepInstruction),s.currentStepDescription=n.currentStepDescription,s.currentStepContent=null,s.currentStepBrief=n.currentStepBrief,s.currentStepPins=n.currentStepPins,s.fullContentHint=`Call flow({ action: 'read' }) for the complete step instructions.`,s}function Ju(e){return e.sourceType===`local`?{source:`local`,sourceType:e.sourceType,format:e.format,...e.commitSha?{commitSha:e.commitSha}:{}}:{source:e.source,sourceType:e.sourceType,format:e.format,...e.commitSha?{commitSha:e.commitSha}:{}}}async function Yu(e,t){let{getAllRoots:n,getFlows:r,getWorkspaceRoot:i,isValidFlowRoot:a,log:o,patchMetaRoots:s,stateDir:c,toErrorText:l,toTextResponse:u}=t,{flow:d,topic:f,roots:p}=e;try{if(p&&p.length>0){let e=n().map(e=>e.replaceAll(`\\`,`/`)),t=p.filter(e=>!a(e));if(t.length>0)return u(`Invalid roots — not part of the workspace or a recognized sub-repository: ${t.join(`, `)}. Available roots: ${e.join(`, `)}`)}let e=n(),o=e.map(e=>e.replaceAll(`\\`,`/`)),l=i(),m=e.length>1,h=!p&&m,g=p?.[0]??l,{registry:_,stateMachine:v}=await r(g),y=_.get(d);if(!y)throw new ku(`UNKNOWN_FLOW`,`Flow "${d}" not found. Use flow({ action: "list" }) to see available flows.`);let b=v.start(y.name,y.manifest,f,Ju(y));if(!b.success||!b.data){let e=b.error??`Unknown flow start error.`;return e.includes(`already active`)?u(`Cannot start: ${new ku(`FLOW_ALREADY_ACTIVE`,e).message}`):u(`Cannot start: ${e}`)}let x=b.data;if(p&&p.length>1)try{s(x.slug,g,p),t.syncMetaToRoots(x.slug,g)}catch(e){return v.reset(),u(`Flow created but failed to sync to secondary roots — rolled back. Error: ${e instanceof Error?e.message:String(e)}`)}let S=F(c,`flow-context`),C=typeof Nn==`function`?await Nn(S).catch(()=>[]):[];for(let e of C)e!==x.slug&&typeof Pn==`function`&&await Pn(F(S,e),{recursive:!0,force:!0}).catch(()=>{});if(typeof jn==`function`)try{await jn(F(S,x.slug),{recursive:!0})}catch{}let w=await Ku({context:t,entry:y,state:x,activeRoot:g,primaryRoot:null,roots:p??null}),T={...qu({state:x,data:w,started:!0}),phase:x.phase,isEpilogue:x.isEpilogue,totalSteps:w.stepSequence.length,stepSequence:w.stepSequence,artifactsDir:y.manifest.artifacts_dir,roots:p??[g.replaceAll(`\\`,`/`)],_hint:zu,...h?{multiRootWarning:`No roots specified in multi-root workspace. Flow created at workspace root. Pass roots parameter with target repo for precise placement.`,availableRoots:o}:{}};return u(JSON.stringify(T,null,2))}catch(e){return Au(e)?u(e.message):(o.error(`flow action start failed`,R(e)),u(`Error: ${l(e)}`))}}async function Xu(e){let{getFlows:t,log:n,resolveFlowRoot:r,resolveRoots:i,toErrorText:a,toTextResponse:o}=e;try{let n=await r(),{registry:a,stateMachine:s}=await t(n),c=s.getStatus();if(!c.success||!c.data)throw new ku(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let l=c.data,u=a.get(l.flow),d=u?await Ku({context:e,entry:u,state:l,activeRoot:n,primaryRoot:l.primaryRoot,roots:l.roots}):Hu(),f={...qu({state:l,data:d,includeStatus:!0,includeInstructionPath:!0}),_hint:l.currentStep?zu:void 0,phase:l.phase,isEpilogue:l.isEpilogue,completedSteps:l.completedSteps,skippedSteps:l.skippedSteps,artifacts:l.artifacts,startedAt:l.startedAt,updatedAt:l.updatedAt,totalSteps:d.stepSequence.length,progress:u?`${l.completedSteps.length+l.skippedSteps.length}/${d.stepSequence.length}`:`unknown`,workspaceRoot:n.replaceAll(`\\`,`/`),primaryRoot:(l.primaryRoot??n).replaceAll(`\\`,`/`),roots:l.roots??[n.replaceAll(`\\`,`/`)],allRoots:i().normalizedAllRoots,discoveredRepos:i().discoveredRepos};return o(JSON.stringify(f,null,2))}catch(e){return Au(e)?o(e.message):(n.error(`flow action status failed`,R(e)),o(`Error: ${a(e)}`))}}async function Zu(e){let{getFlows:t,log:n,resolveFlowRoot:r,stateDir:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=e;try{let e=await r(),{stateMachine:n}=await t(e),o=n.getStatus(),c=n.reset();if(!c.success)return s(`Reset failed: ${c.error}`);if(o.success&&o.data&&a(o.data.slug,e),o.success&&o.data?.slug)try{await Pn(F(i,`flow-context`,o.data.slug),{recursive:!0,force:!0})}catch{}return s(`Flow abandoned. Use flow({ action: "start", name: "<flow>" }) to begin a new flow.`)}catch(e){return n.error(`flow action reset failed`,R(e)),s(`Error: ${o(e)}`)}}async function Qu(e,t){let{getFlows:n,log:r,resolveFlowRoot:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=t,{action:c}=e;try{let e=await i(),{registry:r,stateMachine:o}=await n(e),l=o.getStatus();if(!l.success||!l.data)throw new ku(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let u=r.get(l.data.flow);if(!u)throw new ku(`FLOW_NOT_FOUND`,`Flow "${l.data.flow}" not found in registry.`);let d=o.step(c,u.manifest);if(!d.success||!d.data)return s(`Cannot ${c}: ${d.error}`);a(d.data.slug,e);let f=d.data,p=[];if(f.status===`completed`){let e=F(t.stateDir,`flow-context`,f.slug);for(let t of[`decision`,`pattern`]){let n=F(e,t);try{let e=await Nn(n);for(let r of e){if(!r.endsWith(`.md`))continue;let e=await Mn(F(n,r),`utf-8`);e.length>100&&p.push({type:t,title:r.replace(/\.md$/,``).replace(/-/g,` `),content:e.length>500?`${e.slice(0,497)}...`:e})}}catch{}}typeof Pn==`function`&&await Pn(e,{recursive:!0,force:!0}).catch(()=>{})}let m=await Ku({context:t,entry:u,state:f,activeRoot:e,primaryRoot:f.primaryRoot,roots:f.roots}),h={...qu({state:f,data:m,includeStatus:!0,action:c}),_hint:f.currentStep?zu:void 0,phase:f.phase,isEpilogue:f.isEpilogue,completedSteps:f.completedSteps,skippedSteps:f.skippedSteps,totalSteps:m.stepSequence.length,remaining:m.stepSequence.filter(e=>!f.completedSteps.includes(e)&&!f.skippedSteps.includes(e)&&e!==f.currentStep),...p.length>0?{promotionCandidates:p}:{}};return s(JSON.stringify(h,null,2))}catch(e){return Au(e)?s(e.message):(r.error(`flow action step failed`,R(e)),s(`Error: ${o(e)}`))}}async function $u(e){let{getFlows:t,log:n,resolveFlowRoot:r,resolveRoots:i,toErrorText:a,toTextResponse:o}=e;try{let{registry:e,stateMachine:n,installer:a}=await t(await r()),s=e.list(),c=n.getStatus(),l={flows:s.map(e=>{let t={name:e.name,version:e.version,source:e.source,sourceType:e.sourceType,format:e.format,steps:e.manifest.steps.map(e=>e.id)};if(e.sourceType===`git`&&e.commitSha){let n=a.hasUpdates(e.installPath);return{...t,commitSha:e.commitSha,updateAvailable:n.success&&n.data?n.data.hasUpdates:void 0}}return t}),activeFlow:c.success&&c.data?{flow:c.data.flow,flowOrigin:c.data.flowOrigin,status:c.data.status,currentStep:c.data.currentStep,slug:c.data.slug,topic:c.data.topic,runDir:c.data.runDir}:null,allRoots:i().normalizedAllRoots,discoveredRepos:i().discoveredRepos};return o(JSON.stringify(l,null,2))}catch(e){return n.error(`flow action list failed`,R(e)),o(`Error: ${a(e)}`)}}async function ed(e,t){let{getFlows:n,log:r,resolveInstallPath:i,resolveInstructionPath:a,toErrorText:o,toTextResponse:s}=t,{name:c}=e;try{let{registry:e,installer:t}=await n(),r=e.get(c);if(!r)throw new ku(`UNKNOWN_FLOW`,`Flow "${c}" not found. Use flow({ action: "list" }) to see available flows.`);let o=r.commitSha??null,l;if(r.sourceType===`git`&&r.installPath){let e=t.hasUpdates(r.installPath);l=e.success&&e.data?e.data.hasUpdates:void 0}let u={name:r.name,version:r.version,description:r.manifest.description,source:r.source,sourceType:r.sourceType,format:r.format,commitSha:o,updateAvailable:l,installPath:i(r.name,r),registeredAt:r.registeredAt,updatedAt:r.updatedAt,steps:r.manifest.steps.map(e=>({id:e.id,name:e.name,instruction:a(r,e.instruction),produces:e.produces,requires:e.requires,description:e.description})),agents:r.manifest.agents,artifactsDir:r.manifest.artifacts_dir,install:r.manifest.install};return s(JSON.stringify(u,null,2))}catch(e){return Au(e)?s(e.message):(r.error(`flow action info failed`,R(e)),s(`Error: ${o(e)}`))}}async function td(e,t){let{getAllRoots:n,getFlows:r,log:i,toErrorText:a,toTextResponse:o}=t,{flow:s,status:c,limit:l=50}=e,u=e=>{for(let t of[`updatedAt`,`startedAt`,`createdAt`]){let n=e[t];if(typeof n==`number`&&Number.isFinite(n))return n;if(typeof n==`string`){let e=Date.parse(n);if(!Number.isNaN(e))return e}}return null};try{let e=n(),t=[];for(let n of e){let{stateMachine:e}=await r(n),i=e.listRuns({flow:s,status:c});for(let e of i)t.push({...JSON.parse(JSON.stringify(e)),root:n.replaceAll(`\\`,`/`)})}let i=new Set,a=t.filter(e=>{let t=e.id;return i.has(t)?!1:(i.add(t),!0)});if(a.length===0)return o(`No flow runs found.`);let d=a.map((e,t)=>({run:e,index:t,recency:u(e)})).sort((e,t)=>e.recency==null&&t.recency==null?e.index-t.index:e.recency==null?1:t.recency==null?-1:t.recency===e.recency?e.index-t.index:t.recency-e.recency).map(({run:e})=>e).slice(0,l);return o(JSON.stringify({total:a.length,returned:d.length,truncated:a.length>d.length,runs:d},null,2))}catch(e){return i.error(`flow action runs failed`,R(e)),o(`Error: ${a(e)}`)}}function nd(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 rd(e,t,n,r){let i=n&&typeof n!=`function`?n:void 0,a=typeof n==`function`?n:r,o=Ou(e,t,i),s=K(`flow`);e.registerTool(`flow`,{title:s.title,description:`Manage development flows — list available flows, start/stop runs, navigate steps, read instructions, and install/remove/update flows. Use action parameter to select operation.`,annotations:s.annotations,inputSchema:{action:B.enum([`list`,`info`,`start`,`step`,`status`,`reset`,`read`,`runs`,`add`,`remove`,`update`]).describe(`The flow operation to perform.`),name:B.string().optional().describe(`Flow name — required for info, start, remove, update. Optional override for add.`),topic:B.string().optional().describe(`Human-readable topic for the run (used by start).`),roots:B.array(B.string()).optional().describe(`Workspace roots participating in this flow (used by start).`),advance:B.enum([`next`,`skip`,`redo`]).optional().describe(`Step navigation action — required for step.`),step:B.string().optional().describe(`Step id or name to read (used by read). Defaults to current step.`),source:B.string().optional().describe(`Git URL, local path, or "openspec" shorthand — required for add.`),token:B.string().optional().describe(`Auth token for private repos (used by add).`),filter_flow:B.string().optional().describe(`Filter runs by flow name (used by runs).`),filter_status:B.string().optional().describe(`Filter runs by status: active, completed, abandoned (used by runs).`),limit:B.number().int().positive().optional().describe(`Max runs to return (default 50).`)}},X(`flow`,async e=>{switch(e.action){case`list`:return $u(o);case`info`:return e.name?ed({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`start`:{if(!e.name)return o.toTextResponse(`Missing required parameter: name (flow to start)`);let t=await Yu({flow:e.name,topic:e.topic,roots:e.roots},o),n=nd(t);return n&&a&&a(n),t}case`step`:return e.advance?Qu({action:e.advance},o):o.toTextResponse(`Missing required parameter: advance (next/skip/redo)`);case`status`:{let e=await Xu(o);return a&&a(nd(e)),e}case`reset`:{let e=await Zu(o);return a&&a(null),e}case`read`:return Mu({step:e.step},o);case`runs`:return td({flow:e.filter_flow,status:e.filter_status,limit:e.limit},o);case`add`:return e.source?Iu({source:e.source,name:e.name,token:e.token},o):o.toTextResponse(`Missing required parameter: source`);case`remove`:return e.name?Lu({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`update`:return e.name?Ru({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);default:return o.toTextResponse(`Unknown action: ${e.action}`)}}))}const id=L(`tools`);function ad(e){let t=K(`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:B.enum([`create`,`add`,`update`,`get`,`gate`,`list`,`delete`]).describe(`Operation to perform`),task_id:B.string().optional().describe(`Task identifier (required for all except list)`),tier:B.enum([`floor`,`standard`,`critical`]).optional().describe(`FORGE tier (required for create)`),claim:B.string().optional().describe(`Critical-path claim text (for add)`),status:B.enum([`V`,`A`,`U`]).optional().describe(`Evidence status: V=Verified, A=Assumed, U=Unresolved`),receipt:B.string().optional().describe(`Evidence receipt: tool→ref for V, reasoning for A, attempts for U`),id:B.number().optional().describe(`Entry ID (for update)`),critical_path:B.boolean().default(!0).describe(`Whether this claim is on the critical path`),unknown_type:B.enum([`contract`,`convention`,`freshness`,`runtime`,`data-flow`,`impact`]).optional().describe(`Typed unknown classification`),safety_gate:B.enum([`provenance`,`commitment`,`coverage`]).optional().describe(`Safety gate tag: provenance (claim→evidence), commitment (user-approved), coverage (nothing dropped)`),retry_count:B.number().default(0).describe(`Retry count for gate evaluation (0 = first attempt)`),max_retries:B.number().int().min(0).optional().describe(`Maximum retries before escalating. Default: 3`),timeout_action:B.enum([`iterate`,`retry`,`manual`,`terminate`]).optional().describe(`Action to take when gate retries are exhausted. Default: manual`),cwd:B.string().optional().describe(`Working directory for evidence map storage (default: server cwd). Use root_path from forge_ground to match.`)},annotations:t.annotations},X(`evidence_map`,async({action:e,task_id:t,tier:n,claim:r,status:i,receipt:a,id:o,critical_path:s,unknown_type:c,safety_gate:l,retry_count:u,max_retries:d,timeout_action:f,cwd:p})=>{try{switch(e){case`create`:if(!t)throw Error(`task_id required for create`);if(!n)throw Error(`tier required for create`);return dt({action:`create`,taskId:t,tier:n},p),{content:[{type:`text`,text:`Created evidence map "${t}" (tier: ${n}).\n\n---\n_Next: Use \`evidence_map\` with action "add" to record critical-path claims._`}]};case`add`:{if(!t)throw Error(`task_id required for add`);if(!r)throw Error(`claim required for add`);if(!i)throw Error(`status required for add`);let e=dt({action:`add`,taskId:t,claim:r,status:i,receipt:a??``,criticalPath:s,unknownType:c,safetyGate:l},p),n=e.autoCreated?[`⚠️ Evidence map "${t}" was auto-created with tier "standard". Use \`create\` action to set a specific tier.`,``,`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`]:[`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`];return e.summary&&n.push(``,e.summary),{content:[{type:`text`,text:n.join(`
|
|
187
187
|
`)}]}}case`update`:{if(!t)throw Error(`task_id required for update`);if(o===void 0)throw Error(`id required for update`);if(!i)throw Error(`status required for update`);let e=dt({action:`update`,taskId:t,id:o,status:i,receipt:a??``},p),n=[`Updated entry #${o} in "${t}" → ${i}`];return e.summary&&n.push(``,e.summary),{content:[{type:`text`,text:n.join(`
|
|
188
188
|
`)}]}}case`get`:{if(!t)throw Error(`task_id required for get`);let e=dt({action:`get`,taskId:t},p);return e.state?{content:[{type:`text`,text:[`## Evidence Map: ${t} (${e.state.tier})`,``,e.formattedMap??`No entries.`,``,`_${e.state.entries.length} entries — created ${e.state.createdAt}_`].join(`
|
|
189
189
|
`)}]}:{content:[{type:`text`,text:`Evidence map "${t}" not found.`}]}}case`gate`:{if(!t)throw Error(`task_id required for gate`);let e=dt({action:`gate`,taskId:t,retryCount:u,maxRetries:d,timeoutAction:f},p);if(!e.gate)return{content:[{type:`text`,text:`Evidence map "${t}" not found.`}]};let n=e.gate,r=[`## FORGE Gate: **${n.verdict}**`,``,`**Reason:** ${n.reason}`,``,`**Stats:** ${n.stats.verified}V / ${n.stats.assumed}A / ${n.stats.unresolved}U (${n.stats.total} total)`];return n.action&&r.push(``,`**Recommended action:** ${n.action}`),n.retriesRemaining!==void 0&&r.push(`**Retries remaining:** ${n.retriesRemaining}`),n.summary&&r.push(``,`**Summary:** ${n.summary}`),n.warnings.length>0&&r.push(``,`**Warnings:**`,...n.warnings.map(e=>`- ⚠️ ${e}`)),n.unresolvedCritical.length>0&&r.push(``,`**Blocking entries:**`,...n.unresolvedCritical.map(e=>`- #${e.id}: ${e.claim} [${e.unknownType??`untyped`}]`)),n.safetyGates&&(r.push(``,`**Safety Gates:**`,`- Provenance: ${n.safetyGates.provenance}`,`- Commitment: ${n.safetyGates.commitment}`,`- Coverage: ${n.safetyGates.coverage}`),n.safetyGates.failures.length>0&&r.push(``,`**Safety failures:**`,...n.safetyGates.failures.map(e=>`- \u{1F6D1} ${e}`))),n.annotation&&r.push(``,`**Annotation:**`,n.annotation),e.formattedMap&&r.push(``,`---`,``,e.formattedMap),r.push(``,`---`,`_Next: ${n.verdict===`YIELD`?`Proceed to implementation.`:n.action===`iterate`?`Re-run the build loop, then evaluate the gate again.`:n.action===`retry`?`Re-evaluate the gate after refreshing evidence.`:n.action===`manual`?`Ask for human review before proceeding.`:`Abort the current path and terminate the task.`}_`),{content:[{type:`text`,text:r.join(`
|
|
190
190
|
`)}]}}case`list`:{let e=dt({action:`list`},p);return!e.states||e.states.length===0?{content:[{type:`text`,text:`No evidence maps found.`}]}:{content:[{type:`text`,text:e.states.map(e=>`- **${e.taskId}** (${e.tier}) — ${e.entries.length} entries — ${e.updatedAt}`).join(`
|
|
191
|
-
`)}]}}case`delete`:if(!t)throw Error(`task_id required for delete`);return{content:[{type:`text`,text:dt({action:`delete`,taskId:t},p).deleted?`Deleted evidence map "${t}".`:`Evidence map "${t}" not found.`}]}}}catch(e){return
|
|
192
|
-
`);return{content:[{type:`text`,text:u}],structuredContent:{text:u,ref:s.ref,fields:s.fields,sourceStats:s.sourceStats,totalOriginalChars:s.totalOriginalChars,totalCompressedChars:s.totalCompressedChars,ratio:s.ratio}}}catch(e){return
|
|
193
|
-
`);if(i&&t){let e=await
|
|
194
|
-
`)}]}}catch(e){return
|
|
195
|
-
`)}]}}catch(e){return
|
|
191
|
+
`)}]}}case`delete`:if(!t)throw Error(`task_id required for delete`);return{content:[{type:`text`,text:dt({action:`delete`,taskId:t},p).deleted?`Deleted evidence map "${t}".`:`Evidence map "${t}" not found.`}]}}}catch(e){return id.error(`Evidence map error`,R(e)),Y(`INTERNAL`,`Evidence map error: ${e instanceof Error?e.message:String(e)}`)}}))}function od(e,t){let n=K(`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.`,outputSchema:ac,inputSchema:{sources:B.array(B.object({id:B.string().describe(`Source identifier (e.g., "phase-2-handoff")`),text:B.string().max(5e5).describe(`Source text to compress`),weight:B.number().min(0).default(1).describe(`Priority weight (higher = more budget)`)})).min(1).max(20).describe(`Text sources to compress`),query:B.string().describe(`Focus query — what matters for the next step?`),max_chars:B.number().min(100).max(5e4).default(4e3).describe(`Target budget in characters`),pin_fields:B.array(B.string()).optional().describe(`Key fields to always extract (default: status, files, decisions, blockers, next)`),segmentation:B.enum([`paragraph`,`sentence`,`line`]).default(`paragraph`).describe(`How to split text for scoring`),token_budget:B.number().min(50).max(12500).optional().describe(`Token budget — overrides max_chars (approx 4 chars per token). Use to fit output into a specific context window.`)},annotations:n.annotations},async({sources:e,query:n,max_chars:r,pin_fields:i,segmentation:a,token_budget:o})=>{try{let s=await ot(t,{sources:e,query:n,maxChars:o?o*4:r,pinFields:i,segmentation:a}),c=[`## Digest (${s.totalOriginalChars} → ${s.totalCompressedChars} chars, ${(s.ratio*100).toFixed(0)}%)`,s.ref?`Ref: ${s.ref}`:void 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)`);c.push(``,`---`,"_Next: Use the digest as compressed context for the next phase. Use `stash` to persist it if needed._");let u=c.filter(e=>typeof e==`string`).join(`
|
|
192
|
+
`);return{content:[{type:`text`,text:u}],structuredContent:{text:u,ref:s.ref,fields:s.fields,sourceStats:s.sourceStats,totalOriginalChars:s.totalOriginalChars,totalCompressedChars:s.totalCompressedChars,ratio:s.ratio}}}catch(e){return id.error(`Digest failed`,R(e)),{...Y(`INTERNAL`,`Digest failed: ${e instanceof Error?e.message:String(e)}`),structuredContent:{text:``,ref:void 0,fields:{},sourceStats:[],totalOriginalChars:0,totalCompressedChars:0,ratio:0}}}})}function sd(e,t){let n=K(`forge_classify`);e.registerTool(`forge_classify`,{title:n.title,description:`Classify FORGE tier (Floor/Standard/Critical) from target files and task description. Checks blast radius, cross-package boundaries, schema/contract patterns, and security signals. Returns tier, triggers, typed unknown seeds, and ceremony guidance.`,inputSchema:{files:B.array(B.string()).min(1).max(100).describe(`Files being modified (paths)`),task:B.string().describe(`Task description`),root_path:B.string().describe(`Root path of the codebase`),enrich:B.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)},annotations:n.annotations},X(`forge_classify`,async({files:e,task:n,root_path:r,enrich:i})=>{try{let a=await gt({files:e,task:n,rootPath:r}),o=[`## FORGE Classification: **${a.tier.toUpperCase()}**`,``];if(a.triggers.length>0){o.push(`### Triggers`);for(let e of a.triggers)o.push(`- **${e.rule}** (${e.source}): ${e.detail}`);o.push(``)}if(a.packagesCrossed.length>0&&o.push(`**Packages crossed:** ${a.packagesCrossed.join(`, `)}`),a.typedUnknownSeeds.length>0){o.push(``,`### Typed Unknown Seeds`);for(let e of a.typedUnknownSeeds)o.push(`- [${e.type}] ${e.description} → use \`${e.suggestedTool}\``)}o.push(``,`### Ceremony`);let s=a.ceremony;o.push(`- **Ground:** ${s.ground}`,`- **Build:** ${s.build}`,`- **Break:** ${s.break}`,`- **Evidence Map:** ${s.evidenceMap}`,`- **Gate:** ${s.gate}`),o.push(``,`---`,`_Next: ${a.tier===`floor`?`Proceed directly to implementation.`:"Run `forge_ground` to execute the full Ground phase."}_`);let c=o.join(`
|
|
193
|
+
`);if(i&&t){let e=await q(t,{query:`forge classify ${n}`});c+=J(e)}return{content:[{type:`text`,text:c}]}}catch(e){return id.error(`FORGE classify failed`,R(e)),Y(`INTERNAL`,`FORGE classify failed: ${e instanceof Error?e.message:String(e)}`)}}))}function cd(e,t,n){let r=K(`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:B.array(B.string()).min(1).max(50).describe(`Absolute file paths to generate cards for`),query:B.string().describe(`Current task query — guides relevance scoring`),tier:B.enum([`T1`,`T2`]).default(`T1`).describe(`Card tier: T1 = structural only, T2 = T1 + compressed content`),max_content_chars:B.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 bn(t,{files:e,query:r,tier:i,maxContentChars:a,cache:n}),s=[`## STRATUM Cards (${i}) — ${o.cards.length} files`,`Total: ~${o.totalTokenEstimate} tokens (was ~${o.totalOriginalTokenEstimate}, ${(o.compressionRatio*100).toFixed(0)}% of original)`,``];for(let e of o.cards)s.push(e.card,``);return s.push(`---`,"_Next: Use these cards as context instead of reading full files. Use `compact` for deeper content extraction on specific files._"),{content:[{type:`text`,text:s.join(`
|
|
194
|
+
`)}]}}catch(e){return id.error(`STRATUM cards failed`,R(e)),Y(`INTERNAL`,`STRATUM cards failed: ${e instanceof Error?e.message:String(e)}`)}})}function ld(e,t,n){let r=K(`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:B.string().describe(`Task description`),files:B.array(B.string()).min(1).max(100).describe(`Target files being modified (absolute paths)`),root_path:B.string().describe(`Root path of the codebase`),max_constraints:B.number().min(0).max(10).default(3).describe(`Max constraint entries to load from AI Kit memory`),force_tier:B.enum([`floor`,`standard`,`critical`]).optional().describe(`Force a specific tier (skips auto-classification)`),task_id:B.string().optional().describe(`Custom task ID for evidence map (auto-generated if omitted)`)},annotations:r.annotations},X(`forge_ground`,async({task:e,files:r,root_path:i,max_constraints:a,force_tier:o,task_id:s},c)=>{try{let l=await _t(t,n,{task:e,files:r,rootPath:i,maxConstraints:a,forceTier:o,taskId:s}),u=Wc(c).createTask(`FORGE Ground`,3);u.progress(0,`Classification: ${l.tier}`),u.progress(1,`Files analyzed: ${l.fileSummaries.length}`),u.progress(2,`Unknowns: ${l.typedUnknownSeeds.length}`),u.complete(`FORGE Ground complete: tier=${l.tier}`);let d=[`## FORGE Ground: **${l.tier.toUpperCase()}**`,`Estimated output: ~${l.estimatedTokens} tokens`,``];if(l.classifyTriggers.length>0){d.push(`### Classification Triggers`);for(let e of l.classifyTriggers)d.push(`- **${e.rule}** (${e.source}): ${e.detail}`);d.push(``)}if(l.fileSummaries.length>0){d.push(`### Target Files`);for(let e of l.fileSummaries)d.push(`- **${e.path}** (${e.lines} lines) — exports: ${e.exports.join(`, `)||`none`} — functions: ${e.functions.join(`, `)||`none`}`);d.push(``)}if(l.typedUnknownSeeds.length>0){d.push(`### Typed Unknown Seeds`);for(let e of l.typedUnknownSeeds)d.push(`- [${e.type}] ${e.description} → \`${e.suggestedTool}\``);d.push(``)}if(l.constraints.length>0){d.push(`### Constraint Seed`);for(let e of l.constraints)d.push(`- **${e.source}** (${(e.relevance*100).toFixed(0)}%): ${e.snippet}`);d.push(``)}if(l.scopeMap){d.push(`### Scope Map: ${l.scopeMap.files.length} files (~${l.scopeMap.totalEstimatedTokens} tokens)`);for(let e of l.scopeMap.files.slice(0,5))d.push(`- ${e.path} (${(e.relevance*100).toFixed(0)}%) — ${e.reason}`);l.scopeMap.files.length>5&&d.push(`- _...and ${l.scopeMap.files.length-5} more_`),d.push(``)}l.evidenceMapTaskId&&(d.push(`**Evidence Map:** \`${l.evidenceMapTaskId}\` (initialized)`),d.push(``)),d.push(`### Ceremony Guidance`);let f=l.ceremony;return d.push(`- **Ground:** ${f.ground}`,`- **Build:** ${f.build}`,`- **Break:** ${f.break}`,`- **Evidence Map:** ${f.evidenceMap}`,`- **Gate:** ${f.gate}`),d.push(``,`---`,`_Next: ${l.tier===`floor`?`Proceed to Build phase.`:"Use `evidence_map` to track claims during Build, then `evidence_map` gate after Break."}_`),{content:[{type:`text`,text:d.join(`
|
|
195
|
+
`)}]}}catch(e){return id.error(`FORGE Ground failed`,R(e)),Y(`INTERNAL`,`FORGE Ground failed: ${e instanceof Error?e.message:String(e)}`)}}))}const ud=L(`tools`),dd=B.object({id:B.string().optional().describe(`Node ID (auto-generated if omitted)`),type:B.string().describe(`Node type (entity, service, api, concept, decision)`),name:B.string().describe(`Display name`),properties:B.record(B.string(),B.unknown()).optional().describe(`Arbitrary properties`),sourceRecordId:B.string().optional().describe(`Back-link to knowledge record ID`),sourcePath:B.string().optional().describe(`Source file path`)}),fd=B.object({id:B.string().optional().describe(`Edge ID (auto-generated if omitted)`),fromId:B.string().describe(`Source node ID`),toId:B.string().describe(`Target node ID`),type:B.string().describe(`Relationship type (depends-on, implements, calls, affects)`),weight:B.number().min(0).max(1).optional().describe(`Relationship weight`),properties:B.record(B.string(),B.unknown()).optional().describe(`Arbitrary properties`)});function pd(e,t,n){let r=K(`graph`);e.registerTool(`graph`,{title:r.title,description:`Query the auto-populated code knowledge graph (modules, symbols, imports) to answer
|
|
196
196
|
structural questions vector search cannot.
|
|
197
197
|
|
|
198
198
|
Common flow (when you don't have a node_id yet — TWO STEPS):
|
|
@@ -211,7 +211,7 @@ Single-step read actions:
|
|
|
211
211
|
Mutating actions (use deliberately): add, delete, clear, set_community,
|
|
212
212
|
detect_communities, trace_process, delete_process.
|
|
213
213
|
|
|
214
|
-
Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_radius\` (change impact).`,outputSchema:
|
|
214
|
+
Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_radius\` (change impact).`,outputSchema:Qs,inputSchema:{action:B.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:B.string().optional().describe(`Node type filter (for find_nodes)`),name_pattern:B.string().optional().describe(`Name substring match (for find_nodes)`),source_path:B.string().optional().describe(`Source path filter`),node_id:B.string().optional().describe(`Node ID (for neighbors, traverse, delete)`),edge_type:B.string().optional().describe(`Edge type filter`),from_id:B.string().optional().describe(`Source node ID (for find_edges)`),to_id:B.string().optional().describe(`Target node ID (for find_edges)`),direction:B.enum([`outgoing`,`incoming`,`both`]).default(`both`).describe(`Traversal direction`),max_depth:B.number().min(1).max(5).default(2).describe(`Max traversal depth`),limit:B.number().min(1).max(100).default(50).describe(`Max results`),max_tokens:B.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),nodes:B.array(dd).max(500).optional().describe(`Nodes to add (for action=add)`),edges:B.array(fd).max(500).optional().describe(`Edges to add (for action=add)`),community:B.string().optional().describe(`Community label (for set_community, cohesion)`),process_id:B.string().optional().describe(`Process ID (for delete_process)`),label:B.string().optional().describe(`Label for process tracing (for trace_process)`),enrich:B.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)},annotations:r.annotations},X(`graph`,async e=>{try{let r=await xt(t,{action:e.action,nodeType:e.node_type,namePattern:e.name_pattern,sourcePath:e.source_path,nodeId:e.node_id,edgeType:e.edge_type,fromId:e.from_id,toId:e.to_id,direction:e.direction,maxDepth:e.max_depth,limit:e.limit,nodes:e.nodes,edges:e.edges,community:e.community,processId:e.process_id,label:e.label}),i=[r.summary];if(r.nodes&&r.nodes.length>0){i.push(`
|
|
215
215
|
### Nodes`);for(let e of r.nodes){let t=Object.keys(e.properties).length>0?` — ${JSON.stringify(e.properties)}`:``;i.push(`- **${e.name}** (${e.type}, id: \`${e.id}\`)${t}`)}}if(r.edges&&r.edges.length>0){i.push(`
|
|
216
216
|
### Edges`);for(let e of r.edges)i.push(`- \`${e.fromId}\` —[${e.type}]→ \`${e.toId}\`${e.weight===1?``:` (weight: ${e.weight})`}`)}if(r.stats&&(i.push(`\nNode types: ${JSON.stringify(r.stats.nodeTypes)}`),i.push(`Edge types: ${JSON.stringify(r.stats.edgeTypes)}`)),r.validation){if(i.push(`
|
|
217
217
|
### Validation`),i.push(`- **Valid**: ${r.validation.valid?`yes`:`no`}`),r.validation.danglingEdges.length>0){i.push(`- **Dangling edges**:`);for(let e of r.validation.danglingEdges)i.push(` - \`${e.edgeId}\` references missing node \`${e.missingNodeId}\``)}r.validation.orphanNodes.length>0&&i.push(`- **Orphan nodes**: ${r.validation.orphanNodes.map(e=>`\`${e}\``).join(`, `)}`)}if(r.communities){i.push(`
|
|
@@ -220,60 +220,60 @@ Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_rad
|
|
|
220
220
|
### Processes`);for(let e of r.processes)i.push(`- **${e.label}** (id: \`${e.id}\`) — ${e.steps.length} step(s)`)}if(r.depthGroups){i.push(`
|
|
221
221
|
### Depth Groups`);for(let[e,t]of Object.entries(r.depthGroups))i.push(`- **Depth ${e}**: ${t.map(e=>`${e.name} (${e.type})`).join(`, `)}`)}if(r.cohesionScore!==void 0&&i.push(`\n**Cohesion Score**: ${(r.cohesionScore*100).toFixed(1)}%`),r.symbol360){let e=r.symbol360;i.push(`
|
|
222
222
|
### 360° Symbol View`),i.push(`- **Node**: ${e.node.name} (${e.node.type})`),i.push(`- **Community**: ${e.community??`none`}`),i.push(`- **Incoming**: ${e.incoming.length} edge(s)`),i.push(`- **Outgoing**: ${e.outgoing.length} edge(s)`),i.push(`- **Processes**: ${e.processes.length}`)}i.push("\n---\n_Next: Use `graph(traverse)` to explore connections, `graph(add)` to insert entities, `graph(symbol360)` for full node context, or `graph(detect_communities)` to find clusters._");let a=i.join(`
|
|
223
|
-
`);if(e.enrich&&n){let t=await
|
|
224
|
-
`)};if(c.length===1)try{return{content:[{type:`text`,text:await l(c[0])+"\n\n---\n_Next: Use `remember` to save key findings, or `web_fetch` with a `selector` to extract a specific section._"}]}}catch(e){let t=e instanceof Error?e.message:String(e);return/HTTP [45]\d{2}/.test(t)?
|
|
223
|
+
`);if(e.enrich&&n){let t=await q(n,{query:`graph ${e.action} ${e.name_pattern??e.node_id??e.community??``}`.trim(),filePath:e.source_path});a+=J(t)}return{content:[{type:`text`,text:e.max_tokens?z(a,e.max_tokens):a}],structuredContent:{nodes:(r.nodes??[]).map(e=>({id:e.id,name:e.name,type:e.type,...e.sourcePath?{sourcePath:e.sourcePath}:{}})),edges:(r.edges??[]).map(e=>({fromId:e.fromId,toId:e.toId,type:e.type})),totalNodes:r.stats?.nodeCount??r.nodes?.length??0,totalEdges:r.stats?.edgeCount??r.edges?.length??0,query:e.action}}}catch(e){return ud.error(`Graph query failed`,R(e)),Y(`INTERNAL`,`Graph query failed: ${e instanceof Error?e.message:String(e)}`)}}))}const md=L(`tools:infra`);function hd(e){let t=K(`process`);e.registerTool(`process`,{title:t.title,description:`Start, stop, inspect, list, and tail logs for in-memory managed child processes.`,inputSchema:{action:B.enum([`start`,`stop`,`status`,`list`,`logs`]).describe(`Process action to perform`),id:B.string().optional().describe(`Managed process ID`),command:B.string().optional().describe(`Executable to start`),args:B.array(B.string()).optional().describe(`Arguments for start actions`),tail:B.number().min(1).max(500).optional().describe(`Log lines to return for logs actions`)},annotations:t.annotations},X(`process`,async({action:e,id:t,command:n,args:r,tail:i})=>{try{switch(e){case`start`:if(!t||!n)throw Error(`id and command are required for start`);return{content:[{type:`text`,text:JSON.stringify(zt(t,n,r??[]))}]};case`stop`:if(!t)throw Error(`id is required for stop`);return{content:[{type:`text`,text:JSON.stringify(Vt(t)??null)}]};case`status`:if(!t)throw Error(`id is required for status`);return{content:[{type:`text`,text:JSON.stringify(Bt(t)??null)}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(Lt())}]};case`logs`:if(!t)throw Error(`id is required for logs`);return{content:[{type:`text`,text:JSON.stringify(Rt(t,i))}]}}}catch(e){return md.error(`Process action failed`,R(e)),Y(`INTERNAL`,`Process action failed: ${e instanceof Error?e.message:String(e)}`)}}))}function gd(e){let t=K(`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:B.enum([`start`,`stop`,`list`]).describe(`Watch action to perform`),path:B.string().optional().describe(`Directory path to watch for start actions`),id:B.string().optional().describe(`Watcher ID for stop actions`)},annotations:t.annotations},X(`watch`,async({action:e,path:t,id:n})=>{try{switch(e){case`start`:if(!t)throw Error(`path is required for start`);return{content:[{type:`text`,text:JSON.stringify(Dn({path:t}))}]};case`stop`:if(!n)throw Error(`id is required for stop`);return{content:[{type:`text`,text:JSON.stringify({stopped:On(n)})}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(En())}]}}}catch(e){return md.error(`Watch action failed`,R(e)),Y(`INTERNAL`,`Watch action failed: ${e instanceof Error?e.message:String(e)}`)}}))}function _d(e){let t=K(`health`);e.registerTool(`health`,{title:t.title,description:`Run project health checks — verifies package.json, tsconfig, scripts, lockfile, README, LICENSE, .gitignore.`,outputSchema:Ns,inputSchema:{path:B.string().optional().describe(`Root directory to check (defaults to cwd)`)},annotations:t.annotations},X(`health`,async({path:e})=>{try{let t=Ct(e),n={ok:t.checks.every(e=>e.status!==`fail`),checks:t.checks.map(e=>({name:e.name,ok:e.status===`pass`,message:e.message}))};return{content:[{type:`text`,text:JSON.stringify(t)}],structuredContent:n}}catch(e){return md.error(`Health check failed`,R(e)),Y(`INTERNAL`,`Health check failed: ${e instanceof Error?e.message:String(e)}`)}}))}function vd(e){let t=K(`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:B.array(B.string().url()).min(1).max(10).describe('URLs to fetch (1–10). Single URL: `["https://..."]`. Multiple fetched in parallel.'),mode:B.enum([`markdown`,`raw`,`links`,`outline`]).default(`markdown`).describe(`Output mode: markdown (clean content), raw (HTML), links (extracted URLs), outline (heading hierarchy)`),selector:B.string().optional().describe(`CSS selector to extract a specific element instead of auto-detecting main content`),max_length:B.number().min(500).max(1e5).default(15e3).describe(`Max characters in output — truncates at paragraph boundaries`),include_metadata:B.boolean().default(!0).describe(`Include page title, description, and URL as a header`),include_links:B.boolean().default(!1).describe(`Append extracted links list at the end`),include_images:B.boolean().default(!1).describe(`Include image alt texts inline`),timeout:B.number().min(1e3).max(12e4).default(3e4).describe(`Request timeout in milliseconds`)},annotations:t.annotations},X(`web_fetch`,async({urls:e,mode:t,selector:n,max_length:r,include_metadata:i,include_links:a,include_images:o,timeout:s})=>{let c=e,l=async(e,c)=>{let l=await kn({url:e,mode:t,selector:n,maxLength:r,includeMetadata:i,includeLinks:a,includeImages:o,timeout:s}),u=[c?`## ${c} ${l.title||`Web Page`}\n> Source: ${e}`:`## ${l.title||`Web Page`}`,``,l.content];return l.truncated&&u.push(``,`_Original length: ${l.originalLength.toLocaleString()} chars_`),u.join(`
|
|
224
|
+
`)};if(c.length===1)try{return{content:[{type:`text`,text:await l(c[0])+"\n\n---\n_Next: Use `remember` to save key findings, or `web_fetch` with a `selector` to extract a specific section._"}]}}catch(e){let t=e instanceof Error?e.message:String(e);return/HTTP [45]\d{2}/.test(t)?md.warn(`Web fetch failed`,{error:t}):md.error(`Web fetch failed`,R(e)),{...Y(`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)?md.warn(`Web fetch failed`,{url:c[e],error:n}):md.error(`Web fetch failed`,{url:c[e],...R(t.reason)}),f.push(`## ❌ Failed: ${c[e]}\n\n${n}`)}}let m=`_Fetched ${d.length-p}/${d.length} URLs successfully._`;f.push(``,`---`,m,"_Next: Use `remember` to save key findings, or `web_fetch` with a `selector` to extract a specific section._");let h=f.join(`
|
|
225
225
|
|
|
226
|
-
`);return p===d.length?
|
|
227
|
-
`)}]}}catch(e){return
|
|
226
|
+
`);return p===d.length?Y(`INTERNAL`,h):{content:[{type:`text`,text:h}]}}))}function yd(e,t){let n=K(`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:B.string().describe(`What you want to accomplish (e.g., "audit this monorepo", "fix a failing test")`),max_recommendations:B.number().min(1).max(10).default(5).describe(`Maximum number of tool recommendations`)},annotations:n.annotations},X(`guide`,async({goal:e,max_recommendations:n})=>{try{let r=St(e,n,t),i=[`## Recommended Workflow: **${r.workflow}**`,r.description,``,`### Tools`,...r.tools.map(e=>{let t=e,n=t.suggestedArgs?` — \`${JSON.stringify(t.suggestedArgs)}\``:``,r=t.tokenTip?`\n 💡 ${t.tokenTip}`:``;return`${t.order}. **${t.tool}** — ${t.reason}${n}${r}`})];return r.alternativeWorkflows.length>0&&i.push(``,`_Alternative workflows: ${r.alternativeWorkflows.join(`, `)}_`),i.push(``,`---`,"_Next: Run the first recommended tool, or use `guide` again with a more specific goal._"),{content:[{type:`text`,text:i.join(`
|
|
227
|
+
`)}]}}catch(e){return md.error(`Guide failed`,R(e)),Y(`INTERNAL`,`Guide failed: ${e instanceof Error?e.message:String(e)}`)}}))}const bd=/^(export|import|function|class|interface|type|const|let|var|→|├|└|─|##)/,xd=/^(decision|rationale|status|context|consequence)/i,Sd=/finding|recommendation|warning|error|issue/i,Cd=/status|done|decision|blocker|next|file|created|modified/i,wd=/(score|relevance)/i,Td=/[/.]|\.(ts|js)$/i;function Ed(e){return e.split(/\r?\n/u).map(e=>e.replace(/[ \t]+$/u,``)).join(`
|
|
228
228
|
`).replace(/\n{3,}/gu,`
|
|
229
229
|
|
|
230
|
-
`).trim()}function
|
|
230
|
+
`).trim()}function Dd(e,t){if(e.length<=t)return e;let n=e.split(`
|
|
231
231
|
`),r=[],i=0;for(let e of n){let n=r.length===0?e.length:e.length+1;if(i+n>t)break;r.push(e),i+=n}return r.length>0?r.join(`
|
|
232
|
-
`):e.slice(0,t).trimEnd()}function
|
|
233
|
-
`)}function
|
|
234
|
-
`))}function
|
|
235
|
-
`),.7,e.length))}function
|
|
236
|
-
`),.65,e.length))}function
|
|
237
|
-
`),.6,e.length))}function
|
|
238
|
-
`),.5,e.length))}function
|
|
239
|
-
`)}`}async function
|
|
240
|
-
`);return{content:[{type:`text`,text:`## Lessons (${
|
|
241
|
-
`)}],structuredContent:{bufferPath:a,observations:o.length,createdCount:l.length,skippedCount:u.length,candidates:s.map(e=>({title:e.title,detector:e.detector,confidence:e.confidence,tags:e.tags})),created:l,skipped:u}}}function
|
|
242
|
-
`)}function
|
|
243
|
-
`)}function
|
|
244
|
-
`)}async function
|
|
232
|
+
`):e.slice(0,t).trimEnd()}function Od(e,t,n){return Dd(e,Math.max(1,Math.floor(n*t)))}function kd(e,t){if(e.length<50)return e;let n=Ed(t);return!n||n.length<e.length*.2?e:n}function Ad(e,t,n){let r=new Set;for(let n=0;n<Math.min(t,e.length);n+=1)r.add(n);return e.forEach((e,t)=>{n(e,t)&&r.add(t)}),e.filter((e,t)=>r.has(t)).join(`
|
|
233
|
+
`)}function jd(e,t){e.includes(t)||e.push(t)}function Md(e){return kd(e,Od(Ad(e.split(/\r?\n/u),3,e=>bd.test(e)||e.startsWith(`- `)),.6,e.length))}function Nd(e){let t=e.split(/\r?\n/u),n=[];return t.forEach((e,t)=>{if(t<5||wd.test(e)||Td.test(e)||/^Content:/i.test(e)){if(/^Content:/i.test(e)){jd(n,`Content: ${e.replace(/^Content:\s*/i,``).trim().slice(0,200)}`);return}jd(n,e)}}),kd(e,n.join(`
|
|
234
|
+
`))}function Pd(e){let t=e.split(/\r?\n/u),n=new Set;for(let e=0;e<t.length&&t[e].trim()!==``;e+=1)n.add(e);return t.forEach((e,t)=>{(e.startsWith(`- `)||e.startsWith(`* `)||xd.test(e))&&n.add(t)}),kd(e,Od(t.filter((e,t)=>n.has(t)).join(`
|
|
235
|
+
`),.7,e.length))}function Fd(e){let t=e.split(/\r?\n/u),n=new Set,r=!1;for(let e=0;e<Math.min(2,t.length);e+=1)n.add(e);return t.forEach((e,t)=>{if(e.startsWith("```")){n.add(t),r=!r;return}(r||e.startsWith(`##`)||e.startsWith(`- `)||e.startsWith(`* `))&&n.add(t)}),kd(e,Od(t.filter((e,t)=>n.has(t)).join(`
|
|
236
|
+
`),.65,e.length))}function Id(e){return kd(e,Od(e.split(/\r?\n/u).filter(e=>e.startsWith(`#`)||e.startsWith(`- `)||/\d/.test(e)||/\d+%/.test(e)||Sd.test(e)).join(`
|
|
237
|
+
`),.6,e.length))}function Ld(e){return kd(e,Od(e.split(/\r?\n/u).filter(e=>e.startsWith(`- `)||e.startsWith(`* `)||Cd.test(e)).join(`
|
|
238
|
+
`),.5,e.length))}function Rd(e,t){switch(e){case`file-card`:return Md(t);case`search-result`:return Nd(t);case`decision`:return Pd(t);case`pattern`:return Fd(t);case`analysis`:return Id(t);case`step-summary`:return Ld(t)}}const zd={decision:6,pattern:5,"file-card":4,analysis:3,"search-result":2,"step-summary":1},Bd={"search-result":864e5,"file-card":1728e5,analysis:1728e5,"step-summary":2592e5,decision:6048e5,pattern:6048e5},Vd={implementer:{name:`implementer`,contextTypes:[`file-card`,`decision`,`pattern`],priority:{...zd}},documenter:{name:`documenter`,contextTypes:[`decision`,`pattern`,`step-summary`],priority:{...zd}},reviewer:{name:`reviewer`,contextTypes:[`file-card`,`search-result`,`decision`,`pattern`,`step-summary`,`analysis`],priority:{...zd}},researcher:{name:`researcher`,contextTypes:[`search-result`,`decision`,`analysis`],priority:{...zd}},debugger:{name:`debugger`,contextTypes:[`file-card`,`search-result`,`pattern`,`analysis`],priority:{...zd}}};function Hd(e){return Vd[e]}function Ud(e,t,n=Date.now()){let r=n-t;if(r<36e5)return!1;let i=Bd[e];return i==null?!1:r>i}function Wd(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=Rd(e.type,e.content),r=t.length;o+r>n||(a.push({type:e.type,content:t}),o+=r)}return a}function Gd(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 Kd(e){let t=new Set,n=[];for(let r of e){let e=Gd(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 qd(e){if(e.startsWith(`.ai/curated/`))return e.slice(12)}const Jd=L(`tools`),Yd=B.enum([`remember`,`read`,`update`,`forget`,`list`,`history`,`diff`,`recover`,`orphaned`,`withdraw`,`flush`,`flagged`,`lesson`]),Xd=B.string().min(3).max(120).describe(`Short descriptive title for the knowledge entry`),Zd=B.string().min(10).max(1e5),Qd=B.string().regex(/^[a-z][a-z0-9-]*$/).describe(`Category slug (e.g., "decisions", "patterns", "conventions", "api-contracts")`),$d=B.array(B.string()).default([]).describe(`Optional tags for filtering`),ef=B.string().describe(`Relative path within .ai/curated/ (e.g., "decisions/use-lancedb.md")`),tf=B.string().min(3),nf=B.object({title:Xd,content:Zd.describe(`The markdown content to store`),category:Qd,tags:$d,force:B.boolean().optional().describe(`When true, supersede flagged similar entries without waiting for confirmation`)}),rf=B.object({path:ef}),af=B.object({path:ef,content:Zd.describe(`New markdown content to replace existing content`),reason:tf.max(1e3).describe(`Why this update is being made (recorded in changelog)`)}),of=B.object({path:B.string().describe(`Relative path within .ai/curated/ (e.g., "decisions/deprecated-approach.md")`),reason:tf.describe(`Why this entry is being removed`)}),sf=B.object({category:B.string().optional().describe(`Filter by category (e.g., "decisions", "patterns")`),tag:B.string().optional().describe(`Filter by tag`),limit:B.number().int().min(1).max(200).default(50).describe(`Maximum entries to return`),offset:B.number().int().min(0).default(0).describe(`Pagination offset`)}),cf=B.enum([`create`,`confirm`,`contradict`,`list-lessons`,`auto-observe`,`prune`,`group`,`promote`,`demote`]),lf=B.enum([`confidence`,`recent`]),uf=B.number().int().min(0).max(100).describe(`Lesson confidence from 0-100`),df=B.object({action:Yd.describe(`Knowledge operation to perform`),title:Xd.optional(),content:Zd.optional(),category:Qd.optional(),tags:B.array(B.string()).optional().describe(`Optional tags for remember`),path:ef.optional(),reason:tf.max(1e3).optional(),scope:B.enum([`curated`,`flow`]).optional().describe(`Storage scope: curated (default) or flow-scoped ephemeral context`),profile:B.string().optional().describe(`Role profile for withdraw filtering (e.g., "implementer", "reviewer", "debugger")`),budget:B.number().int().min(100).max(5e4).optional().describe(`Maximum character budget for withdraw results (default: 6000)`),token_budget:B.number().int().min(50).max(12500).optional().describe(`Token budget (overrides budget). Approx 4 chars per token.`),tag:B.string().optional().describe(`Filter by tag when action="list"`),id:ef.optional().describe(`Alias for path when action="lesson"`),subAction:cf.optional().describe(`Lesson sub-action when action="lesson"`),bufferPath:B.string().optional().describe(`Optional observation buffer path for lesson auto-observe`),context:Zd.optional().describe(`What happened (the situation) for lesson creation`),insight:Zd.optional().describe(`What was learned (the lesson) for lesson creation`),evidence:Zd.optional().describe(`Proof or justification for lesson creation`),confidence:uf.optional(),minConfidence:uf.optional().describe(`Minimum confidence when listing lessons`),topic:B.string().optional().describe(`Topic filter when listing lessons`),sortBy:lf.optional().describe(`Sort lessons by confidence or recency`),includeArchived:B.boolean().optional().describe(`Include auto-archived lessons in list-lessons`),maxConfidence:uf.optional().describe(`Prune lessons below this effective confidence`),minIdleDays:B.number().int().min(1).optional().describe(`Minimum idle days required before pruning a lesson`),safetyDays:B.number().int().min(0).optional().describe(`Never prune if accessed within this many days`),maxPrune:B.number().int().min(1).max(1e3).optional().describe(`Maximum number of lessons to prune in one run`),similarityThreshold:B.number().min(0).max(1).optional().describe(`Minimum Jaccard similarity required to group lesson titles`),minGroupSize:B.number().int().min(2).max(1e3).optional().describe(`Minimum number of lessons required to form a group`),maxGroups:B.number().int().min(1).max(1e3).optional().describe(`Maximum number of lesson groups to create in one run`),minWorkspaces:B.number().int().min(2).max(1e3).optional().describe(`Minimum number of distinct workspaces required before promoting a lesson`),minAvgConfidence:uf.optional().describe(`Minimum average lesson confidence required before promoting a lesson`),dryRun:B.boolean().optional().describe(`Preview the operation without modifying stored lessons`),limit:B.number().int().min(1).max(200).optional().describe(`Maximum entries to return for list/history operations`),offset:B.number().int().min(0).optional().describe(`Pagination offset when action="list"`),force:B.boolean().optional().describe(`When true, supersede flagged similar entries without waiting for confirmation`),from_sha:B.string().optional().describe(`Start SHA for diff (older version). If omitted with to_sha, shows full content.`),to_sha:B.string().optional().describe(`End SHA for diff (newer version). If omitted, uses the latest two versions.`),max_tokens:B.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:B.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)});function ff(e,t){return[`knowledge`,e,t.path,t.id,t.title,t.topic,t.category,t.tag,t.profile].filter(e=>typeof e==`string`&&e.length>0).join(` `)}async function pf(e,t,n){let r=e.content.find(e=>e.type===`text`);if(!r)return e;let i=r.text;if(t.enrich&&n){let e=await q(n,{query:ff(t.action,t)});i+=J(e)}t.max_tokens&&(i=z(i,t.max_tokens));let a=jl(i),o=Ml(i,a),s=a&&e.structuredContent&&typeof e.structuredContent==`object`?{...e.structuredContent,ref:a}:a?{ref:a}:e.structuredContent;return{...e,content:e.content.map(e=>e.type===`text`?{...e,text:o}:e),structuredContent:s}}const mf=B.object({title:Xd,context:Zd.describe(`What happened (the situation)`),insight:Zd.describe(`What was learned (the lesson)`),evidence:Zd.describe(`Proof or justification`),confidence:uf.default(50),tags:$d.optional().default([])}),hf=B.object({path:ef.optional(),id:ef.optional(),reason:tf.max(1e3).optional()}).refine(e=>!!(e.path??e.id),{message:`path or id is required`,path:[`path`]}),gf=B.object({topic:B.string().optional(),minConfidence:uf.optional(),tag:B.string().optional(),tags:B.array(B.string()).optional(),sortBy:lf.default(`confidence`),includeArchived:B.boolean().default(!1),limit:B.number().int().min(1).max(200).default(50),offset:B.number().int().min(0).default(0)}),_f=B.object({bufferPath:B.string().optional()}),vf=B.object({maxConfidence:uf.optional(),minIdleDays:B.number().int().min(1).optional(),safetyDays:B.number().int().min(0).optional(),maxPrune:B.number().int().min(1).max(1e3).optional(),dryRun:B.boolean().default(!0)}),yf=B.object({similarityThreshold:B.number().min(0).max(1).optional(),minGroupSize:B.number().int().min(2).max(1e3).optional(),maxGroups:B.number().int().min(1).max(1e3).optional(),dryRun:B.boolean().default(!0)}),bf=B.object({minWorkspaces:B.number().int().min(2).max(1e3).optional(),minAvgConfidence:uf.optional(),similarityThreshold:B.number().min(0).max(1).optional(),dryRun:B.boolean().default(!0)});function xf(e,t,n,r){b(e,t,n);let i=e.memoryMetaGet(t);if(!i)return;let a=g(i,{..._,...r});return a?(y(e,t,a),v(e,t,n)??e.memoryMetaGet(t)):i}function Sf(e,t){return`\n\n### ${e}\n${t.map(e=>`- **${e.title}** (${e.id}) — similarity ${e.similarity.toFixed(3)}`).join(`
|
|
239
|
+
`)}`}async function Cf(e,t,r,i){if(typeof e.list!=`function`||typeof e.read!=`function`)return[];let a=n(i),o=await e.list({category:r,limit:a.maxCompare,orderBy:`updated`,order:`desc`});return o.length===0?[]:u(t,await Promise.all(o.map(async t=>{let n=await e.read(t.path);return{id:t.path,title:n.title,content:n.content,path:t.path}})),a)}function wf(e,t,n){return{superseded:e.filter(e=>n||e.similarity>=t).map(e=>({id:e.entryId,title:e.title,similarity:e.similarity})),supersessionCandidates:n?[]:e.filter(e=>e.similarity<t).map(e=>({id:e.entryId,title:e.title,similarity:e.similarity}))}}const Tf={decisions:`decision`,patterns:`pattern`,conventions:`pattern`,context:`analysis`,session:`step-summary`},Ef=new Set([`decision`,`pattern`,`file-card`,`analysis`,`search-result`,`step-summary`]);function Df(e){if(!e)return`analysis`;let t=Tf[e]??e;return Ef.has(t)?t:`analysis`}function Of(e){let t=[...new Set(e.issues.filter(e=>e.code===`invalid_type`&&/received undefined$/i.test(e.message)).map(e=>e.path.join(`.`)).filter(e=>e.length>0))];if(t.length>0)return`Missing required fields: ${t.join(`, `)}`;let n=e.issues.map(e=>`${e.path.length>0?`${e.path.join(`.`)}: `:``}${e.message}`).join(`; `);return n.length>0?`Invalid parameters: ${n}`:`Invalid parameters.`}function kf(e,t){return e??t??``}function Af(e){return[...new Set([...e??[],`lesson`])]}function jf(e,t,n){if(e)return e.memoryMetaCreate(t,`working`),e.memoryMetaUpdateConfidence(t,n),e.memoryMetaGet(t)}function Mf(e,t,n,r=d){if(!e)return;let i=f(r);e.memoryMetaCreate(t,`working`),e.memoryMetaTouch(t);let a=n??e.memoryMetaGet(t)?.confidence??50,o=Math.min(100,a+i.implicitUseIncrement);return e.memoryMetaUpdateConfidence(t,o),e.memoryMetaGet(t)}function Nf(e){let t=e.matchAll(/(?:\.ai\/curated\/)?(lessons\/[A-Za-z0-9._/%-]+\.md)/g);return[...new Set(Array.from(t,e=>e[1]))]}async function Pf(e,t,n){let r=await e.read(n),i=a(r.content),o=t?.memoryMetaGet(n)?.confidence??i.confidence??50;return{entry:r,confidence:o,meta:jf(t,n,o)??t?.memoryMetaGet(n)}}function Ff(e){if(typeof e!=`object`||!e)return e;let t=e;if(t.title)return e;let n=typeof t.topic==`string`&&t.topic||typeof t.insight==`string`&&t.insight||``;if(!n)return e;let r=n.length<=120?n:`${n.slice(0,117)}...`;return{...t,title:r}}async function If(e,{curated:t,stateStore:n,resourceNotifier:r}){let i=Ff(e),{title:a,context:o,insight:s,evidence:c,confidence:l,tags:u}=mf.parse(i),d=h({title:a,context:o,insight:s,evidence:c,confidence:l,tags:u}),f=await t.remember(a,d,`lessons`,Af(u));return jf(n,f.path,l),r&&r.notifyAfterCuratedWrite(f.path).catch(()=>{}),{content:[{type:`text`,text:`Recorded lesson: **${a}**\n\nStored at \`.ai/curated/${f.path}\` with confidence ${l}/100.`}],structuredContent:{path:f.path,confidence:l,category:`lessons`,tags:Af(u)}}}async function Lf(e,t,n){let{curated:i,stateStore:a,resourceNotifier:o,retentionConfig:s,consolidationConfig:c,lessonConfig:u}=n,p=hf.parse(e);if(t===`contradict`&&!p.reason)throw new B.ZodError([{code:`custom`,path:[`reason`],message:`reason is required`}]);let m=kf(p.path,p.id),h=f(u??d);a&&xf(a,m,s,c);let{entry:g,confidence:_}=await Pf(i,a,m),v=r(_,t,h),y=l(g.content,v),b=t===`confirm`?p.reason??`Confirmed lesson confidence`:`Contradicted lesson confidence: ${p.reason}`,x=await i.update(m,y,b);return a&&a.memoryMetaUpdateConfidence(m,v),o&&o.notifyAfterCuratedWrite(m).catch(()=>{}),{content:[{type:`text`,text:`${t===`confirm`?`Confirmed`:`Contradicted`} lesson: \`${m}\`\n\nConfidence ${_}/100 → ${v}/100.`}],structuredContent:{path:x.path,confidence:v,previousConfidence:_,version:x.version}}}async function Rf(e,{curated:t,stateStore:n,lessonConfig:r}){let{topic:i,minConfidence:a,tag:s,tags:l,sortBy:u,includeArchived:p,limit:h,offset:g}=gf.parse(e),_=Af([...l??[],...s?[s]:[]]),v=f(r??d),y=Math.max(h+g,500),b=await t.listPage({category:`lessons`,...s?{tag:s}:{},limit:y,orderBy:`updated`,order:`desc`}),x=b.entries,S=await Promise.all(x.filter(e=>e.tags.includes(`lesson`)).map(async e=>{let{confidence:r,meta:i}=await Pf(t,n,e.path),a=i??n?.memoryMetaGet(e.path);a&&a.supersededBy===null&&o(a,v)&&n?.memoryMetaSetSuperseded(e.path,m);let s=n?.memoryMetaGet(e.path)??a,l=s?.createdAt??e.created,u=s?.confidence??r,d=c(u,s?.lastAccessedAt,l,v),f=s?.lastAccessedAt??s?.createdAt??null;return{path:e.path,title:e.title,category:e.category,tags:e.tags,version:e.version,preview:e.contentPreview,confidence:d,storedConfidence:u,createdAt:l,lastAccessedAt:s?.lastAccessedAt??null,recency:f,archived:s?.supersededBy===m,supersededBy:s?.supersededBy??null}})),C=S.filter(e=>e.archived).length,w=S.filter(e=>p?!0:e.supersededBy===null).filter(e=>a===void 0?!0:e.confidence>=a).filter(e=>_.length===0?!0:_.every(t=>e.tags.includes(t))).filter(e=>i?`${e.title}\n${e.preview}\n${e.tags.join(` `)}`.toLowerCase().includes(i.toLowerCase()):!0).sort((e,t)=>u===`recent`?Date.parse(t.recency??``)-Date.parse(e.recency??``)||t.confidence-e.confidence:t.confidence-e.confidence||Date.parse(t.recency??``)-Date.parse(e.recency??``)),T=w.slice(g,g+h);if(w.forEach(e=>{Mf(n,e.path,e.storedConfidence,v)}),T.length===0)return{content:[{type:`text`,text:`No lessons matched the requested filters.`}],structuredContent:{entries:[],totalCount:w.length,scannedCount:S.length,limit:h,offset:g,hasMore:w.length>g+h||b.hasMore,archivedCount:C}};let E=T.map(e=>{let t=e.recency?` | recent ${e.recency}`:``;return`- **${e.title}** (${e.confidence}/100)${t}\n \`${e.path}\` — ${e.preview.slice(0,80)}…`}).join(`
|
|
240
|
+
`);return{content:[{type:`text`,text:`## Lessons (${T.length} of ${w.length})\n\n${E}`}],structuredContent:{entries:T.map(({storedConfidence:e,...t})=>t),totalCount:w.length,scannedCount:S.length,limit:h,offset:g,hasMore:w.length>g+h||b.hasMore,archivedCount:C}}}function zf(e){if(e){let t=I(e);return M(t)?t:void 0}return le(zn(),{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.startsWith(`aikit-obs-`)&&e.name.endsWith(`.jsonl`)).map(e=>F(zn(),e.name)).sort((e,t)=>fe(t).mtimeMs-fe(e).mtimeMs)[0]}function Bf(e,t){return t.map(t=>({path:t.path,title:t.title,similarity:p(e,t.title)})).filter(e=>e.similarity>.8).sort((e,t)=>t.similarity-e.similarity)[0]}async function Vf(e,{curated:t,stateStore:n,resourceNotifier:r}){let{bufferPath:i}=_f.parse(e),a=zf(i);if(!a)return{content:[{type:`text`,text:`No observation buffer found for auto-observe.`}],structuredContent:{bufferPath:null,observations:0,createdCount:0,skippedCount:0,candidates:[]}};let o=Ei(P(a,`utf8`)),s=Ti(o,ti),c=await t.list({category:`lessons`}),l=[],u=[];try{for(let e of s){let i=Bf(e.title,c);if(i){u.push({title:e.title,path:i.path,similarity:i.similarity});continue}let a=h({title:e.title,context:e.context,insight:e.insight,evidence:e.evidence,confidence:e.confidence,tags:e.tags}),o=await t.remember(e.title,a,`lessons`,Af(e.tags));jf(n,o.path,e.confidence),l.push({path:o.path,title:e.title,detector:e.detector}),c.push({path:o.path,title:e.title,category:`lessons`,tags:Af(e.tags),version:1,created:new Date().toISOString(),updated:new Date().toISOString(),contentPreview:e.insight}),r&&r.notifyAfterCuratedWrite(o.path).catch(()=>{})}}finally{try{pe(a)}catch{}}let d=[`Auto-observe processed ${o.length} observations from \`${a}\`.`,`Created ${l.length} lessons and skipped ${u.length} duplicates from ${s.length} candidates.`];return l.length>0&&(d.push(``,`Created:`),d.push(...l.map(e=>`- **${e.title}** (${e.path})`))),u.length>0&&(d.push(``,`Skipped:`),d.push(...u.map(e=>`- **${e.title}** matched ${e.path} (${e.similarity.toFixed(2)})`))),{content:[{type:`text`,text:d.join(`
|
|
241
|
+
`)}],structuredContent:{bufferPath:a,observations:o.length,createdCount:l.length,skippedCount:u.length,candidates:s.map(e=>({title:e.title,detector:e.detector,confidence:e.confidence,tags:e.tags})),created:l,skipped:u}}}function Hf(e){let t=[`Lesson prune ${e.dryRun?`preview`:`completed`}: ${e.pruned.length} lessons selected.`,`Skipped ${e.skipped} lessons.`];return e.pruned.length>0&&(t.push(``,`Pruned:`),t.push(...e.pruned.map(e=>`- ${e}`))),t.join(`
|
|
242
|
+
`)}function Uf(e){let t=[`Lesson grouping ${e.dryRun?`preview`:`completed`}: ${e.groupsCreated} groups, ${e.lessonsGrouped} lessons.`];return e.groups.length>0&&(t.push(``,`Groups:`),t.push(...e.groups.map(e=>`- ${e.label}: ${e.members.join(`, `)}`))),t.join(`
|
|
243
|
+
`)}function Wf(e,n){let r=e;return new t(n,r.store,r.embedder)}function Gf(e,t){let n=e.candidates.filter(e=>e.action===`promote`),r=e.candidates.filter(e=>e.action===`skip`),i=[`Lesson promotion ${t?`preview`:`completed`}: ${n.length} candidates ready.`,`Skipped ${r.length} candidates.`];return n.length>0&&(i.push(``,`Candidates:`),i.push(...n.map(e=>`- ${e.insight} (${e.foundIn.join(`, `)}) avg ${e.avgConfidence}/100`))),r.length>0&&(i.push(``,`Skipped:`),i.push(...r.map(e=>`- ${e.insight}: ${e.reason}`))),e.promoted.length>0&&(i.push(``,`Promoted:`),i.push(...e.promoted.map(e=>`- ${e}`))),i.join(`
|
|
244
|
+
`)}async function Kf(e,t){switch(e.subAction??`create`){case`create`:return If(e,t);case`confirm`:return Lf(e,`confirm`,t);case`contradict`:return Lf(e,`contradict`,t);case`list-lessons`:return Rf(e,t);case`auto-observe`:return Vf(e,t);case`prune`:{if(!t.stateStore)return Y(`VALIDATION`,`StateStore required for lesson/prune`);let n=vf.parse(e),r=await E(t.curated,t.stateStore,{maxConfidence:n.maxConfidence,minIdleDays:n.minIdleDays,safetyDays:n.safetyDays,maxPrune:n.maxPrune,dryRun:n.dryRun},t.lessonConfig?f(t.lessonConfig):d);return{content:[{type:`text`,text:Hf(r)}],structuredContent:r}}case`group`:{if(!t.stateStore)return Y(`VALIDATION`,`StateStore required for lesson/group`);let n=yf.parse(e),r=await T(t.curated,t.stateStore,{similarityThreshold:n.similarityThreshold,minGroupSize:n.minGroupSize,maxGroups:n.maxGroups,dryRun:n.dryRun});return{content:[{type:`text`,text:Uf(r)}],structuredContent:r}}case`promote`:{if(!Pe())return{content:[{type:`text`,text:`Promotion requires user-level install (not workspace-scoped).`}]};let n=bf.parse(e),r={minWorkspaces:n.minWorkspaces??ne.minWorkspaces,minAvgConfidence:n.minAvgConfidence??ne.minAvgConfidence,similarityThreshold:n.similarityThreshold??ne.similarityThreshold,dryRun:n.dryRun},i=await D(te(await k(),r),Wf(t.curated,O()),r);return{content:[{type:`text`,text:Gf(i,r.dryRun)}],structuredContent:i}}case`demote`:{if(!Pe())return{content:[{type:`text`,text:`Demotion requires user-level install.`}]};let n=kf(e.path,e.id);if(!n)return{content:[{type:`text`,text:`Missing required "path" or "id" parameter for demote.`}]};let r=await ee(Wf(t.curated,O()),n);return{content:[{type:`text`,text:r.removed?`Demoted: ${n}`:`Not found in global: ${n}`}],structuredContent:r}}}}async function qf(e,t){if(e.scope===`flow`){let{flowContextAdapter:n,stateStore:r}=t;if(!n)return{content:[{type:`text`,text:`Flow context not available.`}]};let{title:i,content:a,category:o}=nf.parse(e),s=`${Df(o)}/${i.toLowerCase().replace(/[^a-z0-9]+/g,`-`).slice(0,60)}.md`;return await n.write(s,`# ${i}\n\n${a}`),r?.memoryMetaCreate(s,`working`),{content:[{type:`text`,text:`Deposited flow context: **${i}** at \`${s}\``}]}}let{curated:r,policyStore:i,evolutionCollector:a,resourceNotifier:o,stateStore:c,supersessionConfig:l}=t,{title:u,content:d,category:f,tags:p,force:m=!1}=nf.parse(e),h=n(l),g=await Cf(r,d,f,h),_=await r.remember(u,d,f,p);c?.memoryMetaCreate(_.path,`working`);let v=wf(g,h.autoThreshold,m);if(c)for(let e of v.superseded)s(c,e.id,_.path);let y=``;if(i){let e=i.classify(u,d,p);a&&a.recordClassification(u,e.matchingRules.map(e=>e.ruleId),e.pushRecommended),e.matchingRules.length>0&&(y=`\n\n### Classification Signals\n${e.matchingRules.map(e=>` - **${e.ruleId}** (${e.category}, weight: ${e.pushWeight}) — matched: ${e.matchedPatterns.join(`, `)}`).join(`
|
|
245
245
|
`)}\n- **Push recommended**: ${e.pushRecommended?`yes`:`no`} (max weight: ${e.maxPushWeight})`,e.pushRecommended&&(y+=`
|
|
246
246
|
|
|
247
|
-
> 💡 This entry matches push rules. Consider \`er_push\` to share with Enterprise RAG.`))}o&&o.notifyAfterCuratedWrite(_.path).catch(()=>{});let b=
|
|
248
|
-
`),l=
|
|
249
|
-
`);return{content:[{type:`text`,text:`## Flow Context (${e.length} entries)\n\n${a}`}],structuredContent:{entries:t.map(({entry:e,retentionMeta:t})=>({path:e.path,size:e.size,...t?{retentionScore:t.retentionScore,tier:t.tier}:{}})),totalCount:e.length}}}let{category:a,tag:o}=
|
|
250
|
-
`),
|
|
251
|
-
`);return{content:[{type:`text`,text:`## History for \`${n}\` (${i.length} entries)\n\n${a}\n\n_Use \`knowledge({ action: "diff", path: "${n}", from_sha: "...", to_sha: "..." })\` to compare versions._`}]}}async function
|
|
252
|
-
`);return{content:[{type:`text`,text:`## Orphaned Knowledge Entries (${n.length})\n\nThese entries exist in git but are missing from the filesystem:\n\n${r}\n\n_Use \`knowledge({ action: "recover", path: "..." })\` to restore any of these entries._`}]}}async function
|
|
247
|
+
> 💡 This entry matches push rules. Consider \`er_push\` to share with Enterprise RAG.`))}o&&o.notifyAfterCuratedWrite(_.path).catch(()=>{});let b=Gd(_.path,u,`[${f}]`),x=v.superseded.length>0?Sf(`Superseded Entries`,v.superseded):``,S=v.supersessionCandidates.length>0?Sf(`Supersession Suggestions`,v.supersessionCandidates):``;return{content:[{type:`text`,text:`Remembered: **${u}**\n\nStored at \`.ai/curated/${_.path}\` and indexed for semantic search.${y}${x}${S}\n\n---\n_Next: Use \`search\` to verify the entry is findable, or \`knowledge({ action: "list" })\` to see all curated entries._`},...b?[b]:[]],structuredContent:{path:_.path,superseded:v.superseded,supersessionCandidates:v.supersessionCandidates}}}async function Jf(e,{curated:t,stateStore:n,retentionConfig:r,consolidationConfig:i}){let{path:a}=rf.parse(e),o=await t.read(a),s=n?xf(n,a,r,i):void 0,c=[`## ${o.title}`,`- **Path**: .ai/curated/${a}`,`- **Category**: ${o.category}`,o.tags.length?`- **Tags**: ${o.tags.join(`, `)}`:null,`- **Version**: ${o.version}`,`- **Created**: ${o.created}`,o.updated===o.created?null:`- **Updated**: ${o.updated}`,s?`- **Tier**: ${s.tier}`:null,s?`- **Retention**: ${s.retentionScore.toFixed(3)}`:null,``].filter(e=>e!==null).join(`
|
|
248
|
+
`),l=Gd(a,o.title,`[${o.category}]`);return{content:[{type:`text`,text:`${c}\n${o.content}\n\n---\n_Next: Use \`knowledge({ action: "update", ... })\` to modify this entry, or \`search\` to find related entries._`},...l?[l]:[]]}}async function Yf(e,{curated:t,resourceNotifier:n}){let{path:r,content:i,reason:a}=af.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 Xf(e,{curated:t,resourceNotifier:n}){let{path:r,reason:i}=of.parse(e),a=I(t.curatedDir,r);if(M(a))try{$e(`forget`,[{path:a,content:P(a,`utf-8`)}],`forget: ${r}`)}catch{}let o=await t.forget(r,i);return Jd.info(`Forgot entry`,{path:o.path,reason:i}),n&&(n.notifyAfterCuratedWrite().catch(()=>{}),n.notifyResourceListChanged().catch(()=>{})),{content:[{type:`text`,text:`Forgotten: \`.ai/curated/${o.path}\`\n\nRemoved from disk and vector store.\nReason: ${i}\n\n---\n_Next: Use \`knowledge({ action: "list" })\` to verify removal, or \`search\` to confirm the entry is no longer returned._`}]}}async function Zf(e,{curated:t,flowContextAdapter:n,stateStore:r,retentionConfig:i}){if(e.scope===`flow`){if(!n)return{content:[{type:`text`,text:`Flow context not available.`}]};let e=await n.list();if(e.length===0)return{content:[{type:`text`,text:`No flow context entries.`}]};let t=e.map(e=>({entry:e,retentionMeta:r?v(r,e.path,i):void 0})),a=t.map(({entry:e,retentionMeta:t})=>{let n=t?`, tier ${t.tier}, retention ${t.retentionScore.toFixed(3)}`:``;return`- \`${e.path}\` (${e.size} bytes${n})`}).join(`
|
|
249
|
+
`);return{content:[{type:`text`,text:`## Flow Context (${e.length} entries)\n\n${a}`}],structuredContent:{entries:t.map(({entry:e,retentionMeta:t})=>({path:e.path,size:e.size,...t?{retentionScore:t.retentionScore,tier:t.tier}:{}})),totalCount:e.length}}}let{category:a,tag:o,limit:s,offset:c}=sf.parse(e),l=await t.listPage({category:a,tag:o,limit:s,offset:c,orderBy:`updated`,order:`desc`}),u=l.entries,d=u.map(e=>({entry:e,retentionMeta:r?v(r,e.path,i):void 0})),f={entries:d.map(({entry:e,retentionMeta:t})=>({path:e.path,title:e.title,category:e.category,tags:e.tags,version:e.version,preview:e.contentPreview?.slice(0,120)??``,...t?{retentionScore:t.retentionScore,tier:t.tier}:{}})),totalCount:l.totalCount,returnedCount:u.length,limit:l.limit,offset:l.offset,hasMore:l.hasMore};if(u.length===0)return{content:[{type:`text`,text:`No curated knowledge entries found.`+(a?` (category: ${a})`:``)+(o?` (tag: ${o})`:``)}],structuredContent:f};let p=d.map(({entry:e,retentionMeta:t})=>{let n=e.tags.length>0?` [${e.tags.join(`, `)}]`:``,r=t?` | tier ${t.tier} | retention ${t.retentionScore.toFixed(3)}`:``;return`- **${e.title}** (v${e.version})${n}${r}\n \`${e.path}\` — ${e.contentPreview.slice(0,80)}…`}).join(`
|
|
250
|
+
`),m=Kd(u),h=l.hasMore?`\n\n_Showing ${u.length} of ${l.totalCount} entries. Request \`offset: ${l.offset+u.length}\` for next page._`:l.totalCount>u.length?`\n\n_Showing ${u.length} of ${l.totalCount} entries._`:``;return{content:[{type:`text`,text:`## Curated Knowledge (${u.length} of ${l.totalCount} entries)\n\n${p}${h}\n\n---\n_Next: Use \`knowledge({ action: "read", path: "..." })\` to view full content of any entry, or \`knowledge({ action: "remember", ... })\` to store new knowledge._`},...m],structuredContent:f}}async function Qf(e,{curated:t}){let{path:n}=rf.parse(e),r=e.limit??20,i=await t.history(n,r);if(i.length===0)return{content:[{type:`text`,text:`No git history available for this entry. Git-backing may not be available or the entry predates git-backing.`}]};let a=i.map((e,t)=>`${t+1}. **${e.date}** \`${e.sha.slice(0,8)}\` — ${e.message}`).join(`
|
|
251
|
+
`);return{content:[{type:`text`,text:`## History for \`${n}\` (${i.length} entries)\n\n${a}\n\n_Use \`knowledge({ action: "diff", path: "${n}", from_sha: "...", to_sha: "..." })\` to compare versions._`}]}}async function $f(e,{curated:t}){let{path:n}=rf.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 ep(e,{curated:t}){let{path:n}=rf.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 tp(e,{curated:t}){let n=await t.listOrphaned();if(n.length===0)return{content:[{type:`text`,text:`No orphaned entries found. All git-backed entries have corresponding filesystem files.`}]};let r=n.map((e,t)=>`${t+1}. \`${e.path}\` — last: ${e.lastMessage}`).join(`
|
|
252
|
+
`);return{content:[{type:`text`,text:`## Orphaned Knowledge Entries (${n.length})\n\nThese entries exist in git but are missing from the filesystem:\n\n${r}\n\n_Use \`knowledge({ action: "recover", path: "..." })\` to restore any of these entries._`}]}}async function np(e,{curated:t,flowContextAdapter:n,stateStore:r,retentionConfig:i,consolidationConfig:a,lessonConfig:o}){let s=B.object({profile:B.string(),budget:B.number().int().min(100).max(5e4).default(6e3).describe(`Character budget for withdraw results`),token_budget:B.number().int().min(50).max(12500).optional().describe(`Token budget (overrides budget). Approx 4 chars per token.`)}).parse(e),c=s.token_budget?s.token_budget*4:s.budget;if(!n)return{content:[{type:`text`,text:`Flow context not available — no active flow or adapter not configured.`}]};let l=Hd(s.profile);if(!l)return{content:[{type:`text`,text:`Unknown profile: "${s.profile}". Available: implementer, documenter, reviewer, researcher, debugger`}]};let u=await n.list();if(u.length===0)return{content:[{type:`text`,text:`No flow context available yet. Context is deposited automatically as agents use search, file_summary, and other analysis tools.`}]};let p=Date.now(),m=u.filter(e=>{let t=e.path.split(`/`)[0];return Ef.has(t)?!Ud(t,e.mtimeMs,p):!0}),h=(await Promise.all(m.map(async e=>{let t=e.path.split(`/`),o=t[0];if(t.length<2||!Ef.has(o))return null;let s=await n.read(e.path);return s?(r&&xf(r,e.path,i,a),{type:o,content:s}):null}))).filter(e=>e!==null),g=Wd(h,l,c),_=f(o??d),v=[...new Set(g.flatMap(e=>Nf(e.content)))];if(await Promise.all(v.map(async e=>{let n=r?.memoryMetaGet(e)?.confidence;if(n===void 0)try{n=(await Pf(t,r,e)).confidence}catch{return}Mf(r,e,n,_)})),g.length===0)return{content:[{type:`text`,text:`No relevant context for profile "${s.profile}". ${h.length} entries available but none match your role's context types.`}]};let y=g.map(e=>`### [${e.type}]\n${e.content}`).join(`
|
|
253
253
|
|
|
254
|
-
`),b=g.reduce((e,t)=>e+t.content.length,0);return{content:[{type:`text`,text:`## Flow Context (${g.length}/${h.length} entries, ${b} chars, profile: ${s.profile})\n\n${y}`}]}}async function
|
|
254
|
+
`),b=g.reduce((e,t)=>e+t.content.length,0);return{content:[{type:`text`,text:`## Flow Context (${g.length}/${h.length} entries, ${b} chars, profile: ${s.profile})\n\n${y}`}]}}async function rp(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 ip(e,{curated:t,stateStore:n,retentionConfig:r,lessonConfig:a}){if(!n)return{content:[{type:`text`,text:`Retention state store not available.`}],structuredContent:{entries:[],totalCount:0}};let o=S(n,r),s=f(a??d),l=await t.list({category:`lessons`}),u=(await Promise.all(l.filter(e=>e.tags.includes(`lesson`)).map(async e=>{let r=n.memoryMetaGet(e.path);return r||=(await Pf(t,n,e.path)).meta,!r||!i(r,s)?null:{path:e.path,title:e.title,confidence:c(r.confidence,r.lastAccessedAt,r.createdAt,s),createdAt:r.createdAt,lastAccessedAt:r.lastAccessedAt,supersededBy:r.supersededBy}}))).filter(e=>e!==null).sort((e,t)=>e.confidence-t.confidence||Date.parse(e.lastAccessedAt??e.createdAt)-Date.parse(t.lastAccessedAt??t.createdAt));if(o.length===0&&u.length===0)return{content:[{type:`text`,text:`No flagged knowledge entries found below the current retention threshold.`}],structuredContent:{entries:[],totalCount:0}};let p=o.length===0?`### Retention
|
|
255
255
|
None.`:`### Retention\n${o.map(e=>`- \`${e.entryId}\` — score ${e.retentionScore.toFixed(3)}, tier ${e.tier}, accesses ${e.accessCount}`).join(`
|
|
256
256
|
`)}`,m=u.length===0?`### Stale Lessons
|
|
257
257
|
None.`:`### Stale Lessons\n${u.map(e=>`- **${e.title}** (\`${e.path}\`) — effective confidence ${e.confidence}/100, last access ${e.lastAccessedAt??e.createdAt}`).join(`
|
|
258
|
-
`)}`;return{content:[{type:`text`,text:`## Flagged Knowledge Entries (${o.length+u.length})\n\n${p}\n\n${m}`}],structuredContent:{entries:o,staleLessons:u,totalCount:o.length+u.length}}}async function
|
|
259
|
-
|
|
260
|
-
`),s=
|
|
261
|
-
`).replace(/\\t/g,` `)}))}]}}catch(e){return
|
|
262
|
-
`)}function
|
|
263
|
-
`)}function
|
|
264
|
-
`)||`No tools matched the filter.`}]}})),e.registerTool(`describe_tool`,{title:
|
|
265
|
-
`):`No tools found matching "${e}"`}]}}))}const
|
|
266
|
-
`),`utf8`),
|
|
267
|
-
`);if(c&&a){let e=await
|
|
268
|
-
`)}]}}case`delete`:if(!t)throw Error(`name required for delete`);return{content:[{type:`text`,text:it(t)?`Deleted workset "${t}".`:`Workset "${t}" not found.`}]};case`add`:{if(!t||!n)throw Error(`name and files required for add`);let e=Re(t,n);return{content:[{type:`text`,text:`Added to workset "${e.name}": now ${e.files.length} files.`}]}}case`remove`:{if(!t||!n)throw Error(`name and files required for remove`);let e=en(t,n);return e?{content:[{type:`text`,text:`Removed from workset "${e.name}": now ${e.files.length} files.`}]}:{content:[{type:`text`,text:`Workset "${t}" not found.`}]}}}}catch(e){return
|
|
269
|
-
`)}]}}case`delete`:if(!n)throw Error(`key required for delete`);return{content:[{type:`text`,text:hn(t,n)?`Deleted stash entry "${n}".`:`Stash entry "${n}" not found.`}]};case`clear`:{let e=mn(t);return{content:[{type:`text`,text:`Cleared ${e} stash entr${e===1?`y`:`ies`}.`}]}}}}catch(e){return
|
|
270
|
-
`)}]}}case`latest`:{let e=Ke(t,{label:n});return{content:[{type:`text`,text:e
|
|
258
|
+
`)}`;return{content:[{type:`text`,text:`## Flagged Knowledge Entries (${o.length+u.length})\n\n${p}\n\n${m}`}],structuredContent:{entries:o,staleLessons:u,totalCount:o.length+u.length}}}async function ap(e,t,n){switch(e){case`remember`:return qf(t,n);case`read`:return Jf(t,n);case`update`:return Yf(t,n);case`forget`:return Xf(t,n);case`list`:return Zf(t,n);case`history`:return Qf(t,n);case`diff`:return $f(t,n);case`recover`:return ep(t,n);case`orphaned`:return tp(t,n);case`withdraw`:return np(t,n);case`flush`:return rp(t,n);case`flagged`:return ip(t,n);case`lesson`:return Kf(t,n)}}function op(e,t,n,r,i,a,o,s,c,l,u,d){let f=K(`knowledge`),p={curated:t,policyStore:n,evolutionCollector:r,resourceNotifier:i,flowContextAdapter:a,stateStore:o,retentionConfig:s,consolidationConfig:l,supersessionConfig:c,lessonConfig:u};e.registerTool(`knowledge`,{title:f.title,description:"Operate on curated knowledge entries with a single tool. Use `action` to remember, read, update, forget, list, history, diff, recover, orphaned, withdraw, flush, flagged, or lesson entries.",inputSchema:df.shape,annotations:f.annotations},X(`knowledge`,async({action:e,...t})=>{try{let n=df.parse({action:e,...t});return await pf(await ap(n.action,n,p),n,d)}catch(e){return e instanceof B.ZodError?Y(`VALIDATION`,Of(e)):(Jd.error(`Knowledge operation failed`,R(e)),Y(`INTERNAL`,`Knowledge operation failed: ${e instanceof Error?e.message:String(e)}`))}}))}const sp=L(`tools`);function cp(e,t,n){let r=K(`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:B.string().describe(`Relative file path to look up (e.g., "src/index.ts")`),enrich:B.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},X(`lookup`,async({path:e,enrich:r})=>{try{let i=await t.getBySourcePath(e);if(i.length===0)return{content:[{type:`text`,text:`No indexed content found for: ${e}`}]};i.sort((e,t)=>e.chunkIndex-t.chunkIndex);let a=`## ${e}\n**Chunks**: ${i.length} | **Type**: ${i[0].contentType}\n`,o=i.map(e=>{let t=e.startLine?` (lines ${e.startLine}-${e.endLine})`:``;return`### Chunk ${e.chunkIndex+1}/${e.totalChunks}${t}\n${e.content}`}).join(`
|
|
259
|
+
|
|
260
|
+
`),s=qd(e),c=s?Gd(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 q(n,{query:e});l+=J(t)}return{content:[{type:`text`,text:l},...c?[c]:[]]}}catch(e){return sp.error(`Lookup failed`,R(e)),Y(`INTERNAL`,`Lookup failed: ${e instanceof Error?e.message:String(e)}`)}}))}const lp=L(`tools:manipulation`);function up(e){return e.sources[0]?.path??process.cwd()}function dp(e,t){let n=I(t,e),r=ve(t,n);if(r.startsWith(`..`)||_e(r))throw Error(`Path "${e}" escapes workspace root: ${t}`);return n}function fp(e){let t=K(`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:B.string().optional().describe(`Repository root or working directory`),commit_count:B.number().min(1).max(50).default(5).optional().describe(`How many recent commits to include`),include_diff:B.boolean().default(!1).optional().describe(`Include diff stat for working tree changes`)},annotations:t.annotations,outputSchema:tc},async({cwd:e,commit_count:t,include_diff:n})=>{try{let r=await yt({cwd:e,commitCount:t,includeDiff:n});return{content:[{type:`text`,text:_p(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 lp.error(`Git context failed`,R(e)),Y(`INTERNAL`,`Git context failed: ${e instanceof Error?e.message:String(e)}`)}})}function pp(e){let t=K(`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:B.string().max(1e6).describe(`Raw unified diff text`)},annotations:t.annotations},async({diff:e})=>{try{return{content:[{type:`text`,text:vp(at({diff:e.replace(/\\n/g,`
|
|
261
|
+
`).replace(/\\t/g,` `)}))}]}}catch(e){return lp.error(`Diff parse failed`,R(e)),Y(`INTERNAL`,`Diff parse failed: ${e instanceof Error?e.message:String(e)}`)}})}function mp(e,t){let n=K(`rename`),r=up(t);e.registerTool(`rename`,{title:n.title,description:`Rename a symbol across files using whole-word regex matching for exports, imports, and general usage references.`,inputSchema:{old_name:B.string().describe(`Existing symbol name to replace`),new_name:B.string().describe(`New symbol name to use`),root_path:B.string().describe(`Root directory to search within`),extensions:B.array(B.string()).optional().describe(`Optional file extensions to include, such as .ts,.tsx,.js,.jsx`),dry_run:B.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:n.annotations},X(`rename`,async({old_name:e,new_name:t,root_path:n,extensions:i,dry_run:a},o)=>{let s;try{s=Wc(o).createTask(`Rename Symbol`,2),s.progress(0,`Scanning for references`);let c=dp(n,r);s.progress(1,`Applying renames`);let l=await tn({oldName:e,newName:t,rootPath:c,extensions:i,dryRun:a});return s.complete(`Rename complete`),{content:[{type:`text`,text:JSON.stringify(l)}]}}catch(e){return s?.fail?.(`Rename failed`),lp.error(`Rename failed`,R(e)),Y(`INTERNAL`,`Rename failed: ${e instanceof Error?e.message:String(e)}`)}}))}function hp(e,t){let n=K(`codemod`),r=up(t);e.registerTool(`codemod`,{title:n.title,description:`Apply regex-based codemod rules across files and return structured before/after changes for each affected line.`,inputSchema:{root_path:B.string().describe(`Root directory to transform within`),rules:B.array(B.object({description:B.string().describe(`What the codemod rule does`),pattern:B.string().describe(`Regex pattern in string form`),replacement:B.string().describe(`Replacement string with optional capture groups`)})).min(1).describe(`Codemod rules to apply`),dry_run:B.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:n.annotations},X(`codemod`,async({root_path:e,rules:t,dry_run:n},i)=>{let a;try{a=Wc(i).createTask(`Codemod`,2),a.progress(0,`Scanning files`);let o=dp(e,r);a.progress(1,`Applying transforms`);let s=await Xe({rootPath:o,rules:t,dryRun:n});return a.complete(`Codemod complete`),{content:[{type:`text`,text:JSON.stringify(s)}]}}catch(e){return a?.fail?.(`Codemod failed`),lp.error(`Codemod failed`,R(e)),Y(`INTERNAL`,`Codemod failed: ${e instanceof Error?e.message:String(e)}`)}}))}function gp(e){let t=K(`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:B.string().max(5e5).describe(`Input JSON string`),expression:B.string().max(1e4).describe(`Transform expression to apply`)},annotations:t.annotations},async({input:e,expression:t})=>{try{return{content:[{type:`text`,text:tt({input:e,expression:t}).outputString}]}}catch(e){return lp.error(`Data transform failed`,R(e)),Y(`INTERNAL`,`Data transform failed: ${e instanceof Error?e.message:String(e)}`)}})}function _p(e){let t=[`Git root: ${e.gitRoot}`,`Branch: ${e.branch}`,`Staged: ${e.status.staged.length}`,...e.status.staged.map(e=>` - ${e}`),`Modified: ${e.status.modified.length}`,...e.status.modified.map(e=>` - ${e}`),`Untracked: ${e.status.untracked.length}`,...e.status.untracked.map(e=>` - ${e}`),``,`Recent commits:`];if(e.recentCommits.length===0)t.push(` none`);else for(let n of e.recentCommits)t.push(` - ${n.hash} ${n.message}`),t.push(` ${n.author} @ ${n.date}`);return e.diff&&t.push(``,`Diff stat:`,e.diff),t.join(`
|
|
262
|
+
`)}function vp(e){if(e.length===0)return`No diff files found.`;let t=[];for(let n of e){let e=n.oldPath?` (from ${n.oldPath})`:``;t.push(`${n.path}${e} [${n.status}] +${n.additions} -${n.deletions} (${n.hunks.length} hunks)`);for(let e of n.hunks){let n=e.header?` ${e.header}`:``;t.push(` @@ -${e.oldStart},${e.oldLines} +${e.newStart},${e.newLines} @@${n}`)}}return t.join(`
|
|
263
|
+
`)}function yp(e,t){return t?e.length<=500?e:`${e.slice(0,497)}...`:``}function bp(e,t){let n=[];return e.keywordRank!==void 0&&n.push(`keyword match rank ${e.keywordRank+1}`),e.vectorRank!==void 0&&n.push(`semantic match rank ${e.vectorRank+1}`),e.result.record.origin===`curated`&&n.push(`curated memory`),e.result.record.category&&n.push(`category:${e.result.record.category}`),e.result.record.tags.length>0&&n.push(`tags:${e.result.record.tags.join(`,`)}`),{id:e.result.record.id,score:e.result.score,content:yp(e.result.record.content,t),sourcePath:e.result.record.sourcePath,origin:e.result.record.origin,category:e.result.record.category,tags:e.result.record.tags,reason:n.join(`; `)||`store result`}}function xp(e,t){let n=new Map;return e.forEach((e,t)=>{n.set(e.record.id,{result:e,vectorRank:t})}),t.forEach((e,t)=>{let r=n.get(e.record.id);if(r){n.set(e.record.id,{result:{record:e.record,score:Math.max(r.result.score,e.score)},vectorRank:r.vectorRank,keywordRank:t});return}n.set(e.record.id,{result:e,keywordRank:t})}),[...n.values()].sort((e,t)=>{let n=Math.min(e.vectorRank??1/0,e.keywordRank??1/0),r=Math.min(t.vectorRank??1/0,t.keywordRank??1/0);return n===r?t.result.score-e.result.score:n-r})}async function Sp(e,t,n={}){let r=n.limit??5,i=n.candidateLimit??Math.max(r*3,10),a=n.searchMode??`hybrid`,o={limit:i,origin:n.origin??`curated`,category:n.category,tags:n.tags?[...n.tags]:void 0},[s,c]=await Promise.all([a===`keyword`?Promise.resolve([]):t.embedder.embedQuery(e).then(e=>t.store.search(e,o)).catch(()=>[]),a===`semantic`?Promise.resolve([]):t.store.ftsSearch(e,o).catch(()=>[])]),l=xp(s,c).map(e=>bp(e,n.includeContent??!0)),u=l.slice(0,r),d=l.slice(r).map(e=>({...e,ignoredReason:`lower ranked candidate outside selection limit`})),f=c.length,p=s.length;return{query:e,searchMode:a,retrieved:l,selected:u,ignored:d,finalReasoning:u.length===0?`No active matching memory was found. Deleted memories are not visible after store cleanup.`:`Selected ${u.length} of ${l.length} active candidate(s). Keyword candidates: ${f}; semantic candidates: ${p}.`}}function Cp(e,t,n){let r=K(`memory_explain`);e.registerTool(`memory_explain`,{title:r.title,description:`Explain why AI Kit memory search returns, selects, or ignores memories for a query. Debugs curated and auto-knowledge quality without invoking an LLM.`,inputSchema:{query:B.string().min(1).max(5e3).describe(`Memory query to explain`),limit:B.number().int().min(1).max(20).default(5),candidate_limit:B.number().int().min(1).max(100).optional(),search_mode:B.enum([`hybrid`,`semantic`,`keyword`]).default(`hybrid`),origin:B.enum(De).default(`curated`),category:B.string().optional(),tags:B.array(B.string()).optional(),include_content:B.boolean().default(!0)},annotations:r.annotations},async({query:e,limit:r,candidate_limit:i,search_mode:a,origin:o,category:s,tags:c,include_content:l})=>{try{let u=await Sp(e,{embedder:t,store:n},{limit:r,candidateLimit:i,searchMode:a,origin:o,category:s,tags:c,includeContent:l}),d=JSON.stringify(u,null,2),f=jl(d);return{content:[{type:`text`,text:Ml(d,f)}],structuredContent:{...u,ref:f}}}catch(e){return Y(`INTERNAL`,`memory_explain failed: ${R(e).message}`)}})}const wp=[`list_tools`,`describe_tool`,`search_tools`];function Tp(e,t,n){let r=[...new Set(n)].sort();e.registerTool(`list_tools`,{title:K(`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:B.string().optional().describe(`Optional category filter`)},annotations:K(`list_tools`).annotations},X(`list_tools`,async({category:e})=>{let t=e?.trim().toLowerCase();return{content:[{type:`text`,text:r.filter(e=>t?(G[e]?.category??[]).some(e=>e.toLowerCase()===t):!0).map(e=>{let t=G[e]??{title:e,category:[]},n=t.category?.join(`, `)||`uncategorized`;return`${e}: ${t.title} [${n}]`}).join(`
|
|
264
|
+
`)||`No tools matched the filter.`}]}})),e.registerTool(`describe_tool`,{title:K(`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:B.string().describe(`The active tool name to describe`)},annotations:K(`describe_tool`).annotations},X(`describe_tool`,async({tool_name:e})=>{if(!r.includes(e))return Y(`VALIDATION`,`Unknown or inactive tool: ${e}`);let t=G[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:K(`search_tools`).title,description:`Search active AI Kit tools by keyword across tool names, titles, and categories.`,inputSchema:{query:B.string().min(1).describe(`Keyword query to match against active tools`)},annotations:K(`search_tools`).annotations},X(`search_tools`,async({query:e})=>{let t=e.trim().toLowerCase(),n=r.filter(e=>{let n=G[e];return e.toLowerCase().includes(t)||n?.title.toLowerCase().includes(t)||(n?.category??[]).some(e=>e.toLowerCase().includes(t))}).map(e=>{let t=G[e]??{title:e,category:[]},n=t.category?.join(`, `)||`uncategorized`;return`${e}: ${t.title} [${n}]`});return{content:[{type:`text`,text:n.length>0?n.join(`
|
|
265
|
+
`):`No tools found matching "${e}"`}]}}))}const Ep=L(`server`),Dp=xe(Sr),Op={"@huggingface/transformers":`4.2.0`,"onnxruntime-common":`1.24.3`,"onnxruntime-node":`1.24.3`};function kp(e){return e.replace(/\\/g,`/`)}function Ap(e){return process.platform===`win32`?e.replace(/\//g,ye):e}function jp(){return I(ge(be(import.meta.url)),`..`,`..`,`..`)}function Mp(e){return kp(e).includes(`/_npx/`)}function Np(e){return/^(1|true)$/i.test(process.env.AIKIT_DISABLE_DEP_REPAIR??``)?!1:/^(1|true)$/i.test(process.env.AIKIT_ALLOW_DEP_REPAIR??``)?!0:Mp(e)}function Pp(e,t){let n=kp(e),r=`/node_modules/${t}/`,i=n.lastIndexOf(r);if(i<0)return null;let a=i+r.length-1,o=n.slice(0,a),s=o.search(/[A-Za-z]:\/|\//);return s<0?null:Ap(o.slice(s))}function Fp(e,t){if(!e)return Op[t]??`latest`;try{return JSON.parse(P(F(e,`package.json`),`utf8`)).version??Op[t]??`latest`}catch{return Op[t]??`latest`}}function Ip(e){let t=kp(e).toLowerCase();return/(cannot find module|cannot find package|module not found|err_module_not_found)/i.test(e)?t.includes(`@huggingface/transformers`)||t.includes(`transformers.node`)||t.includes(`onnxruntime-common`)||t.includes(`onnxruntime-node`):!1}function Lp(e){if(!Ip(e))return[];let t=kp(e).toLowerCase(),n=new Map;if(t.includes(`@huggingface/transformers`)){let t=Pp(e,`@huggingface/transformers`);n.set(`@huggingface/transformers`,`@huggingface/transformers@${Fp(t,`@huggingface/transformers`)}`)}if(t.includes(`onnxruntime-common`)){let t=Pp(e,`onnxruntime-common`);n.set(`onnxruntime-common`,`onnxruntime-common@${Fp(t,`onnxruntime-common`)}`)}if(t.includes(`onnxruntime-node`)){let t=Pp(e,`onnxruntime-node`);n.set(`onnxruntime-node`,`onnxruntime-node@${Fp(t,`onnxruntime-node`)}`)}return Array.from(n.values())}function Rp(e){if(!/index\.js/i.test(e)||!kp(e).includes(`@huggingface`))return!1;let t=Pp(e,`@huggingface/transformers`);if(!t)return!1;let n=F(t,`index.js`),r=F(t,`dist`,`transformers.node.mjs`);return M(n)||!M(r)?!1:(me(n,[`// Auto-generated by AI Kit runtime dependency repair.`,`export * from './dist/transformers.node.mjs';`,`export { default } from './dist/transformers.node.mjs';`,``].join(`
|
|
266
|
+
`),`utf8`),Ep.info(`Auto-heal: created @huggingface/transformers index.js shim`,{path:n}),!0)}async function zp(e,t={}){let n=Lp(e),r=t.packageRoot??jp(),i=Rp(e);if(n.length===0)return{attempted:i,repaired:i,packages:n,reason:i?`created transformer index shim`:`no missing runtime dependency detected`};if(!Np(r))return{attempted:i,repaired:i,packages:n,reason:`runtime dependency auto-install disabled outside npx cache; set AIKIT_ALLOW_DEP_REPAIR=1 to enable`};let a=process.platform===`win32`?`npm.cmd`:`npm`,o=[`install`,`--no-save`,`--package-lock=false`,`--no-audit`,`--no-fund`,`--omit=dev`,`--prefer-online`,`--ignore-scripts`,...n];Ep.warn(`Auto-heal: repairing missing runtime dependencies`,{packages:n,packageRoot:r});try{return await Dp(a,o,{cwd:r,timeout:t.timeoutMs??6e4,windowsHide:!0}),Ep.info(`Auto-heal: runtime dependency repair completed`,{packages:n,packageRoot:r}),{attempted:!0,repaired:!0,packages:n,reason:`npm install repair completed`}}catch(e){let t=e instanceof Error?e.message:String(e);return Ep.warn(`Auto-heal: runtime dependency repair failed`,{packages:n,packageRoot:r,...R(e)}),{attempted:!0,repaired:i,packages:n,reason:i?`created transformer shim but npm repair failed`:`npm repair failed`,error:t}}}const Bp=L(`tools`);let Vp=!1;function Hp(e){let t=e instanceof Error?e.message:String(e);return Ip(t)||/embedder worker|embedding worker|circuit breaker|timed out|killed|respawn|ipc_channel|epipe|econnreset/i.test(t)}async function Up(e,t,n){try{return await e.embedBatch(t,n)}catch(r){if((await zp(r instanceof Error?r.message:String(r))).repaired)return e.embedBatch(t,n);throw r}}async function Wp(e,t,n){for(let r of n.steps)if(!(r.status!==`success`||!r.output))try{let i=A(`sha256`).update(n.path).digest(`hex`).slice(0,12),a=`produced/onboard/${r.name}/${i}.md`,o=A(`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:A(`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 Up(t,l.map(e=>e.content));await e.upsert(l,u)}catch(e){if(Hp(e)){let t=e instanceof Error?e.message:String(e);Ee.instance().reportDegraded(`embedder`,t),Bp.warn(`Auto-persist onboard disabled — embedder unavailable`,{stepName:r.name,...R(e)});return}Bp.warn(`Auto-persist onboard step failed`,{stepName:r.name,...R(e)})}}async function Gp(e,t,n){if(n.autoRemember?.length)for(let r of n.autoRemember)try{let n=A(`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:A(`sha256`).update(r.content).digest(`hex`).slice(0,16),indexedAt:i,origin:`curated`,tags:r.tags,category:r.category,version:1},[o]=await Up(t,[a.content]);await e.upsert([a],[o])}catch(e){if(Hp(e)){let t=e instanceof Error?e.message:String(e);Ee.instance().reportDegraded(`embedder`,t),Bp.warn(`Auto-persist remember disabled — embedder unavailable`,{title:r.title,...R(e)});return}Bp.warn(`Auto-persist remember entry failed`,{title:r.title,...R(e)})}}function Kp(e,t,n,r,i,a){let o=K(`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:B.string().describe(`Root path of the codebase to onboard`),mode:B.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:B.string().optional().describe(`Custom output directory for generate mode (default: <path>/.ai/context)`),enrich:B.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},X(`onboard`,async({path:e,mode:o,out_dir:s,enrich:c},l)=>{try{if(Vp)return{content:[{type:`text`,text:`Onboard is already running. Please wait for it to complete before starting another.`}]};Vp=!0,Bp.info(`Starting onboard`,{path:e,mode:o});let u=await Ft({path:e,mode:o,outDir:s??r?.onboardDir}),d=Wc(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`),Wp(t,n,u),u.autoRemember?.length&&Gp(t,n,u).catch(e=>{Bp.warn(`Auto-persist autoRemember failed`,R(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(`
|
|
267
|
+
`);if(c&&a){let e=await q(a,{query:`onboard codebase conventions`});h+=J(e)}return{content:[{type:`text`,text:h}]}}catch(e){return Bp.error(`Onboard failed`,R(e)),Y(`INTERNAL`,`Onboard failed: ${e instanceof Error?e.message:String(e)}`)}finally{Vp=!1}}))}const qp=L(`tools:persistence`);function Jp(e){let t=K(`workset`);e.registerTool(`workset`,{title:t.title,description:`Manage named file sets (worksets). Save, load, list, add/remove files. Worksets persist across sessions in the AI Kit state directory.`,inputSchema:{action:B.enum([`save`,`get`,`list`,`delete`,`add`,`remove`]).describe(`Operation to perform`),name:B.string().optional().describe(`Workset name (required for all except list)`),files:B.array(B.string()).optional().describe(`File paths (required for save, add, remove)`),description:B.string().optional().describe(`Description (for save)`)},annotations:t.annotations},X(`workset`,async({action:e,name:t,files:n,description:r})=>{try{switch(e){case`save`:{if(!t||!n)throw Error(`name and files required for save`);let e=cn(t,n,{description:r});return{content:[{type:`text`,text:`Saved workset "${e.name}" with ${e.files.length} files.`}]}}case`get`:{if(!t)throw Error(`name required for get`);let e=vt(t);return e?{content:[{type:`text`,text:JSON.stringify(e)}]}:{content:[{type:`text`,text:`Workset "${t}" not found.`}]}}case`list`:{let e=Nt();return e.length===0?{content:[{type:`text`,text:`No worksets.`}]}:{content:[{type:`text`,text:e.map(e=>`- **${e.name}** (${e.files.length} files) — ${e.description??`no description`}`).join(`
|
|
268
|
+
`)}]}}case`delete`:if(!t)throw Error(`name required for delete`);return{content:[{type:`text`,text:it(t)?`Deleted workset "${t}".`:`Workset "${t}" not found.`}]};case`add`:{if(!t||!n)throw Error(`name and files required for add`);let e=Re(t,n);return{content:[{type:`text`,text:`Added to workset "${e.name}": now ${e.files.length} files.`}]}}case`remove`:{if(!t||!n)throw Error(`name and files required for remove`);let e=en(t,n);return e?{content:[{type:`text`,text:`Removed from workset "${e.name}": now ${e.files.length} files.`}]}:{content:[{type:`text`,text:`Workset "${t}" not found.`}]}}}}catch(e){return qp.error(`Workset operation failed`,R(e)),Y(`INTERNAL`,`Workset operation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Yp(e,t){let n=K(`stash`);e.registerTool(`stash`,{title:n.title,description:`Persist and retrieve named values in the SQLite-backed state store for intermediate results between tool calls.`,inputSchema:{action:B.enum([`set`,`get`,`list`,`delete`,`clear`]).describe(`Operation to perform on the stash`),key:B.string().optional().describe(`Entry key for set/get/delete operations`),value:B.string().optional().describe(`String or JSON value for set operations`)},annotations:n.annotations},X(`stash`,async({action:e,key:n,value:r})=>{try{switch(e){case`set`:{if(!n)throw Error(`key required for set`);let e=vn(t,n,em(r??``));return{content:[{type:`text`,text:`Stored stash entry "${e.key}" (${e.type}) at ${e.storedAt}.`}]}}case`get`:{if(!n)throw Error(`key required for get`);let e=gn(t,n);return{content:[{type:`text`,text:e?JSON.stringify(e):`Stash entry "${n}" not found.`}]}}case`list`:{let e=_n(t);return{content:[{type:`text`,text:e.length===0?`Stash is empty.`:e.map(e=>`- ${e.key} (${e.type}) — ${e.storedAt}`).join(`
|
|
269
|
+
`)}]}}case`delete`:if(!n)throw Error(`key required for delete`);return{content:[{type:`text`,text:hn(t,n)?`Deleted stash entry "${n}".`:`Stash entry "${n}" not found.`}]};case`clear`:{let e=mn(t);return{content:[{type:`text`,text:`Cleared ${e} stash entr${e===1?`y`:`ies`}.`}]}}}}catch(e){return qp.error(`Stash operation failed`,R(e)),Y(`INTERNAL`,`Stash operation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Xp(e,t){let n=K(`checkpoint`);e.registerTool(`checkpoint`,{title:n.title,description:`Save and restore lightweight session checkpoints in the SQLite-backed state store for cross-session continuity. Legacy AI Kit checkpoint directories are imported automatically on first access.`,inputSchema:{action:B.enum([`save`,`load`,`list`,`latest`,`diff`,`history`,`gc`]).describe(`Checkpoint action to perform`),label:B.string().optional().describe(`Checkpoint label for save, or checkpoint id for load`),data:B.string().max(5e5).optional().describe(`JSON object string for save actions`),notes:B.string().max(1e4).optional().describe(`Optional notes for save actions`),from_id:B.string().optional().describe(`Checkpoint ID to diff FROM (for diff action)`),to_id:B.string().optional().describe(`Checkpoint ID to diff TO (for diff action)`),limit:B.number().min(1).max(50).optional().describe(`Max history entries to return`),keep_last:B.number().min(1).max(100).optional().describe(`Keep N most recent checkpoints per label (default: 10, for gc action)`),max_age_days:B.number().min(1).optional().describe(`Delete checkpoints older than N days (for gc action)`),dry_run:B.boolean().optional().describe(`Preview changes without deleting (default: true, for gc action)`)},annotations:n.annotations},X(`checkpoint`,async({action:e,label:n,data:r,notes:i,from_id:a,to_id:o,limit:s,keep_last:c,max_age_days:l,dry_run:u})=>{try{switch(e){case`save`:if(!n)throw Error(`label required for save`);return{content:[{type:`text`,text:$p(Ye(t,n,tm(r),{notes:i}))}]};case`load`:{if(!n)throw Error(`label required for load`);let e=Je(t,n);return{content:[{type:`text`,text:e?$p(e):`Checkpoint "${n}" not found.`}]}}case`list`:{let e=qe(t,{label:n,limit:s});return{content:[{type:`text`,text:e.length===0?`No checkpoints saved.`:e.map(e=>`- ${e.id} — ${e.label} (${e.createdAt})`).join(`
|
|
270
|
+
`)}]}}case`latest`:{let e=Ke(t,{label:n});return{content:[{type:`text`,text:e?$p(e):`No checkpoints saved.`}]}}case`diff`:{if(!a||!o)throw Error(`from_id and to_id required for diff`);let e=Ue(t,a,o);return e?{content:[{type:`text`,text:[`## Checkpoint Diff: ${a} → ${o}`,e.added.length?`**Added:** ${e.added.join(`, `)}`:``,e.removed.length?`**Removed:** ${e.removed.join(`, `)}`:``,e.modified.length?`**Modified:** ${e.modified.join(`, `)}`:``,!e.added.length&&!e.removed.length&&!e.modified.length?`No differences found.`:``].filter(Boolean).join(`
|
|
271
271
|
`)}]}:{content:[{type:`text`,text:`One or both checkpoints not found.`}]}}case`history`:{if(!n)throw Error(`label required for history`);let e=Ge(t,n,{limit:s??20});return e.length===0?{content:[{type:`text`,text:`No history found for "${n}".`}]}:{content:[{type:`text`,text:`## History: ${n}\n${e.map(e=>`- ${e.sha?e.sha.slice(0,8):e.id} — ${e.createdAt}${e.label?` (${e.label})`:``}`).join(`
|
|
272
272
|
`)}`}]}}case`gc`:{let e=We(t,{label:n,keepLast:c,maxAgeDays:l,dryRun:u});return{content:[{type:`text`,text:[`## Checkpoint GC${e.labels.length?`: ${e.labels.join(`, `)}`:``}`,`Deleted: ${e.deleted}`,`Kept: ${e.kept}`,`Mode: ${u??!0?`dry-run`:`delete`}`,e.deletedIds.length?`Deleted IDs: ${e.deletedIds.join(`, `)}`:`Deleted IDs: none`].join(`
|
|
273
|
-
`)}]}}}}catch(e){return
|
|
274
|
-
`)}function
|
|
275
|
-
`)}function
|
|
276
|
-
`)}\n\n---\n_${e.length} rules total. Use \`action: "update"\` to modify a rule._`}]}}if(e===`get`){if(!n)return J(`VALIDATION`,'`rule_id` is required for "get" action.');let e=t.getRule(n);return e?{content:[{type:`text`,text:nm(e)}]}:J(`NOT_FOUND`,`Rule "${n}" not found.`)}if(e===`update`){if(!n||!r)return J(`VALIDATION`,'`rule_id` and `changes` are required for "update" action.');let e=t.updateRule(n,r);return e?{content:[{type:`text`,text:`${nm(e)}\n\n---\n_Updated. Next: Use \`action: "list"\` to verify._`}]}:J(`NOT_FOUND`,`Rule "${n}" not found.`)}return e===`create`?i?{content:[{type:`text`,text:`${nm(t.addRule(i))}\n\n---\n_Created. Next: Test classification with \`remember\`._`}]}:J(`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._`}]}:J(`NOT_FOUND`,`Rule "${n}" not found.`):J(`VALIDATION`,'`rule_id` is required for "delete" action.'):J(`VALIDATION`,`Unknown action: ${e}`)}catch(e){return tm.error(`Policy update failed`,R(e)),J(`INTERNAL`,`Policy update failed: ${e instanceof Error?e.message:String(e)}`)}}))}const im=new Map([{type:`markdown`,category:`content`,description:`Markdown content rendered with the marked parser.`,valueShape:`string`,relevantSkills:[`present`,`docs`]},{type:`code`,category:`content`,description:`Formatted code block rendered inside pre/code tags.`,valueShape:`string`,relevantSkills:[`present`,`docs`]},{type:`mermaid`,category:`visualization`,description:`Mermaid diagram source rendered in a mermaid pre block.`,valueShape:`string`,vendorScripts:[`mermaid`],relevantSkills:[`present`,`c4-architecture`,`docs`]},{type:`table`,category:`data`,description:`Tabular data rendered from records or explicit headers and rows.`,valueShape:`Record<string, unknown>[] | { headers: string[]; rows: unknown[][] }`,relevantSkills:[`present`,`docs`]},{type:`metrics`,category:`data`,description:`Metric cards showing label/value pairs with optional trend and status.`,valueShape:`Array<{ label: string; value: string | number; trend?: string | number; status?: string }>`,relevantSkills:[`present`]},{type:`cards`,category:`visualization`,description:`Card grid for titled items with optional body, badge, and status.`,valueShape:`Array<{ title: string; body?: string; badge?: string; status?: string; description?: string }>`,relevantSkills:[`present`,`docs`]},{type:`tree`,category:`visualization`,description:`Hierarchical object or name/children tree rendered recursively.`,valueShape:`{ name: string; children?: unknown[] } | Record<string, unknown>`,relevantSkills:[`present`]},{type:`graph`,category:`visualization`,description:`Node and edge graph rendered as a Mermaid flow graph in HTML mode.`,valueShape:`{ nodes: Array<{ id: string; label?: string }>; edges: Array<{ from: string; to: string; label?: string }> }`,vendorScripts:[`mermaid`],relevantSkills:[`present`,`c4-architecture`]},{type:`chart`,category:`data`,description:`Structured chart definition rendered as SVG.`,valueShape:`{ chartType: string; data: Record<string, unknown>[]; xKey: string; yKeys: string[] }`,relevantSkills:[`present`]},{type:`timeline`,category:`interactive`,description:`Timeline entries rendered as a vertical sequence of events.`,valueShape:`Array<{ title: string; description?: string; timestamp?: string; status?: string }>`,relevantSkills:[`present`]},{type:`checklist`,category:`interactive`,description:`Checklist items with boolean checked state.`,valueShape:`Array<{label, checked}> | {items: Array<{label, checked}>}`,relevantSkills:[`present`]},{type:`comparison`,category:`interactive`,description:`Side-by-side comparison columns with titled item lists.`,valueShape:`Array<{title, items}> | {columns: Array<{title, items}>}`,relevantSkills:[`present`]},{type:`status-board`,category:`interactive`,description:`Status categories containing labeled status items.`,valueShape:`Array<{category, items}> | {items: Array<{category, items}>}`,relevantSkills:[`present`]},{type:`prompt`,category:`interactive`,description:`Prompt payload rendered through the prompt display helper.`,valueShape:`unknown`,relevantSkills:[`present`]},{type:`progress`,category:`interactive`,description:`Progress bar with current value and optional maximum.`,valueShape:`{label, value, max?} | {items: Array<{label, value, max?, color?}>}`,relevantSkills:[`present`]},{type:`docs-browser`,category:`interactive`,description:`Documentation file list with inline content previews for chat-safe rendering.`,valueShape:`{ files: Array<{ path: string; title?: string; content?: string; status?: "current" | "stale" | "missing" }>; title?: string }`,relevantSkills:[`present`,`docs`],usageExample:`{
|
|
273
|
+
`)}]}}}}catch(e){return qp.error(`Checkpoint failed`,R(e)),Y(`INTERNAL`,`Checkpoint failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Zp(e){let t=K(`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:B.enum([`create`,`list`,`status`,`diff`,`merge`,`discard`,`lease`,`unlease`,`leases`]).describe(`Lane action to perform`),name:B.string().optional().describe(`Lane name (required for create/status/diff/merge/discard)`),files:B.array(B.string()).optional().describe(`File paths to copy into the lane (required for create)`),agent:B.string().optional().describe(`Agent identifier (required for lease)`),intent:B.string().optional().describe(`What the agent plans to do (required for lease)`),id:B.string().optional().describe(`Lease ID (required for unlease)`),symbols:B.array(B.string()).optional().describe(`Symbol names within files (optional for lease)`),ttl_minutes:B.number().optional().describe(`Lease TTL in minutes (default 10, optional for lease)`)},annotations:t.annotations},X(`lane`,async({action:e,name:t,files:n,agent:r,intent:i,id:a,symbols:o,ttl_minutes:s})=>{try{switch(e){case`create`:{if(!t)throw Error(`name is required for create`);if(!n||n.length===0)throw Error(`files are required for create`);let e=Tt(t,n);return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`list`:return{content:[{type:`text`,text:JSON.stringify(Ot())}]};case`status`:if(!t)throw Error(`name is required for status`);return{content:[{type:`text`,text:JSON.stringify(At(t))}]};case`diff`:if(!t)throw Error(`name is required for diff`);return{content:[{type:`text`,text:JSON.stringify(Et(t))}]};case`merge`:if(!t)throw Error(`name is required for merge`);return{content:[{type:`text`,text:JSON.stringify(kt(t))}]};case`discard`:if(!t)throw Error(`name is required for discard`);return{content:[{type:`text`,text:JSON.stringify({discarded:Dt(t)})}]};case`lease`:{if(!r)throw Error(`agent is required for lease`);if(!n||n.length===0)throw Error(`files are required for lease`);if(!i)throw Error(`intent is required for lease`);let e=Le({agent:r,files:n,intent:i,symbols:o,ttl_minutes:s});return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`unlease`:{if(!a)throw Error(`id is required for unlease`);let e=$t({id:a});return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`leases`:{let e=jt({agent:r});return{content:[{type:`text`,text:JSON.stringify(e)}]}}}}catch(e){return qp.error(`Lane action failed`,R(e)),Y(`INTERNAL`,`Lane action failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Qp(e){let t=K(`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:B.enum([`create`,`push`,`next`,`done`,`fail`,`get`,`list`,`clear`,`delete`,`dag`]).describe(`Queue action`),name:B.string().optional().describe(`Queue name (required for most actions)`),title:B.string().optional().describe(`Item title (required for push)`),id:B.string().optional().describe(`Item ID (required for done/fail)`),data:B.unknown().optional().describe(`Arbitrary data to attach to a queue item`),error:B.string().optional().describe(`Error message (required for fail)`),dependsOn:B.array(B.string()).optional().describe(`Item IDs this task depends on. Dependent items start as blocked until deps complete.`)},annotations:t.annotations},X(`queue`,async({action:e,name:t,title:n,id:r,data:i,error:a,dependsOn:o})=>{try{switch(e){case`create`:if(!t)throw Error(`name is required for create`);return{content:[{type:`text`,text:JSON.stringify(Ut(t))}]};case`push`:if(!t)throw Error(`name is required for push`);if(!n)throw Error(`title is required for push`);return{content:[{type:`text`,text:JSON.stringify(Zt(t,n,i,void 0,o))}]};case`next`:{if(!t)throw Error(`name is required for next`);let e=Xt(t);return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`done`:if(!t)throw Error(`name is required for done`);if(!r)throw Error(`id is required for done`);return{content:[{type:`text`,text:JSON.stringify(Kt(t,r))}]};case`fail`:if(!t)throw Error(`name is required for fail`);if(!r)throw Error(`id is required for fail`);if(!a)throw Error(`error is required for fail`);return{content:[{type:`text`,text:JSON.stringify(qt(t,r,a))}]};case`get`:if(!t)throw Error(`name is required for get`);return{content:[{type:`text`,text:JSON.stringify(Jt(t))}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(Yt())}]};case`clear`:if(!t)throw Error(`name is required for clear`);return{content:[{type:`text`,text:JSON.stringify({cleared:Ht(t)})}]};case`delete`:if(!t)throw Error(`name is required for delete`);return{content:[{type:`text`,text:JSON.stringify({deleted:Gt(t)})}]};case`dag`:if(!t)throw Error(`name is required for dag`);return{content:[{type:`text`,text:JSON.stringify(Wt(t))}]}}}catch(e){return qp.error(`Queue action failed`,R(e)),Y(`INTERNAL`,`Queue action failed: ${e instanceof Error?e.message:String(e)}`)}}))}function $p(e){let t=[e.id,`Label: ${e.label}`,`Created: ${e.createdAt}`];return e.notes&&t.push(`Notes: ${e.notes}`),t.push(``,`Data:`,JSON.stringify(e.data)),t.join(`
|
|
274
|
+
`)}function em(e){let t=e.trim();if(!t)return``;try{return JSON.parse(t)}catch{return e}}function tm(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 nm=L(`tools`);function rm(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(`
|
|
275
|
+
`)}function im(e,t){let n=K(`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:B.enum([`list`,`get`,`update`,`create`,`delete`]).describe(`Action to perform on classification rules`),rule_id:B.string().optional().describe(`Rule ID (required for get, update, delete)`),changes:B.object({patterns:B.array(B.string()).optional(),category:B.string().optional(),pushWeight:B.number().min(0).max(1).optional(),description:B.string().optional(),examples:B.array(B.string()).optional(),enabled:B.boolean().optional()}).optional().describe(`Changes to apply (for update action)`),new_rule:B.object({id:B.string().regex(/^[a-z][a-z0-9-]*$/),patterns:B.array(B.string()).min(1),category:B.string(),pushWeight:B.number().min(0).max(1),description:B.string(),examples:B.array(B.string()).default([]),enabled:B.boolean().default(!0)}).optional().describe(`New rule definition (for create action)`)},annotations:n.annotations},X(`er_update_policy`,async({action:e,rule_id:n,changes:r,new_rule:i})=>{try{if(e===`list`){let e=t.getRules();return{content:[{type:`text`,text:`## Classification Rules\n\n${e.map(e=>`- **${e.id}** (${e.enabled?`enabled`:`disabled`}) — ${e.description}\n Category: ${e.category} | Weight: ${e.pushWeight} | Patterns: ${e.patterns.join(`, `)}`).join(`
|
|
276
|
+
`)}\n\n---\n_${e.length} rules total. Use \`action: "update"\` to modify a rule._`}]}}if(e===`get`){if(!n)return Y(`VALIDATION`,'`rule_id` is required for "get" action.');let e=t.getRule(n);return e?{content:[{type:`text`,text:rm(e)}]}:Y(`NOT_FOUND`,`Rule "${n}" not found.`)}if(e===`update`){if(!n||!r)return Y(`VALIDATION`,'`rule_id` and `changes` are required for "update" action.');let e=t.updateRule(n,r);return e?{content:[{type:`text`,text:`${rm(e)}\n\n---\n_Updated. Next: Use \`action: "list"\` to verify._`}]}:Y(`NOT_FOUND`,`Rule "${n}" not found.`)}return e===`create`?i?{content:[{type:`text`,text:`${rm(t.addRule(i))}\n\n---\n_Created. Next: Test classification with \`remember\`._`}]}:Y(`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._`}]}:Y(`NOT_FOUND`,`Rule "${n}" not found.`):Y(`VALIDATION`,'`rule_id` is required for "delete" action.'):Y(`VALIDATION`,`Unknown action: ${e}`)}catch(e){return nm.error(`Policy update failed`,R(e)),Y(`INTERNAL`,`Policy update failed: ${e instanceof Error?e.message:String(e)}`)}}))}const am=new Map;function om(e){return e.replace(/[|\\{}()[\]^$+*?.]/g,`\\$&`)}function sm(e){let t=`(?=[^>]*\\bid=['"]${om(e)}['"])`;return RegExp(`(<script\\b(?=[^>]*\\btype=['"]application\\/json['"])${t}[^>]*>)[\\s\\S]*?(<\/script>)`,`i`)}function cm(e){am.has(e.id)&&console.warn(`[viewer-registry] Overwriting viewer template "${e.id}"`),am.set(e.id,e)}function lm(e){return am.get(e)}function um(e){return typeof e==`string`&&am.has(e)}function dm(){return[...am.values()]}function fm(e,t,n,r){let i=sm(n);if(!i.test(e))throw Error(`No <script type="application/json" id="${n}"> found in template`);let a=r?r(t):t,o=JSON.stringify(a??null).replace(/<\/script/gi,`<\\/script`).replace(/<script/gi,`\\u003Cscript`).replace(/-->/g,`--\\u003E`).replace(/<!--/g,`\\u003C!--`);return e.replace(i,`$1\n${o}\n$2`)}const pm=import.meta.dirname??ge(be(import.meta.url)),mm={type:`object`,properties:{title:{type:`string`},description:{type:`string`},layout:{type:`object`,properties:{direction:{type:`string`},spacing:{type:`number`},layerSpacing:{type:`number`}}},nodes:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},type:{type:`string`,enum:[`person`,`system`,`container`,`component`,`database`,`queue`,`external`,`boundary`]},label:{type:`string`},technology:{type:`string`},icon:{type:`string`},description:{type:`string`}},required:[`id`,`type`,`label`]}},edges:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`},label:{type:`string`},style:{type:`string`,enum:[`sync`,`async`,`dashed`,`dotted`,`solid`]}},required:[`source`,`target`]},default:[]}},required:[`nodes`]},hm={type:`object`,properties:{nodes:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},label:{type:`string`},type:{type:`string`,enum:[`start-end`,`manual`,`automated`,`integration`,`decision`,`prerequisite`]},description:{type:`string`}},required:[`id`,`label`]}},edges:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`},label:{type:`string`},type:{type:`string`,enum:[`standard`,`loop-back`,`exception`]}},required:[`source`,`target`]}}},required:[`nodes`]},gm={type:`object`,properties:{title:{type:`string`},description:{type:`string`},phases:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},label:{type:`string`},outcome:{type:`string`},batches:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},order:{type:`number`},parallel:{type:`boolean`},label:{type:`string`},tasks:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},title:{type:`string`},agent:{type:`string`},files:{type:`array`,items:{type:`string`},default:[]},status:{type:`string`,enum:[`pending`,`in-progress`,`done`,`blocked`]},dependsOn:{type:`array`,items:{type:`string`},default:[]}},required:[`id`,`title`]},default:[]}},required:[`id`,`tasks`]},default:[]}},required:[`id`,`label`,`batches`]}}},required:[`phases`]};function _m(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function vm(e,t){return _m(t)?{...t,kind:e}:{kind:e}}function ym(e){let t=e===`canvas.html`?[F(pm,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`),F(pm,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`)]:[],n=C(`server`,[F(`viewers`,`dist`,e),F(`viewers`,e)]),r=[...t,...n?[n]:[],F(pm,`..`,`..`,`..`,`viewers`,e),F(pm,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`static`,e),F(pm,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),F(pm,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,e),F(pm,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),F(pm,`..`,`..`,`scaffold`,`general`,`viewers`,e),F(pm,`..`,`viewers`,`dist`,e),F(pm,`..`,`viewers`,e)];for(let e of r)try{return P(e,`utf8`)}catch{}throw Error(`Viewer HTML not found: ${e}. Searched: ${r.join(`, `)}`)}let bm,xm,Sm,Cm,wm,Tm;function Em(){return bm??=ym(`c4-viewer.html`),bm}function Dm(){return xm??=ym(`tour-viewer.html`),xm}function Om(){return Sm??=ym(`canvas.html`),Sm}function km(){return Cm??=ym(`architecture-static.html`),Cm}function Am(){return wm??=ym(`process-flow-static.html`),wm}function jm(){return Tm??=ym(`task-plan-static.html`),Tm}function Mm(){cm({id:`c4@1`,label:`C4 Architecture Diagram`,description:`Interactive C4 architecture diagram with zoom, pan, and ELK auto-layout`,inputSchema:mm,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Em}),cm({id:`c4-static@1`,label:`C4 Architecture Diagram (Static)`,description:`Static SVG architecture diagram for inline rendering`,inputSchema:mm,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:km}),cm({id:`tour@1`,label:`Code Tour Viewer`,description:`Interactive code tour with step navigation and dependency graph`,inputSchema:{type:`object`,properties:{title:{type:`string`},description:{type:`string`},estimatedTime:{type:`string`},steps:{type:`array`,items:{type:`object`,properties:{stepNumber:{type:`number`},id:{type:`string`},title:{type:`string`},file:{type:`string`},explanation:{type:`string`},description:{type:`string`},learnsConcept:{type:`string`},duration:{type:`string`},line:{type:`number`},code:{type:`string`}},required:[`id`,`title`]}},dependencies:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`}},required:[`source`,`target`]},default:[]}},required:[`steps`]},injectId:`tour-data`,supportedTransports:[`browser`],resolveHtml:Dm}),cm({id:`process-flow-static@1`,label:`Process Flow Diagram (Static)`,description:`Static SVG process flow diagram for inline rendering`,inputSchema:hm,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:Am}),cm({id:`task-plan-static@1`,label:`Task Execution Plan (Static)`,description:`Static SVG task execution plan for inline rendering`,inputSchema:gm,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:jm}),cm({id:`task-plan@1`,label:`Task Execution Plan (Interactive)`,description:`Interactive task execution plan with ReactFlow, phase grouping, and dependency edges`,inputSchema:gm,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Om,transformData:e=>vm(`task-plan`,e)}),cm({id:`process-flow@1`,label:`Process Flow Diagram (Interactive)`,description:`Interactive process flow diagram with ReactFlow`,inputSchema:hm,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Om,transformData:e=>vm(`process-flow`,e)})}function Nm(){let e=new wr;for(let t of Dr.list())e.register(t);return e.register(Er),e.register(jr),e.register(Mr),e.register(Or),e}function Pm(e,t){return e?.supportedTransports.includes(t)??!1}const Fm=Nm();function Im(e){if(e.template)return Fm.get(e.template)}function Lm(e){if((e.actions?.length??0)>0)return!0;if(e.template&&um(e.template)){let t=lm(e.template);return t?.supportedTransports.includes(`browser`)===!0&&!t.supportedTransports.includes(`mcp-app`)}let t=Im(e);return Pm(t,`browser`)&&!Pm(t,`mcp-app`)}Mm();const Rm=new Map([{type:`markdown`,category:`content`,description:`Markdown content rendered with the marked parser.`,valueShape:`string`,relevantSkills:[`present`,`docs`]},{type:`code`,category:`content`,description:`Formatted code block rendered inside pre/code tags.`,valueShape:`string`,relevantSkills:[`present`,`docs`]},{type:`mermaid`,category:`visualization`,description:`Mermaid diagram source rendered in a mermaid pre block.`,valueShape:`string`,vendorScripts:[`mermaid`],relevantSkills:[`present`,`c4-architecture`,`docs`]},{type:`table`,category:`data`,description:`Tabular data rendered from records or explicit headers and rows.`,valueShape:`Record<string, unknown>[] | { headers: string[]; rows: unknown[][] }`,relevantSkills:[`present`,`docs`]},{type:`metrics`,category:`data`,description:`Metric cards showing label/value pairs with optional trend and status.`,valueShape:`Array<{ label: string; value: string | number; trend?: string | number; status?: string }>`,relevantSkills:[`present`]},{type:`cards`,category:`visualization`,description:`Card grid for titled items with optional body, badge, and status.`,valueShape:`Array<{ title: string; body?: string; badge?: string; status?: string; description?: string }>`,relevantSkills:[`present`,`docs`]},{type:`tree`,category:`visualization`,description:`Hierarchical object or name/children tree rendered recursively.`,valueShape:`{ name: string; children?: unknown[] } | Record<string, unknown>`,relevantSkills:[`present`]},{type:`graph`,category:`visualization`,description:`Node and edge graph rendered as a Mermaid flow graph in HTML mode.`,valueShape:`{ nodes: Array<{ id: string; label?: string }>; edges: Array<{ from: string; to: string; label?: string }> }`,vendorScripts:[`mermaid`],relevantSkills:[`present`,`c4-architecture`]},{type:`chart`,category:`data`,description:`Structured chart definition rendered as SVG.`,valueShape:`{ chartType: string; data: Record<string, unknown>[]; xKey: string; yKeys: string[] }`,relevantSkills:[`present`]},{type:`timeline`,category:`interactive`,description:`Timeline entries rendered as a vertical sequence of events.`,valueShape:`Array<{ title: string; description?: string; timestamp?: string; status?: string }>`,relevantSkills:[`present`]},{type:`checklist`,category:`interactive`,description:`Checklist items with boolean checked state.`,valueShape:`Array<{label, checked}> | {items: Array<{label, checked}>}`,relevantSkills:[`present`]},{type:`comparison`,category:`interactive`,description:`Side-by-side comparison columns with titled item lists.`,valueShape:`Array<{title, items}> | {columns: Array<{title, items}>}`,relevantSkills:[`present`]},{type:`status-board`,category:`interactive`,description:`Status categories containing labeled status items.`,valueShape:`Array<{category, items}> | {items: Array<{category, items}>}`,relevantSkills:[`present`]},{type:`prompt`,category:`interactive`,description:`Prompt payload rendered through the prompt display helper.`,valueShape:`unknown`,relevantSkills:[`present`]},{type:`progress`,category:`interactive`,description:`Progress bar with current value and optional maximum.`,valueShape:`{label, value, max?} | {items: Array<{label, value, max?, color?}>}`,relevantSkills:[`present`]},{type:`docs-browser`,category:`interactive`,description:`Documentation file list with inline content previews for chat-safe rendering.`,valueShape:`{ files: Array<{ path: string; title?: string; content?: string; status?: "current" | "stale" | "missing" }>; title?: string }`,relevantSkills:[`present`,`docs`],usageExample:`{
|
|
277
277
|
type: 'docs-browser',
|
|
278
278
|
value: {
|
|
279
279
|
title: 'Project Docs',
|
|
@@ -282,7 +282,7 @@ None.`:`### Stale Lessons\n${u.map(e=>`- **${e.title}** (\`${e.path}\`) — effe
|
|
|
282
282
|
{ path: 'docs/api.md', title: 'API Reference', status: 'stale' },
|
|
283
283
|
],
|
|
284
284
|
},
|
|
285
|
-
}`},{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 am(){let e={};for(let[t,n]of im)n.vendorScripts?.length&&(e[t]=n.vendorScripts);return e}const om=1024,sm=new Set([`user-closed`,`host-dismissed`,`replaced`]);function cm(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function lm(e,t,n){let r={code:e,message:t};return n!==void 0&&(r.details=n),{kind:`error`,error:r}}function um(e,t,n,r){e.writeHead(t,{"Content-Type":`application/json`,"Access-Control-Allow-Origin":r??`null`}),e.end(JSON.stringify(n))}async function dm(e){return await new Promise((t,n)=>{let r=[],i=0;e.on(`data`,t=>{if(i+=t.length,i>65536){n(Error(`Callback payload exceeds 64KB limit`)),e.destroy();return}r.push(t)}),e.on(`end`,()=>t(Buffer.concat(r).toString(`utf8`))),e.on(`error`,n)})}function fm(e,t){if(typeof e!=`string`||e.length!==t.length)return!1;let n=Buffer.from(e,`utf8`),r=Buffer.from(t,`utf8`);return n.length===r.length?j(n,r):!1}function pm(e,t){let n=e.headers.origin;if(n!=null)return n===t;let r=e.headers.referer;return r==null?!1:r.startsWith(t)}function mm(e){return(e.headers[`content-type`]??``).startsWith(`application/json`)}function hm(e){for(let[t,n]of Object.entries(e)){let e=typeof n==`string`?n:JSON.stringify(n);if(Buffer.byteLength(e,`utf8`)>8192)return`Form field "${t}" exceeds 8KB limit`}return null}function gm(e){return Array.isArray(e)&&e.length>om?`Selection exceeds ${om} items (got ${e.length})`:null}function _m(e,t,n){let r=typeof e.actionId==`string`?e.actionId:``,i=n.find(e=>e.id===r);if(!i)return lm(`INVALID_ACTION`,`Unknown actionId: ${r||`(missing)`}`);let a=typeof e.selection==`string`||Array.isArray(e.selection)?e.selection:void 0,o=cm(e.formData)?e.formData:void 0,s={surfaceId:t,actionId:i.id,actionType:i.type,timestamp:typeof e.timestamp==`string`?e.timestamp:new Date().toISOString(),sourceTransport:`browser`};return e.value!==void 0&&(s.value=e.value),a!==void 0&&(s.selection=a),o!==void 0&&(s.formData=o),typeof e.label==`string`?s.label=e.label:i.label&&(s.label=i.label),{kind:`result`,result:s}}function vm(e,t){let n=se(16).toString(`hex`),r=!1,i=!1,a,o,s=new Promise(e=>{o=e}),c=e=>r?a??e:(r=!0,a=e,o?.(e),e);return{nonce:n,promise:s,settleTimeout(e){return c({kind:`timeout`,waitedMs:e})},settleCancelled(e){return c({kind:`cancelled`,reason:e})},settleError(e,t,n){return c(lm(e,t,n))},async handle(r,a,o){if(!mm(r)){let e=c(lm(`INVALID_CONTENT_TYPE`,`Content-Type must be application/json`));return um(a,415,{ok:!1,error:`unsupported-media-type`},o),e}if(!pm(r,o)){let e=c(lm(`INVALID_ORIGIN`,`Unexpected callback origin: ${r.headers.origin??r.headers.referer??`(missing)`}`));return um(a,403,{ok:!1,error:`invalid-origin`},o),e}let s=``;try{s=await dm(r)}catch(e){let t=c(lm(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Unable to read callback payload`));return um(a,413,{ok:!1,error:`payload-too-large`},o),t}let l;try{let e=JSON.parse(s);if(!cm(e))throw Error(`Callback payload must be an object`);l=e}catch(e){let t=c(lm(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Malformed callback payload`));return um(a,400,{ok:!1,error:`invalid-json`},o),t}if(i){let e=lm(`NONCE_CONSUMED`,`Nonce has already been used`);return um(a,403,{ok:!1,error:`nonce-consumed`},o),e}if(!fm(typeof l.nonce==`string`?l.nonce:``,n)){let e=c(lm(`INVALID_NONCE`,`Callback nonce did not match`));return um(a,403,{ok:!1,error:`invalid-nonce`},o),e}i=!0;let u=gm(l.selection);if(u){let e=c(lm(`SELECTION_TOO_LARGE`,u));return um(a,413,{ok:!1,error:`selection-too-large`},o),e}if(cm(l.formData)){let e=hm(l.formData);if(e){let t=c(lm(`PAYLOAD_FIELD_TOO_LARGE`,e));return um(a,413,{ok:!1,error:`field-too-large`},o),t}}if(l.kind===`cancelled`){let e=typeof l.reason==`string`?l.reason:``;if(!sm.has(e)){let t=c(lm(`INVALID_CANCEL_REASON`,`Unsupported cancel reason: ${e||`(missing)`}`));return um(a,400,{ok:!1,error:`invalid-cancel-reason`},o),t}let t=c({kind:`cancelled`,reason:e});return um(a,200,{ok:!0,kind:`cancelled`},o),t}let d=c(_m(l,e,t));return um(a,d.kind===`error`?400:200,{ok:d.kind!==`error`,kind:d.kind},o),d}}}const ym=`Install AI Kit with <code>${X(`npx -y @vpxa/aikit@latest init --user`)}</code>.`,bm=new Map;function xm(e){return e.replace(/[|\\{}()[\]^$+*?.]/g,`\\$&`)}function Sm(e){let t=`(?=[^>]*\\bid=['"]${xm(e)}['"])`;return RegExp(`(<script\\b(?=[^>]*\\btype=['"]application\\/json['"])${t}[^>]*>)[\\s\\S]*?(<\/script>)`,`i`)}function Cm(e){bm.has(e.id)&&console.warn(`[viewer-registry] Overwriting viewer template "${e.id}"`),bm.set(e.id,e)}function wm(e){return bm.get(e)}function Tm(e){return typeof e==`string`&&bm.has(e)}function Em(){return[...bm.values()]}function Dm(e,t,n,r){let i=Sm(n);if(!i.test(e))throw Error(`No <script type="application/json" id="${n}"> found in template`);let a=r?r(t):t,o=JSON.stringify(a??null).replace(/<\/script/gi,`<\\/script`).replace(/<script/gi,`\\u003Cscript`).replace(/-->/g,`--\\u003E`).replace(/<!--/g,`\\u003C!--`);return e.replace(i,`$1\n${o}\n$2`)}const Om=import.meta.dirname??ge(be(import.meta.url)),km={type:`object`,properties:{title:{type:`string`},description:{type:`string`},layout:{type:`object`,properties:{direction:{type:`string`},spacing:{type:`number`},layerSpacing:{type:`number`}}},nodes:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},type:{type:`string`,enum:[`person`,`system`,`container`,`component`,`database`,`queue`,`external`,`boundary`]},label:{type:`string`},technology:{type:`string`},icon:{type:`string`},description:{type:`string`}},required:[`id`,`type`,`label`]}},edges:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`},label:{type:`string`},style:{type:`string`,enum:[`sync`,`async`,`dashed`,`dotted`,`solid`]}},required:[`source`,`target`]},default:[]}},required:[`nodes`]},Am={type:`object`,properties:{nodes:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},label:{type:`string`},type:{type:`string`,enum:[`start-end`,`manual`,`automated`,`integration`,`decision`,`prerequisite`]},description:{type:`string`}},required:[`id`,`label`]}},edges:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`},label:{type:`string`},type:{type:`string`,enum:[`standard`,`loop-back`,`exception`]}},required:[`source`,`target`]}}},required:[`nodes`]},jm={type:`object`,properties:{title:{type:`string`},description:{type:`string`},phases:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},label:{type:`string`},outcome:{type:`string`},batches:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},order:{type:`number`},parallel:{type:`boolean`},label:{type:`string`},tasks:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},title:{type:`string`},agent:{type:`string`},files:{type:`array`,items:{type:`string`},default:[]},status:{type:`string`,enum:[`pending`,`in-progress`,`done`,`blocked`]},dependsOn:{type:`array`,items:{type:`string`},default:[]}},required:[`id`,`title`]},default:[]}},required:[`id`,`tasks`]},default:[]}},required:[`id`,`label`,`batches`]}}},required:[`phases`]};function Mm(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Nm(e,t){return Mm(t)?{...t,kind:e}:{kind:e}}function Pm(e){let t=e===`canvas.html`?[F(Om,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`),F(Om,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`)]:[],n=C(`server`,[F(`viewers`,`dist`,e),F(`viewers`,e)]),r=[...t,...n?[n]:[],F(Om,`..`,`..`,`..`,`viewers`,e),F(Om,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`static`,e),F(Om,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),F(Om,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,e),F(Om,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),F(Om,`..`,`..`,`scaffold`,`general`,`viewers`,e),F(Om,`..`,`viewers`,`dist`,e),F(Om,`..`,`viewers`,e)];for(let e of r)try{return P(e,`utf8`)}catch{}throw Error(`Viewer HTML not found: ${e}. Searched: ${r.join(`, `)}`)}let Fm,Im,Lm,Rm,zm,Bm;function Vm(){return Fm??=Pm(`c4-viewer.html`),Fm}function Hm(){return Im??=Pm(`tour-viewer.html`),Im}function Um(){return Lm??=Pm(`canvas.html`),Lm}function Wm(){return Rm??=Pm(`architecture-static.html`),Rm}function Gm(){return zm??=Pm(`process-flow-static.html`),zm}function Km(){return Bm??=Pm(`task-plan-static.html`),Bm}function qm(){Cm({id:`c4@1`,label:`C4 Architecture Diagram`,description:`Interactive C4 architecture diagram with zoom, pan, and ELK auto-layout`,inputSchema:km,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Vm}),Cm({id:`c4-static@1`,label:`C4 Architecture Diagram (Static)`,description:`Static SVG architecture diagram for inline rendering`,inputSchema:km,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:Wm}),Cm({id:`tour@1`,label:`Code Tour Viewer`,description:`Interactive code tour with step navigation and dependency graph`,inputSchema:{type:`object`,properties:{title:{type:`string`},description:{type:`string`},estimatedTime:{type:`string`},steps:{type:`array`,items:{type:`object`,properties:{stepNumber:{type:`number`},id:{type:`string`},title:{type:`string`},file:{type:`string`},explanation:{type:`string`},description:{type:`string`},learnsConcept:{type:`string`},duration:{type:`string`},line:{type:`number`},code:{type:`string`}},required:[`id`,`title`]}},dependencies:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`}},required:[`source`,`target`]},default:[]}},required:[`steps`]},injectId:`tour-data`,supportedTransports:[`browser`],resolveHtml:Hm}),Cm({id:`process-flow-static@1`,label:`Process Flow Diagram (Static)`,description:`Static SVG process flow diagram for inline rendering`,inputSchema:Am,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:Gm}),Cm({id:`task-plan-static@1`,label:`Task Execution Plan (Static)`,description:`Static SVG task execution plan for inline rendering`,inputSchema:jm,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:Km}),Cm({id:`task-plan@1`,label:`Task Execution Plan (Interactive)`,description:`Interactive task execution plan with ReactFlow, phase grouping, and dependency edges`,inputSchema:jm,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Um,transformData:e=>Nm(`task-plan`,e)}),Cm({id:`process-flow@1`,label:`Process Flow Diagram (Interactive)`,description:`Interactive process flow diagram with ReactFlow`,inputSchema:Am,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Um,transformData:e=>Nm(`process-flow`,e)})}function Jm(){let e=new Tr;for(let t of Or.list())e.register(t);return e.register(Dr),e.register(Mr),e.register(Nr),e.register(kr),e}function Ym(e,t){return e?.supportedTransports.includes(t)??!1}const Xm=Jm();function Zm(e){if(e.template)return Xm.get(e.template)}function Qm(e){if((e.actions?.length??0)>0)return!0;if(e.template&&Tm(e.template)){let t=wm(e.template);return t?.supportedTransports.includes(`browser`)===!0&&!t.supportedTransports.includes(`mcp-app`)}let t=Zm(e);return Ym(t,`browser`)&&!Ym(t,`mcp-app`)}qm();const $m=String.raw`(function(){
|
|
285
|
+
}`},{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 zm(){let e={};for(let[t,n]of Rm)n.vendorScripts?.length&&(e[t]=n.vendorScripts);return e}const Q={TIMEOUT:`timeout`,DUPLICATE_CALLBACK:`duplicate_callback`,INVALID_NONCE:`invalid_nonce`,INVALID_ORIGIN:`invalid_origin`,SESSION_NOT_FOUND:`session_not_found`,SESSION_LIMIT_REACHED:`session_limit_reached`,ASSET_NOT_FOUND:`asset_not_found`,ASSET_FORBIDDEN:`asset_forbidden`,RATE_LIMITED:`rate_limited`,PAYLOAD_TOO_LARGE:`payload_too_large`,UNSUPPORTED_MEDIA_TYPE:`unsupported_media_type`,INVALID_TRANSITION:`invalid_transition`,ANNOTATION_CAP_EXCEEDED:`annotation_cap_exceeded`},Bm={[Q.TIMEOUT]:408,[Q.DUPLICATE_CALLBACK]:409,[Q.INVALID_NONCE]:400,[Q.INVALID_ORIGIN]:403,[Q.SESSION_NOT_FOUND]:404,[Q.SESSION_LIMIT_REACHED]:429,[Q.ASSET_NOT_FOUND]:404,[Q.ASSET_FORBIDDEN]:403,[Q.RATE_LIMITED]:429,[Q.PAYLOAD_TOO_LARGE]:413,[Q.UNSUPPORTED_MEDIA_TYPE]:415,[Q.INVALID_TRANSITION]:400,[Q.ANNOTATION_CAP_EXCEEDED]:403};function Vm(e,t,n){return{code:e,message:t,httpStatus:n??Bm[e]}}const Hm={created:[`rendering`,`errored`,`cleaned_up`,`timed_out`,`cancelled`,`responded`],rendering:[`listening`,`errored`,`cleaned_up`,`timed_out`,`cancelled`],listening:[`connected`,`timed_out`,`cancelled`,`errored`,`cleaned_up`],connected:[`responded`,`timed_out`,`cancelled`,`errored`,`cleaned_up`],responded:[`cleaned_up`],timed_out:[`cleaned_up`],cancelled:[`cleaned_up`],errored:[`cleaned_up`],cleaned_up:[]};function Um(e,t,n,r){return Hm[e].includes(t)?{ok:!0,to:t,entry:{from:e,to:t,timestamp:Date.now(),trigger:r}}:{ok:!1,error:{code:`invalid_transition`,message:`Cannot transition from "${e}" to "${t}"`,from:e,to:t}}}function Wm(e){return Hm[e].length===0}const Gm=1024,Km=new Set([`user-closed`,`host-dismissed`,`replaced`]);function qm(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Jm(e,t,n){let r={code:e,message:t};return n!==void 0&&(r.details=n),{kind:`error`,error:r}}function Ym(e,t,n,r){e.writeHead(t,{"Content-Type":`application/json`,"Access-Control-Allow-Origin":r??`null`}),e.end(JSON.stringify(n))}async function Xm(e){return await new Promise((t,n)=>{let r=[],i=0;e.on(`data`,t=>{if(i+=t.length,i>65536){n(Error(`Callback payload exceeds 64KB limit`)),e.destroy();return}r.push(t)}),e.on(`end`,()=>t(Buffer.concat(r).toString(`utf8`))),e.on(`error`,n)})}function Zm(e,t){if(typeof e!=`string`||e.length!==t.length)return!1;let n=Buffer.from(e,`hex`),r=Buffer.from(t,`hex`);return n.length===r.length?j(n,r):!1}function Qm(e,t){let n=e.headers.origin;if(n!=null)return n===t;let r=e.headers.referer;return r==null?!1:r.startsWith(t)}function $m(e){return(e.headers[`content-type`]??``).startsWith(`application/json`)}function eh(e){for(let[t,n]of Object.entries(e)){let e=typeof n==`string`?n:JSON.stringify(n);if(Buffer.byteLength(e,`utf8`)>8192)return`Form field "${t}" exceeds 8KB limit`}return null}function th(e){return Array.isArray(e)&&e.length>Gm?`Selection exceeds ${Gm} items (got ${e.length})`:null}function nh(e,t,n){let r=typeof e.actionId==`string`?e.actionId:``,i=n.find(e=>e.id===r);if(!i)return Jm(`INVALID_ACTION`,`Unknown actionId: ${r||`(missing)`}`);let a=typeof e.selection==`string`||Array.isArray(e.selection)?e.selection:void 0,o=qm(e.formData)?e.formData:void 0,s={surfaceId:t,actionId:i.id,actionType:i.type,timestamp:typeof e.timestamp==`string`?e.timestamp:new Date().toISOString(),sourceTransport:`browser`};return e.value!==void 0&&(s.value=e.value),a!==void 0&&(s.selection=a),o!==void 0&&(s.formData=o),typeof e.label==`string`?s.label=e.label:i.label&&(s.label=i.label),{kind:`result`,result:s}}function rh(e){switch(e.kind){case`timeout`:return`timed_out`;case`cancelled`:return`cancelled`;case`error`:return`errored`;case`result`:return`responded`;default:return`errored`}}function ih(e,t,n,r,i){let a=i??se(16).toString(`hex`),o=`created`,s=[],c=!1,l,u,d=new Promise(e=>{u=e}),f=e=>{if(Wm(o))return l;let t=rh(e),i=Um(o,t,s,`resolve`);return i.ok?(o=t,s.push(i.entry),l=e,u?.(e),n&&r&&n.transitionSession(r,t,`resolve`),e):l};return{nonce:a,promise:d,get state(){return o},get stateHistory(){return s},settleTimeout(e){return f({kind:`timeout`,waitedMs:e})},settleCancelled(e){return f({kind:`cancelled`,reason:e})},settleError(e,t,n){return f(Jm(e,t,n))},async handle(n,r,i){if(!$m(n)){let e=f(Jm(Q.UNSUPPORTED_MEDIA_TYPE,`Content-Type must be application/json`));return Ym(r,415,{ok:!1,error:Q.UNSUPPORTED_MEDIA_TYPE},i),e}if(!Qm(n,i)){let e=n.headers.origin??n.headers.referer??`(missing)`,t=f(Jm(Q.INVALID_ORIGIN,`Unexpected callback origin: ${e}`));return Ym(r,403,{ok:!1,error:Q.INVALID_ORIGIN},i),t}let o=``;try{o=await Xm(n)}catch(e){let t=f(Jm(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Unable to read callback payload`));return Ym(r,413,{ok:!1,error:Q.PAYLOAD_TOO_LARGE},i),t}let s;try{let e=JSON.parse(o);if(!qm(e))throw Error(`Callback payload must be an object`);s=e}catch(e){let t=f(Jm(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Malformed callback payload`));return Ym(r,400,{ok:!1,error:`invalid-json`},i),t}if(c){let e=Jm(Q.DUPLICATE_CALLBACK,`Nonce has already been used`);return Ym(r,403,{ok:!1,error:Q.DUPLICATE_CALLBACK},i),e}if(!Zm(typeof s.nonce==`string`?s.nonce:``,a)){let e=f(Jm(Q.INVALID_NONCE,`Callback nonce did not match`));return Ym(r,403,{ok:!1,error:Q.INVALID_NONCE},i),e}c=!0;let l=th(s.selection);if(l){let e=f(Jm(`SELECTION_TOO_LARGE`,l));return Ym(r,413,{ok:!1,error:`selection-too-large`},i),e}if(qm(s.formData)){let e=eh(s.formData);if(e){let t=f(Jm(`PAYLOAD_FIELD_TOO_LARGE`,e));return Ym(r,413,{ok:!1,error:`field-too-large`},i),t}}if(s.kind===`cancelled`){let e=typeof s.reason==`string`?s.reason:``;if(!Km.has(e)){let t=f(Jm(`INVALID_CANCEL_REASON`,`Unsupported cancel reason: ${e||`(missing)`}`));return Ym(r,400,{ok:!1,error:`invalid-cancel-reason`},i),t}let t=f({kind:`cancelled`,reason:e});return Ym(r,200,{ok:!0,kind:`cancelled`},i),t}let u=f(nh(s,e,t));return Ym(r,u.kind===`error`?400:200,{ok:u.kind!==`error`,kind:u.kind},i),u}}}const ah=`Install AI Kit with <code>${Z(`npx -y @vpxa/aikit@latest init --user`)}</code>.`;function oh(e){let t=Date.now();return{id:e.id,state:`created`,nonce:e.nonce,surfaceId:e.surfaceId,transport:e.transport,createdAt:t,updatedAt:t,stateHistory:[],responsePromise:null,resolveOutcome:null,cleanupCallbacks:[],nonceConsumed:!1}}var sh=class{sessions;maxSessions;rejectedCount;constructor(e=16){this.sessions=new Map,this.maxSessions=e,this.rejectedCount=0}createSession(e){if(this.sessions.size>=this.maxSessions)return this.rejectedCount++,{ok:!1,error:Vm(Q.SESSION_LIMIT_REACHED,`Session limit reached`)};let t=ce(),n=oh({id:t,nonce:e.nonce,surfaceId:e.surfaceId,transport:e.transport});return this.sessions.set(t,n),{ok:!0,session:n}}getSession(e){return this.sessions.get(e)||Vm(Q.SESSION_NOT_FOUND,`Session ${e} not found`)}transitionSession(e,t,n){let r=this.sessions.get(e);if(!r)return{ok:!1,error:Vm(Q.SESSION_NOT_FOUND,`Session ${e} not found`)};let i=Um(r.state,t,r.stateHistory,n);return i.ok?(r.state=i.to,r.stateHistory.push(i.entry),r.updatedAt=Date.now(),{ok:!0,record:r}):{ok:!1,error:Vm(Q.INVALID_TRANSITION,i.error.message)}}consumeNonce(e){let t=this.sessions.get(e);return t?t.nonceConsumed?{ok:!1,error:Vm(Q.DUPLICATE_CALLBACK,`Nonce already consumed`)}:(t.nonceConsumed=!0,t.updatedAt=Date.now(),{ok:!0}):{ok:!1,error:Vm(Q.SESSION_NOT_FOUND,`Session ${e} not found`)}}removeSession(e){return this.sessions.delete(e)}cleanupStale(e){let t=Date.now(),n=0;for(let[r,i]of this.sessions.entries())i.state!==`connected`&&t-i.updatedAt>e&&(i.resolveOutcome&&(i.resolveOutcome({outcome:`timeout`}),i.resolveOutcome=null,i.responsePromise=null),this.sessions.delete(r),n++);return n}shutdown(){for(let[,e]of this.sessions.entries()){e.resolveOutcome&&(e.resolveOutcome({outcome:`shutdown`}),e.resolveOutcome=null,e.responsePromise=null);for(let t of e.cleanupCallbacks)try{t()}catch{}e.cleanupCallbacks=[]}this.sessions.clear()}get activeCount(){return this.sessions.size}get rejectedSessionCount(){return this.rejectedCount}setResponseResolver(e,t){let n=this.sessions.get(e);return n?(n.resolveOutcome=t,n.updatedAt=Date.now(),{ok:!0}):{ok:!1,error:Vm(Q.SESSION_NOT_FOUND,`Session ${e} not found`)}}};const ch=String.raw`(function(){
|
|
286
286
|
'use strict';
|
|
287
287
|
|
|
288
288
|
var SVG_NS = 'http://www.w3.org/2000/svg';
|
|
@@ -2658,7 +2658,7 @@ None.`:`### Stale Lessons\n${u.map(e=>`- **${e.title}** (\`${e.path}\`) — effe
|
|
|
2658
2658
|
};
|
|
2659
2659
|
|
|
2660
2660
|
init();
|
|
2661
|
-
})();`;function
|
|
2661
|
+
})();`;function lh(){let e;return()=>{if(e!==void 0)return e;try{e=P(oe(import.meta.url).resolve(`mermaid/dist/mermaid.min.js`),`utf-8`)}catch{e=``}return e}}const uh={id:`mermaid`,cdn:`https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js`,inlineSource:ch,initScript:`window.__aikit_initMermaid = function() {
|
|
2662
2662
|
if (typeof mermaid === 'undefined') return;
|
|
2663
2663
|
if (document.readyState === 'loading') {
|
|
2664
2664
|
document.addEventListener('DOMContentLoaded', window.__aikit_initMermaid);
|
|
@@ -2671,9 +2671,9 @@ None.`:`### Stale Lessons\n${u.map(e=>`- **${e.title}** (\`${e.path}\`) — effe
|
|
|
2671
2671
|
}
|
|
2672
2672
|
mermaid.initialize({ startOnLoad: false, theme: theme });
|
|
2673
2673
|
mermaid.run();
|
|
2674
|
-
};`,onload:`window.__aikit_initMermaid&&window.__aikit_initMermaid()`,local:{route:`/vendor/mermaid.min.js`,getSource:
|
|
2674
|
+
};`,onload:`window.__aikit_initMermaid&&window.__aikit_initMermaid()`,local:{route:`/vendor/mermaid.min.js`,getSource:lh()}},dh=new Map([[`mermaid`,uh]]);function fh(e,t){if(!e?.length)return;let n=[];for(let r of e){let e=dh.get(r);if(e){if(t===`browser`){n.push({inlineSource:e.inlineSource,onload:e.onload});continue}if(t===`mcp-app`){n.push({inlineSource:e.inlineSource,onload:e.onload});continue}n.push({src:e.cdn,initScript:e.initScript,onload:e.onload})}}return n.length>0?n:void 0}function ph(){let e=[];for(let t of dh.values())t.local&&e.push({route:t.local.route,getSource:t.local.getSource,cdn:t.cdn});return e}const mh=300*1e3,hh=15*1e3,gh=`/@aikit/blocks-interactive/dist/`;var _h=class{maxTokens;refillPerSecond;tokens;lastRefill;constructor(e,t){this.maxTokens=e,this.refillPerSecond=t,this.tokens=e,this.lastRefill=Date.now()}tryConsume(){return this.#e(),this.tokens>=1?(--this.tokens,!0):!1}#e(){let e=Date.now(),t=(e-this.lastRefill)/1e3;this.tokens=Math.min(this.maxTokens,this.tokens+t*this.refillPerSecond),this.lastRefill=e}};let vh=null;const yh=new Map,bh=new _h(10,10),xh=new _h(50,50);function Sh(){return vh||(vh={manager:new sh,server:null,port:0},process.on(`exit`,()=>{vh?.manager.shutdown()})),vh.manager}function Ch(){if(!vh)throw Error(`Browser server state not initialized`);let e=vh;if(e.server)return e.port;let t=Pr((e,t)=>{Oh(e,t)});return t.listen(0,`127.0.0.1`,()=>{let n=t.address();typeof n==`object`&&n&&(e.port=n.port)}),e.server=t,e.port}let wh;function Th(){return wh===void 0&&(wh=w(`blocks-interactive`)),wh}function Eh(e){if(!e.startsWith(gh))return null;let t=Th();if(!t)return null;let n=I(F(t,`dist`,e.slice(32))),r=I(F(t,`dist`)),i=process.platform===`win32`?`\\`:`/`;return!n.startsWith(r+i)&&n!==r?null:n}function Dh(e){return`script-src 'nonce-${e}' 'strict-dynamic'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; connect-src 'self'; frame-ancestors 'self'`}function Oh(e,t){let n=vh;if(!n){Ih(t);return}try{let r=new URL(e.url??`/`,`http://${e.headers.host??`127.0.0.1`}`).pathname;if((e.method??`GET`)===`OPTIONS`){t.writeHead(204,{"Access-Control-Allow-Origin":`*`,"Access-Control-Allow-Methods":`POST, GET, OPTIONS`,"Access-Control-Allow-Headers":`Content-Type`}),t.end();return}if(r.startsWith(`/__aikit_screenshot.png`)){Rh(t,`http://127.0.0.1:${n.port}`);return}let i=r.match(/^\/session\/([^/]+)(?:\/(.*))?$/);if(i){let r=i[1],a=i[2]??``,o=yh.get(r);if(!o){kh(t,404,Q.SESSION_NOT_FOUND,`Session ${r} not found`);return}if(o.hasClientConnected=!0,n.manager.transitionSession(r,`connected`,`client-connect`),a===``||a===`/`){t.writeHead(200,{"Content-Type":`text/html; charset=utf-8`,"Content-Security-Policy":Dh(o.callbackSession.nonce)}),t.end(o.html);return}if(a===`viewer`){if(!o.viewerHtml){t.writeHead(404,{"Content-Type":`text/plain`}),t.end(`Not Found`);return}t.writeHead(200,{"Content-Type":`text/html; charset=utf-8`}),t.end(o.viewerHtml);return}if(a===`callback`){if(!bh.tryConsume()){kh(t,429,Q.RATE_LIMITED,`Too many requests`);return}o.callbackSession.handle(e,t,`http://127.0.0.1:${n.port}`).catch(()=>{Ih(t)});return}t.writeHead(404,{"Content-Type":`text/plain`}),t.end(`Not Found`);return}let a=ph().find(t=>e.url===t.route);if(a){let e=a.getSource();if(e){t.writeHead(200,{"Content-Type":`application/javascript; charset=utf-8`,"Cache-Control":`public, max-age=86400`}),t.end(e);return}t.writeHead(302,{Location:a.cdn}),t.end();return}if(r.startsWith(gh)){if(!xh.tryConsume()){kh(t,429,Q.RATE_LIMITED,`Too many requests`);return}let e=Eh(r);if(e)try{let n=P(e,`utf8`);t.writeHead(200,{"Content-Type":`application/javascript; charset=utf-8`}),t.end(n);return}catch{}}t.writeHead(404,{"Content-Type":`text/plain`}),t.end(`Not Found`)}catch{Ih(t)}}function kh(e,t,n,r){if(!e.headersSent)try{e.writeHead(t,{"Content-Type":`application/json; charset=utf-8`}),e.end(JSON.stringify({error:n,message:r}))}catch{try{e.end()}catch{}}}function Ah(e,t){return e.length===0?``:`
|
|
2675
2675
|
<section class="present-surface-actions">
|
|
2676
|
-
<div class="present-action-bar">${e.map(e=>{let t=
|
|
2676
|
+
<div class="present-action-bar">${e.map(e=>{let t=Z(e.id),n=Z(e.label);if(e.type===`select`||e.type===`multi-select`)return`<label class="present-action-field"><span>${n}</span><select data-action-id="${t}"${e.type===`multi-select`?` multiple`:``}>${(e.options??[]).map(e=>`<option value="${Z(e.value)}">${Z(e.label)}</option>`).join(``)}</select></label>`;if(e.type===`text-submit`)return`<label class="present-action-field"><span>${n}</span><div class="present-text-submit"><input type="text" class="present-text-input" data-action-id="${t}" data-action-label="${n}" placeholder="${n}" /><button type="button" class="present-action-btn present-action-primary present-submit-btn" data-submit-for="${t}">Send</button></div></label>`;if(e.type===`form-submit`){let r=e.schema;if(r)return`<form class="present-form" data-action-id="${t}" data-action-label="${n}">${Object.entries(r).map(([e,t])=>{let n=Z(t.description??e);return`<label class="present-action-field"><span>${n}</span><input type="${t.type===`number`?`number`:t.type===`boolean`?`checkbox`:`text`}" class="present-text-input" name="${Z(e)}" placeholder="${n}" /></label>`}).join(``)}<button type="submit" class="present-action-btn present-action-primary">${n}</button></form>`}return`<button type="button" class="present-action-btn present-action-${Z(e.variant??`default`)}" data-action-id="${t}" data-action-label="${n}">${n}</button>`}).join(``)}</div>
|
|
2677
2677
|
<p id="present-action-status" class="present-action-status" aria-live="polite"></p>
|
|
2678
2678
|
</section>
|
|
2679
2679
|
<style>
|
|
@@ -2876,8 +2876,8 @@ None.`:`### Stale Lessons\n${u.map(e=>`- **${e.title}** (\`${e.path}\`) — effe
|
|
|
2876
2876
|
navigator.sendBeacon('/callback', new Blob([body], { type: 'application/json' }));
|
|
2877
2877
|
});
|
|
2878
2878
|
})();
|
|
2879
|
-
<\/script>`}function
|
|
2880
|
-
`)}function
|
|
2879
|
+
<\/script>`}function jh(e){try{if(process.platform===`win32`){Sr(`cmd`,[`/c`,`start`,``,e],{windowsHide:!0});return}if(process.platform===`darwin`){Sr(`open`,[e]);return}Sr(`xdg-open`,[e])}catch{}}async function Mh(e){try{let t=qn();return await t.launch(`ui`),t.resetIdleTimer(),await(await t.getContext().newPage()).goto(e,{waitUntil:`domcontentloaded`}),!0}catch{return jh(e),!1}}function Nh(e,t,n){let r=[e.title];return e.description&&r.push(e.description),r.push(``,`Opened in browser at ${t}`,n),r.join(`
|
|
2880
|
+
`)}function Ph(e){return e.some(e=>e.id!==`__dismiss`)}function Fh(e){return e.replace(`</head>`,`<style>
|
|
2881
2881
|
.toolbar, .badge, body > header, body > footer { display: none !important; }
|
|
2882
2882
|
body { padding-top: 0 !important; margin-top: 0 !important; }
|
|
2883
2883
|
</style>
|
|
@@ -2888,8 +2888,8 @@ window.addEventListener('message', function(e) {
|
|
|
2888
2888
|
}
|
|
2889
2889
|
});
|
|
2890
2890
|
<\/script>
|
|
2891
|
-
</body>`)}function
|
|
2892
|
-
`);return{content:[{type:`text`,text:`[ERROR:VALIDATION] Template "${t.id}" data validation failed:\n${e}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`}],structuredContent:{kind:`error`,error:{code:`VIEWER_DATA_INVALID`,message:`Template "${t.id}" data validation failed:\n${e}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`}},isError:!0}}}let n=
|
|
2891
|
+
</body>`)}function Ih(e){if(!e.headersSent)try{e.writeHead(500,{"Content-Type":`text/plain`}),e.end(`Internal Server Error`)}catch{try{e.end()}catch{}}}async function Lh(e){let t=qn();t.isLaunched()||await t.launch(`headless`),t.resetIdleTimer();let n=await t.getContext().newPage();try{return await n.goto(e,{waitUntil:`domcontentloaded`}),await n.waitForLoadState(`networkidle`,{timeout:2e3}).catch(()=>{}),await n.screenshot({fullPage:!0,type:`png`})}finally{await n.close().catch(()=>{})}}async function Rh(e,t){if(!t){e.writeHead(503,{"Content-Type":`text/plain; charset=utf-8`}),e.end(`Screenshot target is not ready.`);return}try{let n=await Lh(t);e.writeHead(200,{"Content-Type":`image/png`,"Cache-Control":`no-store`}),e.end(n)}catch{Ih(e)}}function zh(e,t){return e.replace(/'\/callback'/g,`'/session/${t}/callback'`).replace(/"\/callback"/g,`"/session/${t}/callback"`)}function Bh(e,t){return e.replace(/src="\/viewer"/g,`src="/session/${t}/viewer"`)}async function Vh(e,t){if(og(`<html><body style="font-family:system-ui;padding:2rem;color:#888;text-align:center"><p>Content opened in browser window.</p></body></html>`),e.data!=null&&t.inputSchema){let n=ln({data:e.data,schema:t.inputSchema});if(!n.valid){let e=n.errors.map(e=>` ${e.path}: ${e.message}${e.expected?` (expected: ${e.expected}, got: ${e.received})`:``}`).join(`
|
|
2892
|
+
`);return{content:[{type:`text`,text:`[ERROR:VALIDATION] Template "${t.id}" data validation failed:\n${e}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`}],structuredContent:{kind:`error`,error:{code:`VIEWER_DATA_INVALID`,message:`Template "${t.id}" data validation failed:\n${e}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`}},isError:!0}}}let n=Fh(fm(t.resolveHtml(),e.data??null,t.injectId,t.transformData)),r=Sh(),i=se(16).toString(`hex`),a=r.createSession({surfaceId:`viewer`,transport:`viewer`,nonce:i});if(!a.ok)return{content:[{type:`text`,text:`${e.title}\n\nUnable to start local browser transport.`}],structuredContent:{kind:`error`,error:{code:`BROWSER_START_FAILED`,message:a.error.message}},isError:!0};let o=a.session.id,s=ih(`viewer`,[],r,o,i),c=Bh(Tr({title:e.title,subtitle:e.description,html:[`<div class="present-viewer-container">`,` <iframe class="present-viewer-iframe" src="/viewer" sandbox="allow-scripts allow-same-origin"></iframe>`,` <script>
|
|
2893
2893
|
(function() {
|
|
2894
2894
|
const iframe = document.querySelector('.present-viewer-iframe');
|
|
2895
2895
|
if (!iframe) return;
|
|
@@ -2905,10 +2905,34 @@ window.addEventListener('message', function(e) {
|
|
|
2905
2905
|
})();
|
|
2906
2906
|
<\/script>`,`</div>`].join(`
|
|
2907
2907
|
`),css:[[`.present-viewer-container {`,` flex: 1;`,` min-height: calc(100vh - 12rem);`,` position: relative;`,` border-radius: 0.75rem;`,` overflow: hidden;`,` border: none;`,`}`,`.present-viewer-iframe {`,` border: none;`,` width: 100%;`,` height: 100%;`,` position: absolute;`,` inset: 0;`,` border-radius: inherit;`,`}`].join(`
|
|
2908
|
-
`)],islands:[],payload:void 0,nonce:``,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:`local-interactive`,footerContentHtml:
|
|
2909
|
-
`),css:t.css,islands:t.islands,payload:t.payload,nonce:t.nonce,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:t.exportPolicy,footerContentHtml:
|
|
2910
|
-
|
|
2911
|
-
|
|
2908
|
+
`)],islands:[],payload:void 0,nonce:``,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:`local-interactive`,footerContentHtml:ah}),o);yh.set(o,{callbackSession:s,html:c,viewerHtml:n,hasClientConnected:!1,createdAt:Date.now()});let l=``;try{l=`http://127.0.0.1:${Ch()}/session/${o}`}catch(t){return yh.delete(o),r.removeSession(o),{content:[{type:`text`,text:`${e.title}\n\nUnable to start local browser transport.`}],structuredContent:{kind:`error`,error:{code:`BROWSER_START_FAILED`,message:t instanceof Error?t.message:`Unable to start browser transport`}},isError:!0}}return await Mh(l),setTimeout(()=>{yh.delete(o),r.removeSession(o)},mh),{content:[{type:`text`,text:Nh(e,l,`Rendered.`)}],structuredContent:{kind:`rendered`,reason:`no-response-required`}}}async function Hh(e){og(`<html><body style="font-family:system-ui;padding:2rem;color:#888;text-align:center"><p>Content opened in browser window.</p></body></html>`);let t=Nr(e,{transport:`browser`,registry:Fm,blockVendorScripts:zm()}),n=Sh(),r=se(16).toString(`hex`),i=n.createSession({surfaceId:t.surfaceId,transport:`browser`,nonce:r});if(!i.ok)return{content:[{type:`text`,text:`${e.title}\n\nUnable to start local browser transport.`}],structuredContent:{kind:`error`,error:{code:`BROWSER_START_FAILED`,message:i.error.message}},isError:!0};let a=i.session.id,o=ih(t.surfaceId,t.actions,n,a,r),s=fh(t.vendorScripts,`browser`);ph();let c=zh(Tr({title:e.title,subtitle:e.description,html:[t.html,Ah(t.actions,o.nonce)].filter(Boolean).join(`
|
|
2909
|
+
`),css:t.css,islands:t.islands,payload:t.payload,nonce:t.nonce,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:t.exportPolicy,footerContentHtml:ah,headScripts:s}),a);yh.set(a,{callbackSession:o,html:c,hasClientConnected:!1,createdAt:Date.now()});let l=``;try{l=`http://127.0.0.1:${Ch()}/session/${a}`;let e=yh.get(a);e&&e.hasClientConnected}catch(t){return yh.delete(a),n.removeSession(a),n.shutdown(),{content:[{type:`text`,text:`${e.title}\n\nUnable to start local browser transport.`}],structuredContent:o.settleError(`BROWSER_START_FAILED`,t instanceof Error?t.message:`Unable to start browser transport`),isError:!0}}let u=await Mh(l);if(!Ph(t.actions))return setTimeout(()=>{yh.delete(a);try{n.removeSession(a)}catch{}},mh),{content:[{type:`text`,text:Nh(e,l,`Rendered.`)}],structuredContent:{kind:`rendered`,reason:`no-response-required`}};let d=await Promise.race([o.promise,new Promise(e=>{setTimeout(()=>{yh.get(a)?.hasClientConnected||(yh.delete(a),e(o.settleError(`BROWSER_CONNECT_TIMEOUT`,u?`No browser client connected within ${hh}ms.`:`Fell back to system browser, but no browser client connected within ${hh}ms.`)))},hh)}),new Promise(e=>{setTimeout(()=>e(o.settleTimeout(mh)),mh)})]);setTimeout(()=>{yh.delete(a);try{n.removeSession(a)}catch{}},mh);let f=d.kind===`result`?`Selected action: ${d.result.actionId}`:d.kind===`timeout`?`Timed out after ${d.waitedMs}ms.`:d.kind===`cancelled`?`Cancelled: ${d.reason}.`:d.kind===`error`?`Error: ${d.error.message}`:`Rendered.`;return{content:[{type:`text`,text:Nh(e,l,f)}],structuredContent:d,isError:d.kind===`error`}}const Uh={id:`browser`,priority:20,canHandle(e,t){let n=Sg(e);return Lm(n)||!!t.preferBrowser&&!!Cg(n)},async render(e,t){return Hh(e)}},Wh=`openai/outputTemplate`,Gh=`ui/resourceUri`,Kh={connectDomains:[],resourceDomains:[]},qh={connect_domains:[],resource_domains:[]};function Jh(e){return{ui:{resourceUri:e,visibility:[`model`,`app`]},[Gh]:e,[Wh]:e,"openai/widgetAccessible":!0}}function Yh(){return{ui:{prefersBorder:!1,csp:Kh},"openai/widgetDescription":`AI Kit renders structured visual surfaces such as dashboards, charts, reports, and diagrams.`,"openai/widgetPrefersBorder":!1,"openai/widgetCSP":qh}}function Xh(e){return{ui:{resourceUri:e},[Gh]:e,[Wh]:e}}function Zh(e){return{...e,schemaVersion:1}}function Qh(e){try{let t=Nr(e,{transport:`mcp-app`,registry:Fm,blockVendorScripts:zm()}),n=fh(t.vendorScripts,`mcp-app`);return og(Eg(Tr({title:e.title,subtitle:e.description,html:t.html,css:t.css,islands:t.islands,payload:t.payload,nonce:t.nonce,colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`mcp-app`,exportPolicy:t.exportPolicy,footerContentHtml:ah,headScripts:n}))),{content:[{type:`text`,text:wg(e,{kind:`rendered`,reason:`no-response-required`},{includeSurfaceHeader:!1})}],structuredContent:Zh(e),_meta:Xh(rg),ui:{type:`resource`,uri:rg}}}catch(t){return Og(`RENDER_FAILED`,t instanceof Error?t.message:`Failed to render ChannelSurface`,void 0,e.title)}}const $h={id:`mcp-app`,priority:30,canHandle(e,t){return!0},async render(e,t){return Qh(e)}};var eg=class{handlers=[];register(e){let t=this.handlers.findIndex(t=>t.id===e.id);t===-1?this.handlers.push(e):this.handlers[t]=e}unregister(e){let t=this.handlers.findIndex(t=>t.id===e);t!==-1&&this.handlers.splice(t,1)}select(e,t){return[...this.handlers].sort((e,t)=>(e.priority??99)-(t.priority??99)).find(n=>n.canHandle(e,t))??null}getAll(){return[...this.handlers]}};async function tg(e,t){try{let n=Tg(fm(t.resolveHtml(),e.data??null,t.injectId,t.transformData)).replace(/&/g,`&`).replace(/"/g,`"`);return og(Eg(Tr({title:e.title,subtitle:e.description,html:[`<div class="present-viewer-container">`,` <iframe class="present-viewer-iframe" srcdoc="${n}" sandbox="allow-scripts allow-same-origin"></iframe>`,` <script>
|
|
2910
|
+
(function() {
|
|
2911
|
+
const iframe = document.querySelector('.present-viewer-iframe');
|
|
2912
|
+
if (!iframe) return;
|
|
2913
|
+
const sendTheme = function() {
|
|
2914
|
+
const theme = document.documentElement.getAttribute('data-theme');
|
|
2915
|
+
if (iframe.contentWindow) {
|
|
2916
|
+
iframe.contentWindow.postMessage({ type: 'aikit-theme-change', theme: theme }, '*');
|
|
2917
|
+
}
|
|
2918
|
+
};
|
|
2919
|
+
const observer = new MutationObserver(sendTheme);
|
|
2920
|
+
observer.observe(document.documentElement, { attributes: true, attributeFilter: ['data-theme'] });
|
|
2921
|
+
iframe.addEventListener('load', sendTheme);
|
|
2922
|
+
})();
|
|
2923
|
+
<\/script>`,` <script>
|
|
2924
|
+
window.addEventListener('message', function(e) {
|
|
2925
|
+
if (e.data && e.data.type === 'aikit-viewer-height') {
|
|
2926
|
+
var container = document.querySelector('.present-viewer-container');
|
|
2927
|
+
if (container) { container.style.height = e.data.height + 'px'; }
|
|
2928
|
+
}
|
|
2929
|
+
});
|
|
2930
|
+
<\/script>`,`</div>`].join(`
|
|
2931
|
+
`),css:[[`.present-viewer-container {`,` flex: 1;`,` min-height: 640px;`,` position: relative;`,` border-radius: 0.75rem;`,` overflow: hidden;`,` border: none;`,`}`,`.present-viewer-iframe {`,` border: none;`,` width: 100%;`,` height: 100%;`,` position: absolute;`,` inset: 0;`,` border-radius: inherit;`,`}`].join(`
|
|
2932
|
+
`)],islands:[],payload:void 0,nonce:``,generatedAt:new Date().toISOString(),footerContentHtml:ah,colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`mcp-app`,exportPolicy:`local-interactive`}))),{content:[{type:`text`,text:wg(e,{kind:`rendered`,reason:`no-response-required`},{includeSurfaceHeader:!1})}],structuredContent:Zh(e),_meta:Xh(rg),ui:{type:`resource`,uri:rg}}}catch(t){return Og(`VIEWER_RENDER_FAILED`,t instanceof Error?t.message:`Failed to render viewer template`,void 0,e.title)}}const ng={id:`viewer`,priority:10,canHandle(e,t){return e.template?lm(e.template)!=null:!1},async render(e,t){let n=lm(e.template??``);if(!n)return Og(`VIEWER_NOT_FOUND`,`Viewer template "${e.template}" not found`,void 0,e.title);if(e.data!=null&&n.inputSchema){let t=ln({data:e.data,schema:n.inputSchema});if(!t.valid){let r=t.errors.map(e=>` ${e.path}: ${e.message}${e.expected?` (expected: ${e.expected}, got: ${e.received})`:``}`).join(`
|
|
2933
|
+
`);return Og(`VIEWER_DATA_INVALID`,`Template "${n.id}" data validation failed:\n${r}\n\nExpected schema: ${JSON.stringify(n.inputSchema,null,2)}`,void 0,e.title)}}let r=n.supportedTransports.includes(`browser`),i=n.supportedTransports.includes(`mcp-app`);return t.preferBrowser&&r||r&&!i?await Vh(e,n):i?tg(e,n):Og(`VIEWER_TRANSPORT_UNSUPPORTED`,`Viewer template "${n.id}" does not support an available transport`,void 0,e.title)}},rg=`ui://aikit/present.html`;let ig=``;function ag(){return ig}function og(e){ig=e}const sg=new eg;sg.register(ng),sg.register(Uh),sg.register($h);function cg(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}const lg=/\\u[0-9a-fA-F]{4}/,ug=/^\s*\|(?:[^|\r\n]+\|){2,}\s*$/,dg=/^\s*\|?(?:\s*:?-{3,}:?\s*\|){2,}\s*$/,fg=/\b(cli|terminal|tty|console|command(?:-|\s)?line)\b/i;function pg(e){let t=[e.value,e.markdown,e.text,e.content];for(let e of t)if(typeof e==`string`&&e.trim().length>0)return e}function mg(e){let t=e.split(/\r?\n/);for(let e=0;e<t.length-1;e+=1)if(ug.test(t[e])&&dg.test(t[e+1]))return!0;return!1}function hg(e){let t=e.trim().split(`|`),n=+(t[0]?.trim()===``),r=t.at(-1)?.trim()===``?t.length-1:t.length;return t.slice(n,r).map(e=>e.trim())}function gg(e,t){if(t<2)return!1;let n=e.trim();return n.startsWith(`|`)?hg(n).length===t:!1}function _g(e){let t=e.split(/\r?\n/),n=[],r=[],i=()=>{r.length!==0&&(n.push({type:`text`,content:r.join(`
|
|
2934
|
+
`)}),r.length=0)},a=0;for(;a<t.length;){let e=t[a],o=t[a+1];if(o!==void 0&&ug.test(e)&&dg.test(o)){let r=hg(e),o=[];i();let s=a+2;for(;s<t.length&&gg(t[s],r.length);)o.push(hg(t[s])),s+=1;n.push({type:`table`,headers:r,rows:o}),a=s;continue}r.push(e),a+=1}return i(),n}function vg(e){let t=pg(e);return!t||!mg(t)?[e]:_g(t).flatMap(e=>{if(e.type===`text`){let t=e.content.trim();return t.length>0?[{type:`markdown`,value:t}]:[]}return[{type:`table`,value:{headers:e.headers,rows:e.rows}}]})}function yg(e){if(typeof e==`string`)return fg.test(e);if(Array.isArray(e))return e.some(e=>yg(e));if(!cg(e))return!1;let t=[`client`,`clientInfo`,`host`,`source`,`mode`,`name`,`title`,`channel`];return Object.entries(e).some(([e,n])=>t.includes(e)?yg(n):!1)}function bg(e,t){return{preferBrowser:[t,e._meta,cg(e.metadata)?e.metadata.source:void 0].some(e=>yg(e))}}const xg={id:`__dismiss`,type:`button`,label:`Done`,variant:`default`};function Sg(e){if((e.actions?.length??0)>0||!e.template)return e;let t=Im(e);return t?.supportedTransports.includes(`browser`)===!0&&!t.supportedTransports.includes(`mcp-app`)?{...e,actions:[xg]}:e}function Cg(e){if(!e.template)return!0;let t=lm(e.template);return t?t.supportedTransports.includes(`browser`):Im(e)?.supportedTransports.includes(`browser`)??!1}function wg(e,t,n={}){let r=n.includeSurfaceHeader??!0,i=r?[e.title]:[];return r&&e.description&&i.push(e.description),Ar(t)?i.push(``,`Selected action: ${t.result.actionId}`):kr(t)?i.push(``,`Error: ${t.error.message}`):t.kind===`timeout`?i.push(``,`Timed out after ${t.waitedMs}ms.`):t.kind===`cancelled`?i.push(``,`Cancelled: ${t.reason}.`):r||i.push(`Rendered inline.`),i.join(`
|
|
2935
|
+
`)}function Tg(e){return e.replace(`</head>`,`<style>
|
|
2912
2936
|
.toolbar, .badge, body > header, body > footer { display: none !important; }
|
|
2913
2937
|
body { padding-top: 0 !important; margin-top: 0 !important; }
|
|
2914
2938
|
</style>
|
|
@@ -2916,7 +2940,7 @@ window.addEventListener('message', function(e) {
|
|
|
2916
2940
|
(function() {
|
|
2917
2941
|
function report() {
|
|
2918
2942
|
var h = document.documentElement.scrollHeight;
|
|
2919
|
-
window.parent.postMessage({ type: 'aikit-viewer-height', height: h },
|
|
2943
|
+
window.parent.postMessage({ type: 'aikit-viewer-height', height: h }, window.location.origin);
|
|
2920
2944
|
}
|
|
2921
2945
|
var ro = new ResizeObserver(report);
|
|
2922
2946
|
ro.observe(document.documentElement);
|
|
@@ -2925,52 +2949,29 @@ window.addEventListener('message', function(e) {
|
|
|
2925
2949
|
<\/script>
|
|
2926
2950
|
<script>
|
|
2927
2951
|
window.addEventListener('message', function(e) {
|
|
2952
|
+
if (e.origin !== window.location.origin) return;
|
|
2928
2953
|
if (e.data && e.data.type === 'aikit-theme-change') {
|
|
2929
2954
|
document.documentElement.setAttribute('data-theme', e.data.theme);
|
|
2930
2955
|
}
|
|
2931
2956
|
});
|
|
2932
2957
|
<\/script>
|
|
2933
|
-
</body>`)}function
|
|
2958
|
+
</body>`)}function Eg(e){let t=`<script>
|
|
2934
2959
|
(function(){
|
|
2935
2960
|
var last=0;
|
|
2936
2961
|
function notify(){
|
|
2937
2962
|
var h=Math.ceil(document.documentElement.scrollHeight);
|
|
2938
|
-
if(h!==last){last=h;window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/size-changed",params:{height:h}},
|
|
2963
|
+
if(h!==last){last=h;window.parent.postMessage({jsonrpc:"2.0",method:"ui/notifications/size-changed",params:{height:h}},window.location.origin)}
|
|
2939
2964
|
}
|
|
2940
2965
|
notify();
|
|
2941
2966
|
if(typeof ResizeObserver!=="undefined"){new ResizeObserver(notify).observe(document.documentElement)}
|
|
2942
2967
|
else{setInterval(notify,500)}
|
|
2943
2968
|
})();
|
|
2944
|
-
<\/script>`;return e.includes(`</body>`)?e.replace(`</body>`,`${t}</body>`):`${e}${t}`}function
|
|
2945
|
-
`)}function
|
|
2946
|
-
`);return tg(`VIEWER_DATA_INVALID`,`Template "${t.id}" data validation failed:\n${r}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`,void 0,e.title)}}let r=t.supportedTransports.includes(`browser`),i=t.supportedTransports.includes(`mcp-app`);if(n.preferBrowser&&r||r&&!i)return await xh(e,t);if(!i)return tg(`VIEWER_TRANSPORT_UNSUPPORTED`,`Viewer template "${t.id}" does not support an available transport`,void 0,e.title);try{let n=Qh(Dm(t.resolveHtml(),e.data??null,t.injectId,t.transformData)).replace(/&/g,`&`).replace(/"/g,`"`);return Ph($h(Er({title:e.title,subtitle:e.description,html:[`<div class="present-viewer-container">`,` <iframe class="present-viewer-iframe" srcdoc="${n}" sandbox="allow-scripts allow-same-origin"></iframe>`,` <script>
|
|
2947
|
-
(function() {
|
|
2948
|
-
const iframe = document.querySelector('.present-viewer-iframe');
|
|
2949
|
-
if (!iframe) return;
|
|
2950
|
-
const sendTheme = function() {
|
|
2951
|
-
const theme = document.documentElement.getAttribute('data-theme');
|
|
2952
|
-
if (iframe.contentWindow) {
|
|
2953
|
-
iframe.contentWindow.postMessage({ type: 'aikit-theme-change', theme: theme }, '*');
|
|
2954
|
-
}
|
|
2955
|
-
};
|
|
2956
|
-
const observer = new MutationObserver(sendTheme);
|
|
2957
|
-
observer.observe(document.documentElement, { attributes: true, attributeFilter: ['data-theme'] });
|
|
2958
|
-
iframe.addEventListener('load', sendTheme);
|
|
2959
|
-
})();
|
|
2960
|
-
<\/script>`,` <script>
|
|
2961
|
-
window.addEventListener('message', function(e) {
|
|
2962
|
-
if (e.data && e.data.type === 'aikit-viewer-height') {
|
|
2963
|
-
var container = document.querySelector('.present-viewer-container');
|
|
2964
|
-
if (container) { container.style.height = e.data.height + 'px'; }
|
|
2965
|
-
}
|
|
2966
|
-
});
|
|
2967
|
-
<\/script>`,`</div>`].join(`
|
|
2968
|
-
`),css:[[`.present-viewer-container {`,` flex: 1;`,` min-height: 640px;`,` position: relative;`,` border-radius: 0.75rem;`,` overflow: hidden;`,` border: none;`,`}`,`.present-viewer-iframe {`,` border: none;`,` width: 100%;`,` height: 100%;`,` position: absolute;`,` inset: 0;`,` border-radius: inherit;`,`}`].join(`
|
|
2969
|
-
`)],islands:[],payload:void 0,nonce:``,generatedAt:new Date().toISOString(),footerContentHtml:ym,colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`mcp-app`,exportPolicy:`local-interactive`}))),{content:[{type:`text`,text:Yh(e,{kind:`rendered`,reason:`no-response-required`},{includeSurfaceHeader:!1})}],structuredContent:Ah(e),_meta:kh(jh),ui:{type:`resource`,uri:jh}}}catch(t){return tg(`VIEWER_RENDER_FAILED`,t instanceof Error?t.message:`Failed to render viewer template`,void 0,e.title)}}function ag(e){try{let t=Pr(e,{transport:`mcp-app`,registry:Xm,blockVendorScripts:am()}),n=rh(t.vendorScripts,`mcp-app`);return Mh=$h(Er({title:e.title,subtitle:e.description,html:t.html,css:t.css,islands:t.islands,payload:t.payload,nonce:t.nonce,colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`mcp-app`,exportPolicy:t.exportPolicy,footerContentHtml:ym,headScripts:n})),{content:[{type:`text`,text:Yh(e,{kind:`rendered`,reason:`no-response-required`},{includeSurfaceHeader:!1})}],structuredContent:Ah(e),_meta:kh(jh),ui:{type:`resource`,uri:jh}}}catch(t){return tg(`RENDER_FAILED`,t instanceof Error?t.message:`Failed to render ChannelSurface`,void 0,e.title)}}const og=z.object({label:z.string(),value:z.string(),description:z.string().optional()}),sg=z.object({id:z.string().describe(`Unique action identifier`),type:z.enum([`button`,`select`,`multi-select`,`form-submit`,`text-submit`,`confirm`,`custom`]).describe(`Interactive action type`),label:z.string().describe(`Visible action label`),variant:z.enum([`primary`,`danger`,`default`]).optional(),options:z.array(og).optional(),schema:z.record(z.string(),z.unknown()).optional()}),cg=z.object({type:z.string(),title:z.string().optional(),value:z.unknown().optional(),language:z.string().optional()}).catchall(z.unknown()),lg={schemaVersion:z.literal(1).describe(`ChannelSurface schema version. Must be 1.`),title:z.string().describe(`Surface title shown to the user.`),description:z.string().optional().describe(`Optional supporting copy for the surface.`),template:z.string().optional().describe(`Optional template id such as report@1.`),layout:z.object({maxWidth:z.string().optional(),padding:z.string().optional(),columns:z.number().optional()}).optional(),blocks:z.array(cg).optional().describe(`Typed block content for the surface.`),data:z.unknown().optional().describe(`Template data payload, if the template expands data.`),actions:z.array(sg).optional().describe(`Interactive actions. Presence triggers browser transport.`),response:z.object({timeout:z.number().optional(),required:z.boolean().optional()}).optional(),metadata:z.object({surfaceId:z.string().optional(),createdAt:z.string().optional(),source:z.string().optional()}).optional(),colorScheme:z.enum([`light`,`dark`,`auto`]).optional(),lang:z.string().optional(),dir:z.enum([`ltr`,`rtl`,`auto`]).optional()};z.object({surfaceId:z.string(),actionId:z.string(),actionType:z.enum([`button`,`select`,`multi-select`,`form-submit`,`text-submit`,`confirm`,`custom`]),value:z.unknown().optional(),formData:z.record(z.string(),z.unknown()).optional(),selection:z.union([z.string(),z.array(z.string())]).optional(),label:z.string().optional(),timestamp:z.string(),sourceTransport:z.enum([`mcp-app`,`browser`,`export`])});function ug(e){let t=e.server?.getClientCapabilities?.();if(!t)return`unknown`;let n=mr(t);return!n||Array.isArray(n.mimeTypes)&&n.mimeTypes.length>0&&!n.mimeTypes.includes(pr)?`unsupported`:`supported`}function dg(e,t){let n=G(`present`),r=[`Render a ChannelSurface for the user.`,`Quick ref:`,`- Full schema: aikit://schemas/channel-surface`,`- Required: schemaVersion: 1, title`,`- Content: blocks[] for direct rendering, or template + data for registry-backed rendering`,`- Actions: actions[] of SurfaceAction; interactive surfaces use browser transport and return ChannelOutcome`,`- Optional fields: description, layout, response, metadata, colorScheme, lang, dir`,`- Transports: mcp-app, browser, export`,`- Use schema resource for block enums and action details.`].join(`
|
|
2970
|
-
`);gr(e,`present`,{title:n.title,description:r,inputSchema:lg,annotations:n.annotations,_meta:Dh(jh)},Y(`present`,async(t,n)=>{let r=ng(t,n);if(!r.ok)return r.response;let i=ug(e);return await rg(r.surface,{...r.options,preferBrowser:r.options.preferBrowser||i===`unsupported`})}));try{hr(e,`Present View`,jh,{description:`AI Kit present tool viewer`,_meta:Oh()},async()=>({contents:[{uri:jh,mimeType:pr,_meta:Oh(),text:Nh()||`<html><body><p>No content generated yet. Call the present tool first.</p></body></html>`}]}))}catch{}try{e.registerResource(`present-templates`,`aikit://present/templates`,{description:`List all registered present viewer templates with their input schemas`},async()=>{let e=Em().map(e=>({id:e.id,label:e.label,description:e.description,transports:e.supportedTransports,inputSchema:e.inputSchema}));return{contents:[{uri:`aikit://present/templates`,mimeType:`application/json`,text:JSON.stringify(e,null,2)}]}})}catch{}}const fg=L(`tools`);function pg(e,t){let n=new er({structure:new nr,dependencies:new Zn,symbols:new rr,patterns:new tr,entryPoints:new $n,diagrams:new Qn}),r=G(`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:z.string().optional().describe(`Root path to analyze (defaults to workspace root)`),aspects:z.array(z.enum([`all`,`structure`,`dependencies`,`symbols`,`patterns`,`entry-points`,`diagrams`])).default([`all`]).describe(`Which analysis aspects to run`)},annotations:r.annotations},Y(`produce_knowledge`,async({scope:e,aspects:r},i)=>{let a;try{a=Uc(i).createTask(`Produce Knowledge`,3),a.progress(0,`Running analyzers`);let o=e??`.`;fg.info(`Running knowledge production`,{rootPath:o,aspects:r});let s=await n.runExtraction(o,r);try{let e=t?.onboardDir??``;if(!e)throw fg.warn(`onboardDir not configured — skipping artifact persistence.`),Error(`skip`);N(e,{recursive:!0});let n=`<!-- Generated by produce_knowledge at ${new Date().toISOString()} -->\n\n`;for(let[t,r]of Object.entries(s))r&&typeof r==`string`&&me(F(e,`${t}.md`),n+r,`utf-8`);fg.info(`Knowledge persisted to .ai/context/`,{files:Object.keys(s).length})}catch(e){fg.warn(`Failed to persist knowledge to .ai/context/`,{error:R(e)})}a.progress(1,`Synthesizing results`);let c=n.buildSynthesisInstructions(s,r);return a.complete(`Knowledge production complete`),{content:[{type:`text`,text:c+`
|
|
2969
|
+
<\/script>`;return e.includes(`</body>`)?e.replace(`</body>`,`${t}</body>`):`${e}${t}`}function Dg(e,t){return[`<!DOCTYPE html>`,`<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">`,`<title>Error — ${Z(e)}</title>`,`<style>`,` * { box-sizing: border-box; margin: 0; padding: 0; }`,` body { font-family: system-ui, -apple-system, sans-serif; min-height: 100vh; display: flex; align-items: center; justify-content: center; padding: 2rem; background: #fafafa; color: #333; }`,` .error-card { max-width: 560px; width: 100%; padding: 2.5rem; border-radius: 1rem; background: #fff; border: 1px solid #e5e7eb; box-shadow: 0 1px 3px rgba(0,0,0,0.06); }`,` .error-badge { display: inline-block; font-size: 0.75rem; font-weight: 600; text-transform: uppercase; letter-spacing: 0.05em; color: #dc2626; background: #fef2f2; border: 1px solid #fecaca; border-radius: 0.375rem; padding: 0.25rem 0.625rem; margin-bottom: 1rem; }`,` .error-title { font-size: 1.25rem; font-weight: 600; margin-bottom: 0.75rem; color: #111; }`,` .error-message { font-size: 0.875rem; line-height: 1.6; color: #6b7280; white-space: pre-wrap; word-break: break-word; }`,`</style></head><body>`,`<div class="error-card">`,` <span class="error-badge">Render Error</span>`,` <h1 class="error-title">${Z(e)}</h1>`,` <p class="error-message">${Z(t)}</p>`,`</div>`,`</body></html>`].join(`
|
|
2970
|
+
`)}function Og(e,t,n,r){return og(Dg(r??`Present`,t)),{content:[{type:`text`,text:`[ERROR:VALIDATION] ${t}`}],isError:!0}}function kg(e,t){if(!cg(e)||!(`schemaVersion`in e))return{ok:!1,response:Og(`INVALID_CHANNEL_SURFACE`,`present expects a ChannelSurface object with schemaVersion: 1`)};if(e.schemaVersion!==1)return{ok:!1,response:Og(`UNSUPPORTED_SCHEMA_VERSION`,`Unsupported ChannelSurface schemaVersion: ${String(e.schemaVersion)}`)};if(typeof e.title==`string`&&lg.test(e.title))return{ok:!1,response:Og(`TITLE_UNICODE_ESCAPE_NOT_ALLOWED`,`Use actual Unicode characters in title, not escape sequences.`)};let n=Array.isArray(e.blocks)?{...e,blocks:e.blocks.flatMap(e=>{if(!cg(e)||e.type!==`markdown`)return[e];let t=pg(e);return!t||!mg(t)?[e]:vg(e)})}:e;return{ok:!0,surface:n,options:bg(n,t)}}async function Ag(e,t={}){let n=Sg(e),r=sg.select(n,t),i;if(i=r?await r.render(n,t):Qh(n),t.compact){let{structuredContent:e,...t}=i;return t}return i}function jg(e,t=``){return typeof e==`string`?e:typeof e==`number`||typeof e==`boolean`?String(e):t}function Mg(e){return{type:`kv`,value:e}}function Ng(e){if(Array.isArray(e))return e}const Pg=[{name:`summary`,description:`Title + markdown summary + optional metrics (pass/fail counts)`,expand(e){let t=jg(e.title,`Summary`),n=[{type:`heading`,value:t}],r=jg(e.summary);r&&n.push({type:`markdown`,value:r});let i=Number(e.passed)||0,a=Number(e.failed)||0;if(i>0||a>0){let e=[];i>0&&e.push({label:`Passed`,value:i,status:`success`}),a>0&&e.push({label:`Failed`,value:a,status:`error`}),n.push({type:`metrics`,value:e})}return{title:t,blocks:n}}},{name:`plan`,description:`Title + heading per step + checklist items`,expand(e){let t=jg(e.title,`Plan`),n=[{type:`heading`,value:t}],r=Ng(e.steps);return r&&n.push({type:`checklist`,value:{items:r}}),{title:t,blocks:n}}},{name:`understanding`,description:`Title + markdown explanation + kv pairs`,expand(e){let t=jg(e.title,`Understanding`),n=[{type:`heading`,value:t}],r=jg(e.explanation);return r&&n.push({type:`markdown`,value:r}),e.details&&typeof e.details==`object`&&!Array.isArray(e.details)&&n.push(Mg(e.details)),{title:t,blocks:n}}},{name:`bug-analyze`,description:`Title + heading + severity/status kv + code block + markdown`,expand(e){let t=jg(e.title,`Bug Analysis`),n=[{type:`heading`,value:t}],r={};e.severity&&(r.Severity=e.severity),e.status&&(r.Status=e.status),Object.keys(r).length>0&&n.push({type:`kv`,value:r});let i=jg(e.code);i&&n.push({type:`code`,value:i});let a=jg(e.analysis);return a&&n.push({type:`markdown`,value:a}),{title:t,blocks:n}}},{name:`task-done`,description:`Title + checklist of completed items + optional metrics`,expand(e){let t=jg(e.title,`Task Complete`),n=[{type:`heading`,value:t}],r=Ng(e.items);r&&n.push({type:`checklist`,value:{items:r}});let i=e.completed,a=e.total;if(i!==void 0||a!==void 0){let e=[];i!==void 0&&e.push({label:`Completed`,value:Number(i)||i,status:`success`}),a!==void 0&&e.push({label:`Total`,value:Number(a)||a}),n.push({type:`metrics`,value:e})}return{title:t,blocks:n}}},{name:`review`,description:`Title + criteria checklist + annotation items + approval controls`,expand(e){let t=jg(e.title,`Review`),n=[{type:`heading`,value:t}],r=Ng(e.criteria);r&&n.push({type:`checklist`,value:{items:r}});let i=e.annotations;Array.isArray(i)&&i.length>0&&n.push({type:`annotation`,value:i});let a=e.approval;return a&&typeof a==`object`?n.push({type:`approval`,value:a}):n.push({type:`actions`,value:[{type:`button`,id:`approve`,label:`Approve`,variant:`primary`},{type:`button`,id:`reject`,label:`Reject`,variant:`danger`}]}),{title:t,blocks:n}}},{name:`explore`,description:`Title + heading per finding + code blocks`,expand(e){let t=jg(e.title,`Exploration`),n=[{type:`heading`,value:t}],r=Ng(e.findings);if(r)for(let e of r)n.push({type:`heading`,value:jg(e.heading,`Finding`)}),e.code&&n.push({type:`code`,value:e.code});return{title:t,blocks:n}}},{name:`decision`,description:`Title + kv for recommendation + comparison blocks per option`,expand(e){let t=jg(e.title,`Decision`),n=[{type:`heading`,value:t}];e.recommendation&&n.push({type:`kv`,value:{Recommendation:e.recommendation}});let r=Ng(e.options);return r&&r.length>0&&n.push({type:`comparison`,value:r.map(e=>({title:jg(e.title,`Option`),items:Array.isArray(e.items)?e.items:[]}))}),{title:t,blocks:n}}}],Fg=new Map;for(let e of Pg)Fg.set(e.name,e);function Ig(e,t){let n=Fg.get(e);return n?n.expand(t):null}const Lg={h:`heading`,m:`markdown`,t:`table`,p:`paragraph`,c:`code`,s:`separator`,M:`metrics`,C:`chart`,T:`timeline`,g:`graph`,tr:`tree`,tl:`timeline`,cl:`checklist`,pr:`progress`,sb:`status-board`,kv:`kv`,ac:`actions`,di:`mermaid`},Rg=/^(#{1,6})\s/,zg=/^(`{3,}|~{3,})/,Bg=/^\|.+\|.+\|/m;function Vg(e){let t=e.trim(),n=t.match(Rg);if(n)return{type:`heading`,value:t.slice(n[0].length)};if(zg.test(t)){let e=t.indexOf(`
|
|
2971
|
+
`),n=t.lastIndexOf(t[0]);return{type:`code`,value:e>=0?t.slice(e+1,n).trimEnd():t}}return Bg.test(t)?{type:`table`,value:t}:{type:`markdown`,value:t}}function Hg(e,t){let n=Lg[e];if(!n)return null;switch(e){case`M`:return{type:`metrics`,value:t};case`C`:return{type:`chart`,value:t};case`T`:case`tl`:return{type:`timeline`,value:t};case`g`:return{type:`graph`,value:t};case`tr`:return{type:`tree`,value:t};case`cl`:return{type:`checklist`,value:t};case`pr`:return{type:`progress`,value:t};case`sb`:return{type:`status-board`,value:t};case`kv`:return{type:`kv`,value:t};case`ac`:return{type:`actions`,value:t};case`di`:return{type:`mermaid`,value:t};case`s`:return{type:`separator`,value:t||!0};default:return{type:n,value:typeof t==`string`?t:String(t??``)}}}function Ug(e){if(typeof e==`string`){let t=Vg(e);return{type:t.type,value:t.value}}if(Array.isArray(e)){let[t,n]=e;if(typeof t==`string`){let e=Hg(t,n);if(e)return e}return{type:`markdown`,value:String(t??``)}}if(typeof e==`object`&&e){let{blockId:t,...n}=e;return n}return{type:`markdown`,value:String(e??``)}}function Wg(e){return{title:e.title??``,blocks:Array.isArray(e.blocks)?e.blocks.map(Ug):[]}}function Gg(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Kg(e){return Gg(e)&&typeof e.schemaVersion==`number`&&e.schemaVersion===1}function qg(e){return Gg(e)&&typeof e.schemaVersion==`number`&&e.schemaVersion!==1}function Jg(e){return e.schemaVersion===1?typeof e.title!=`string`||e.title.length===0?{ok:!1,error:{code:`MISSING_TITLE`,reason:`ChannelSurface requires a non-empty title`}}:e.blocks!==void 0&&!Array.isArray(e.blocks)?{ok:!1,error:{code:`INVALID_BLOCKS`,reason:`blocks must be an array of TypedBlock objects`}}:{ok:!0,surface:e}:{ok:!1,error:{code:`UNSUPPORTED_SCHEMA_VERSION`,reason:`Unsupported schemaVersion: ${String(e.schemaVersion)}`}}}function Yg(e){if(Array.isArray(e)){if(e.length!==2)return{ok:!1,error:{code:`INVALID_PRESET_INPUT`,reason:`Preset input must be a [name, data] tuple`,hint:`Use [presetName, { title, ...fields }]`}};let[t,n]=e;if(typeof t!=`string`)return{ok:!1,error:{code:`INVALID_PRESET_INPUT`,reason:`Preset name must be a string`}};if(!Gg(n))return{ok:!1,error:{code:`INVALID_PRESET_INPUT`,reason:`Preset data must be an object`}};let r=Ig(t,n);return r?{ok:!0,surface:{schemaVersion:1,title:r.title,blocks:r.blocks}}:{ok:!1,error:{code:`UNKNOWN_PRESET`,reason:`Unknown preset: ${t}`,hint:`Available presets: summary, plan, understanding, bug-analyze, task-done, review, explore, decision`}}}if(qg(e))return{ok:!1,error:{code:`UNSUPPORTED_SCHEMA_VERSION`,reason:`Unsupported schemaVersion: ${String(e.schemaVersion)}`,hint:`Use schemaVersion: 1`}};if(Kg(e))return Jg(e);if(typeof e==`string`){let t=Wg({blocks:[e]});return{ok:!0,surface:{schemaVersion:1,title:t.title||`Present`,blocks:t.blocks}}}if(Gg(e)){if(!(`blocks`in e)&&!(`title`in e))return{ok:!1,error:{code:`INVALID_INPUT`,reason:`Expected a ChannelSurface object, preset tuple, or shorthand input`}};let t=Wg(e);return{ok:!0,surface:{schemaVersion:1,title:t.title||`Present`,blocks:t.blocks}}}return{ok:!1,error:{code:`INVALID_INPUT`,reason:`Expected a ChannelSurface object, preset tuple, or shorthand input`}}}const Xg=B.object({label:B.string(),value:B.string(),description:B.string().optional()}),Zg=B.object({id:B.string().describe(`Unique action identifier`),type:B.enum([`button`,`select`,`multi-select`,`form-submit`,`text-submit`,`confirm`,`custom`]).describe(`Interactive action type`),label:B.string().describe(`Visible action label`),variant:B.enum([`primary`,`danger`,`default`]).optional(),options:B.array(Xg).optional(),schema:B.record(B.string(),B.unknown()).optional()}),Qg=B.object({type:B.string(),title:B.string().optional(),value:B.unknown().optional(),language:B.string().optional()}).catchall(B.unknown()),$g={schemaVersion:B.literal(1).describe(`ChannelSurface schema version. Must be 1.`),title:B.string().describe(`Surface title shown to the user.`),description:B.string().optional().describe(`Optional supporting copy for the surface.`),template:B.string().optional().describe(`Optional template id such as report@1.`),layout:B.object({maxWidth:B.string().optional(),padding:B.string().optional(),columns:B.number().optional()}).optional(),blocks:B.array(Qg).optional().describe(`Typed block content for the surface.`),data:B.unknown().optional().describe(`Template data payload, if the template expands data.`),actions:B.array(Zg).optional().describe(`Interactive actions. Presence triggers browser transport.`),response:B.object({timeout:B.number().optional(),required:B.boolean().optional()}).optional(),metadata:B.object({surfaceId:B.string().optional(),createdAt:B.string().optional(),source:B.string().optional()}).optional(),colorScheme:B.enum([`light`,`dark`,`auto`]).optional(),lang:B.string().optional(),dir:B.enum([`ltr`,`rtl`,`auto`]).optional()};B.object({surfaceId:B.string(),actionId:B.string(),actionType:B.enum([`button`,`select`,`multi-select`,`form-submit`,`text-submit`,`confirm`,`custom`]),value:B.unknown().optional(),formData:B.record(B.string(),B.unknown()).optional(),selection:B.union([B.string(),B.array(B.string())]).optional(),label:B.string().optional(),timestamp:B.string(),sourceTransport:B.enum([`mcp-app`,`browser`,`export`])});function e_(e){let t=e.server?.getClientCapabilities?.();if(!t)return`unknown`;let n=pr(t);return!n||Array.isArray(n.mimeTypes)&&n.mimeTypes.length>0&&!n.mimeTypes.includes(fr)?`unsupported`:`supported`}const t_=[{name:`summary`,description:`Title + markdown summary + optional metrics (pass/fail counts)`,inputSchema:{type:`object`,properties:{title:{type:`string`,description:`Section heading`},summary:{type:`string`,description:`Free-form markdown summary`},passed:{type:`number`,description:`Pass count for metrics`},failed:{type:`number`,description:`Fail count for metrics`}},required:[`title`]},example:JSON.stringify({title:`Build Summary`,summary:`All tests passed.`,passed:42,failed:0}),expandsTo:`blocks: [heading, markdown, metrics]`},{name:`plan`,description:`Title + heading per step + checklist items`,inputSchema:{type:`object`,properties:{title:{type:`string`},steps:{type:`array`,items:{type:`object`,properties:{label:{type:`string`},checked:{type:`boolean`}}}}},required:[`title`]},example:JSON.stringify({title:`Sprint Plan`,steps:[{label:`Write tests`,checked:!1},{label:`Deploy`,checked:!1}]}),expandsTo:`blocks: [heading, checklist]`},{name:`understanding`,description:`Title + markdown explanation + kv pairs`,inputSchema:{type:`object`,properties:{title:{type:`string`},explanation:{type:`string`},details:{type:`object`,additionalProperties:{type:`string`}}},required:[`title`,`explanation`]},example:JSON.stringify({title:`Architecture Overview`,explanation:`The system uses microservices.`,details:{Language:`TypeScript`,Runtime:`Node`}}),expandsTo:`blocks: [heading, markdown, kv]`},{name:`bug-analyze`,description:`Title + heading + severity/status kv + code block + markdown`,inputSchema:{type:`object`,properties:{title:{type:`string`},severity:{type:`string`},status:{type:`string`},code:{type:`string`},analysis:{type:`string`}},required:[`title`,`severity`,`status`]},example:JSON.stringify({title:`Null pointer in auth`,severity:`high`,status:`open`,code:`const x = obj.prop;`,analysis:`obj may be null when token missing.`}),expandsTo:`blocks: [heading, kv, code, markdown]`},{name:`task-done`,description:`Title + checklist of completed items + optional metrics`,inputSchema:{type:`object`,properties:{title:{type:`string`},items:{type:`array`,items:{type:`object`,properties:{label:{type:`string`},checked:{type:`boolean`}}}},completed:{type:`number`},total:{type:`number`}},required:[`title`,`items`]},example:JSON.stringify({title:`PR #42 Done`,items:[{label:`Lint pass`,checked:!0},{label:`Tests pass`,checked:!0}],completed:2,total:2}),expandsTo:`blocks: [heading, checklist, metrics]`},{name:`review`,description:`Title + criteria checklist + approval actions`,inputSchema:{type:`object`,properties:{title:{type:`string`,description:`Review title`},criteria:{type:`array`,description:`Checklist criteria items`,items:{type:`object`,properties:{label:{type:`string`},checked:{type:`boolean`}}}},annotations:{type:`array`,description:`Optional annotation items`,items:{type:`object`,properties:{label:{type:`string`},description:{type:`string`},severity:{type:`string`}}}},approval:{type:`object`,description:`Optional approval config`,properties:{prompt:{type:`string`},options:{type:`array`,items:{type:`object`,properties:{label:{type:`string`},value:{type:`string`}}}}}}},required:[`title`,`criteria`]},example:JSON.stringify({title:`Code Review`,criteria:[{label:`Tests included`,checked:!0},{label:`No regressions`,checked:!1}]}),expandsTo:`blocks: [heading, checklist] + actions: [approve, reject]`},{name:`explore`,description:`Title + heading per finding + code blocks`,inputSchema:{type:`object`,properties:{title:{type:`string`},findings:{type:`array`,items:{type:`object`,properties:{heading:{type:`string`},code:{type:`string`}}}}},required:[`title`,`findings`]},example:JSON.stringify({title:`Codebase Exploration`,findings:[{heading:`Auth flow`,code:`function login()`},{heading:`API routes`,code:`router.get("/api")`}]}),expandsTo:`blocks: [heading, code] per finding`},{name:`decision`,description:`Title + kv for recommendation + comparison blocks per option`,inputSchema:{type:`object`,properties:{title:{type:`string`},recommendation:{type:`string`},options:{type:`array`,items:{type:`object`,properties:{title:{type:`string`},items:{type:`array`,items:{type:`string`}}}}}},required:[`title`,`recommendation`]},example:JSON.stringify({title:`DB Choice`,recommendation:`PostgreSQL`,options:[{title:`Postgres`,items:[`ACID`,`Rich types`]},{title:`Mongo`,items:[`Schema-less`,`Horizontal`]}]}),expandsTo:`blocks: [heading, kv, comparison]`}];function n_(e,t){let n=K(`present`);hr(e,`present`,{title:n.title,description:`Render a ChannelSurface. Required: schemaVersion: 1, title. Supports blocks, template+data, and named presets. Actions use browser transport. Resources: aikit://schemas/channel-surface (schema+blocks), aikit://present/presets (presets), aikit://present/templates (viewers).`,inputSchema:$g,annotations:n.annotations,_meta:Jh(rg)},X(`present`,async(t,n)=>{let r=Yg(t);if(!r.ok)return Og(r.error.code,r.error.reason,void 0,`Present`);let i=kg(r.surface,n);if(!i.ok)return i.response;let a=e_(e);return await Ag(i.surface,{...i.options,preferBrowser:i.options.preferBrowser||a===`unsupported`})}));try{mr(e,`Present View`,rg,{description:`AI Kit present tool viewer`,_meta:Yh()},async()=>({contents:[{uri:rg,mimeType:fr,_meta:Yh(),text:ag()||`<html><body><p>No content generated yet. Call the present tool first.</p></body></html>`}]}))}catch{}try{e.registerResource(`present-templates`,`aikit://present/templates`,{description:`List all registered present viewer templates with their input schemas`},async()=>{let e=dm().map(e=>({id:e.id,label:e.label,description:e.description,transports:e.supportedTransports,inputSchema:e.inputSchema}));return{contents:[{uri:`aikit://present/templates`,mimeType:`application/json`,text:JSON.stringify(e,null,2)}]}})}catch{}try{e.registerResource(`present-presets`,`aikit://present/presets`,{description:`List all registered present presets with input schemas and examples`},async()=>({contents:[{uri:`aikit://present/presets`,mimeType:`application/json`,text:JSON.stringify(t_,null,2)}]}))}catch{}}const r_=L(`tools`);function i_(e,t){let n=new $n({structure:new tr,dependencies:new Xn,symbols:new nr,patterns:new er,entryPoints:new Qn,diagrams:new Zn}),r=K(`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:B.string().optional().describe(`Root path to analyze (defaults to workspace root)`),aspects:B.array(B.enum([`all`,`structure`,`dependencies`,`symbols`,`patterns`,`entry-points`,`diagrams`])).default([`all`]).describe(`Which analysis aspects to run`)},annotations:r.annotations},X(`produce_knowledge`,async({scope:e,aspects:r},i)=>{let a;try{a=Wc(i).createTask(`Produce Knowledge`,3),a.progress(0,`Running analyzers`);let o=e??`.`;r_.info(`Running knowledge production`,{rootPath:o,aspects:r});let s=await n.runExtraction(o,r);try{let e=t?.onboardDir??``;if(!e)throw r_.warn(`onboardDir not configured — skipping artifact persistence.`),Error(`skip`);N(e,{recursive:!0});let n=`<!-- Generated by produce_knowledge at ${new Date().toISOString()} -->\n\n`;for(let[t,r]of Object.entries(s))r&&typeof r==`string`&&me(F(e,`${t}.md`),n+r,`utf-8`);r_.info(`Knowledge persisted to .ai/context/`,{files:Object.keys(s).length})}catch(e){r_.warn(`Failed to persist knowledge to .ai/context/`,{error:R(e)})}a.progress(1,`Synthesizing results`);let c=n.buildSynthesisInstructions(s,r);return a.complete(`Knowledge production complete`),{content:[{type:`text`,text:c+`
|
|
2971
2972
|
|
|
2972
2973
|
---
|
|
2973
|
-
_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return a?.fail?.(`Production failed`),
|
|
2974
|
+
_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return a?.fail?.(`Production failed`),r_.error(`Knowledge production failed`,R(e)),Y(`INTERNAL`,`Knowledge production failed: ${e instanceof Error?e.message:String(e)}`)}}))}const a_=L(`tools`);function o_(e,t,n,r,i,a,o){let s=K(`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:B.boolean().default(!1).describe(`If true, force full re-index ignoring file hashes`),force:B.boolean().default(!1).describe(`If true, override smart indexing guard and run reindex anyway`)},annotations:s.annotations},X(`reindex`,async({full:e,force:s},c)=>{try{if(t.isIndexing)return{content:[{type:`text`,text:`## Reindex Already in Progress
|
|
2974
2975
|
|
|
2975
2976
|
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
|
|
2976
2977
|
|
|
@@ -2978,47 +2979,47 @@ Smart indexing (trickle mode) is enabled — files are automatically indexed as
|
|
|
2978
2979
|
|
|
2979
2980
|
**If the index is severely outdated**, use \`reindex({ force: true })\` to override.
|
|
2980
2981
|
|
|
2981
|
-
Use \`status({})\` to check smart indexing queue status.`}]};let l=
|
|
2982
|
+
Use \`status({})\` to check smart indexing queue status.`}]};let l=Wc(c).createTask(`Reindex`,1);l.progress(0,`Starting ${e?`full`:`incremental`} reindex`),a_.info(`Starting background re-index`,{mode:e?`full`:`incremental`});let u=e=>t=>{t.phase===`chunking`&&t.currentFile&&a_.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(a_.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(),a_.info(`FTS index rebuilt after reindex`)}catch(e){a_.warn(`FTS index rebuild failed`,R(e))}try{let e=await r.reindexAll();a_.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){a_.warn(`Curated re-index failed`,R(e))}if(a)try{await a.notifyAfterReindex()}catch(e){a_.warn(`Post-reindex resource notification failed`,R(e))}}).catch(e=>{l.fail(`Reindex failed: ${e instanceof Error?e.message:String(e)}`),a_.error(`Background reindex failed`,R(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 a_.error(`Reindex failed`,R(e)),Y(`INTERNAL`,`Reindex failed: ${e instanceof Error?e.message:String(e)}`)}}))}const s_=L(`tools`);function c_(e){let t=K(`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:B.enum([`list`,`clear`]).default(`list`).describe(`Action: "list" (default) to view entries, "clear" to wipe the log`),last:B.number().optional().describe(`Number of entries to return (default: 20, list only)`),tool:B.string().optional().describe(`Filter by tool name (list only)`),source:B.enum([`mcp`,`cli`]).optional().describe(`Filter by source: "mcp" or "cli" (list only)`),since:B.string().optional().describe(`ISO timestamp — only show entries after this time (list only)`)},annotations:t.annotations},X(`replay`,async({action:e,last:t,tool:n,source:r,since:i})=>{try{if(e===`clear`)return rn(),{content:[{type:`text`,text:`Replay log cleared.`}]};let a=an({last:t,tool:n,source:r,since:i});if(a.length===0)return{content:[{type:`text`,text:`No replay entries found. Activity is logged when tools are invoked via MCP or CLI.`}]};let o=a.map(e=>`${e.ts.split(`T`)[1]?.split(`.`)[0]??e.ts} ${e.status===`ok`?`✓`:`✗`} ${e.tool} (${e.durationMs}ms) [${e.source}]\n in: ${e.input}\n out: ${e.output}`);return on().catch(()=>{}),{content:[{type:`text`,text:`**Replay Log** (${a.length} entries)\n\n${o.join(`
|
|
2982
2983
|
|
|
2983
|
-
`)}`}]}}catch(e){return
|
|
2984
|
+
`)}`}]}}catch(e){return s_.error(`Replay failed`,R(e)),Y(`INTERNAL`,`Replay failed: ${e instanceof Error?e.message:String(e)}`)}}))}const l_=L(`tools`);function u_(e){let t=K(`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:B.enum([`list`,`restore`]).describe(`list: show restore points, restore: apply a restore point`),id:B.string().optional().describe(`Restore point ID (required for action=restore)`),limit:B.number().min(1).max(50).default(10).describe(`Max restore points to list`)},annotations:t.annotations},async({action:e,id:t,limit:n})=>{try{if(e===`list`){let e=Mt().slice(0,n);return e.length===0?{content:[{type:`text`,text:`No restore points found.`}]}:{content:[{type:`text`,text:`## Restore Points\n\n${e.map(e=>`- **${e.id}** (${e.timestamp}) — ${e.operation}: ${e.description} (${e.files.length} files)`).join(`
|
|
2984
2985
|
`)}`}]}}if(!t)throw Error(`id is required for restore action`);let r=await sn(t);return{content:[{type:`text`,text:`Restored ${r.length} files:\n${r.map(e=>`- \`${e}\``).join(`
|
|
2985
|
-
`)}`}]}}catch(e){return
|
|
2986
|
+
`)}`}]}}catch(e){return l_.error(`Restore failed`,R(e)),Y(`INTERNAL`,`Restore failed: ${e instanceof Error?e.message:String(e)}`)}})}const d_=/<\/?curated-context>/gi;function f_(e){return e.replace(d_,``)}function p_(e){return`<curated-context>\n${f_(e)}\n</curated-context>`}const m_=L(`tools`);function h_(e,t,n,r){b(e,t,n);let i=e.memoryMetaGet(t);if(!i)return;let a=g(i,{..._,...r});a&&(y(e,t,a),v(e,t,n))}function g_(e,t){let n=[],r=he(process.cwd());r&&n.push(`[project: ${r}]`);let i=t?gn(t,`__context_boost`):void 0;return i&&n.push(`[focus: ${i.value}]`),n.length===0?e:`${n.join(` `)} ${e}`}function __(e,t,n){return n?e:t===`curated`?e*1.2:e}function v_(e,t){return t?e:e.map(e=>({record:e.record,score:__(e.score,e.record.origin,t)})).sort((e,t)=>t.score-e.score)}function y_(e,t){let n=e?Math.floor(e/Math.max(1,t)):96;return Math.max(40,Math.min(160,n))}function b_(e,t){let n=e.origin===`curated`?p_(e.content):e.content,r=z(n,t);return{body:r,truncated:r!==n}}async function x_(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:dr(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 m_.warn(`ER fallback failed`,R(e)),{results:n,triggered:!0,cacheHit:a}}}function S_(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 C_(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 w_(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 T_(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&&!E_.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 E_=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 D_(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 Fn(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 O_(e,t,n,r,i,a,o,s,c,l,u){let d=K(`search`);e.registerTool(`search`,{title:d.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:Vs,inputSchema:{query:B.string().max(5e3).describe(`Natural language search query`),limit:B.number().min(1).max(20).default(5).describe(`Maximum results to return`),search_mode:B.enum([`hybrid`,`semantic`,`keyword`]).default(`hybrid`).describe(`Search strategy: hybrid (vector + FTS + RRF fusion, default), semantic (vector only), keyword (FTS only)`),content_type:B.enum(Ce).optional().describe(`Filter by content type`),source_type:B.enum(Oe).optional().describe(`Coarse filter: "source" (code only), "documentation" (md, curated), "test", "config". Overrides content_type if both set.`),origin:B.enum(De).optional().describe(`Filter by knowledge origin`),category:B.string().optional().describe(`Filter by category (e.g., decisions, patterns, conventions)`),tags:B.array(B.string()).optional().describe(`Filter by exact tag membership (any supplied tag may match)`),min_score:B.number().min(0).max(1).default(.25).describe(`Minimum similarity score`),graph_hops:B.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:B.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),dedup:B.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:B.array(B.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:d.annotations},async({query:e,limit:d,search_mode:f,content_type:p,source_type:m,origin:h,category:g,tags:_,min_score:v,graph_hops:y,max_tokens:b,dedup:x,workspaces:S})=>{let C=Date.now();try{let w={limit:d,minScore:v,contentType:p,sourceType:m,origin:h,category:g,tags:_},T,E=!1,D=!1,O=``,k=f!==`keyword`,ee=g_(e,s);if(f===`keyword`)T=await n.ftsSearch(e,w),T=T.slice(0,d);else if(f===`semantic`)try{let r=await t.embedQuery(ee);T=await n.search(r,w);let a=await x_(i,T[0]?.score??0,T,e,d);T=a.results,E=a.triggered,D=a.cacheHit}catch(t){k=!1,m_.warn(`Embedder unavailable in semantic mode, falling back to FTS`,R(t)),T=await n.ftsSearch(e,{...w,limit:d}),O=`> _⚠️ Semantic search unavailable (embedder recovering). Showing keyword results instead._
|
|
2986
2987
|
|
|
2987
|
-
`}else{let r=[],a=[];try{let i=await t.embedQuery(ee),o=n.coarseSearch,s=o?o.bind(n):n.search.bind(n);[r,a]=await Promise.all([s(i,{...w,limit:d*2}),n.ftsSearch(e,{...w,limit:d*2}).catch(()=>[])])}catch(t){k=!1,
|
|
2988
|
+
`}else{let r=[],a=[];try{let i=await t.embedQuery(ee),o=n.coarseSearch,s=o?o.bind(n):n.search.bind(n);[r,a]=await Promise.all([s(i,{...w,limit:d*2}),n.ftsSearch(e,{...w,limit:d*2}).catch(()=>[])])}catch(t){k=!1,m_.warn(`Embedder unavailable, falling back to FTS-only`,R(t)),a=await n.ftsSearch(e,{...w,limit:d*2}),O=`> _⚠️ Vector search unavailable (embedder recovering). Results from keyword search only._
|
|
2988
2989
|
|
|
2989
|
-
`}if(k?r.length===0&&a.length>0?(T=a.slice(0,d),O=` (FTS-only: vector index rebuilding)`):T=a.length===0&&r.length>0?r.slice(0,d):
|
|
2990
|
-
`)[0].slice(0,500);if(r&&r!==e){let i=f===`keyword`||!k?await n.ftsSearch(r,w):await n.search(await t.embedQuery(r),w);i.length>0&&(T=i,O=`> _Original query "${e}" returned 0 results. Auto-reformulated to "${r}"._\n\n`,
|
|
2990
|
+
`}if(k?r.length===0&&a.length>0?(T=a.slice(0,d),O=` (FTS-only: vector index rebuilding)`):T=a.length===0&&r.length>0?r.slice(0,d):S_(r,a).slice(0,d):T=a.slice(0,d),k){let t=await x_(i,r[0]?.score??0,T,e,d);T=t.results,E=t.triggered,D=t.cacheHit}}T=v_(T,h).slice(0,d),a&&a.recordSearch(e,E,D),T.length>1&&(T=C_(T,e)),T=w_(T);let te=``;if(S&&S.length>0){let n=wl(S,u);if(n.length>0){let{stores:r,closeAll:i}=await Tl(n);try{let i;i=f===`keyword`||!k?await Dl(r,e,{...w,limit:d}):await El(r,await t.embedQuery(e),{...w,limit:d});for(let e of i)T.push({record:{...e.record,sourcePath:`[${e.workspace}] ${e.record.sourcePath}`},score:e.score});T=T.sort((e,t)=>t.score-e.score).slice(0,d),te=` + ${n.length} workspace(s)`}finally{await i()}}}if(x===`file`&&T.length>1){let e=new Map;for(let t of T){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}]})}T=[...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(T.length>1){let e=T[0].score,t=Math.max(e*.4,.1);T=T.filter(e=>e.score>=t)}if(T.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(`
|
|
2991
|
+
`)[0].slice(0,500);if(r&&r!==e){let i=f===`keyword`||!k?await n.ftsSearch(r,w):await n.search(await t.embedQuery(r),w);i.length>0&&(T=i,O=`> _Original query "${e}" returned 0 results. Auto-reformulated to "${r}"._\n\n`,m_.debug(`Smart search fallback succeeded`,{originalQuery:e,altQuery:r,resultCount:i.length}))}}catch(e){m_.debug(`Smart search fallback failed`,{error:String(e)})}if(T.length===0){let t=et({text:`No results found for the given query.`,query:e,searchMode:f,limit:d,results:[],durationMs:Date.now()-C}),n=jl(t.summary);return{content:[{type:`text`,text:Ml(t.summary,n)}],isError:!t.ok,structuredContent:{...t.data??{results:[],totalResults:0,searchMode:f,query:e},ref:n}}}}let ne,re;if(y>0&&!r&&(re="> **Note:** `graph_hops` was set but no graph store is available. Graph augmentation skipped."),y>0&&r)try{let e=await bt(r,T.map(e=>({recordId:e.record.id,score:e.score,sourcePath:e.record.sourcePath})),{hops:y,maxPerHit:5});ne=new Map;for(let t of e)if(t.graphContext.nodes.length>0){let e=t.graphContext.nodes.slice(0,5).map(e=>` - **${e.name}** (${e.type})`).join(`
|
|
2991
2992
|
`),n=new Map;for(let e of t.graphContext.nodes)n.set(e.id,e.name);let r=t.graphContext.edges.slice(0,5).map(e=>` - ${n.get(e.fromId)??e.fromId} —[${e.type}]→ ${n.get(e.toId)??e.toId}`).join(`
|
|
2992
2993
|
`),i=[`- **Graph Context** (${y} hop${y>1?`s`:``}):`];e&&i.push(` Entities:\n${e}`),r&&i.push(` Relationships:\n${r}`),ne.set(t.recordId,i.join(`
|
|
2993
|
-
`))}}catch(e){
|
|
2994
|
-
`),{body:a,truncated:o}=
|
|
2994
|
+
`))}}catch(e){m_.warn(`Graph augmentation failed`,R(e)),re=`> **Note:** Graph augmentation failed. Results shown without graph context.`}let ie=Date.now();for(let e of T)if(e.record.origin===`curated`&&e.record.indexedAt){let t=ie-new Date(e.record.indexedAt).getTime(),n=Math.max(0,t/864e5);e.score*=.95**n}if(T.sort((e,t)=>t.score-e.score),T=Be(T),s)for(let e of T){if(e.record.origin!==`curated`)continue;let t=qd(e.record.sourcePath);t&&h_(s,t,c,l)}let ae=y_(b,T.length),oe=!1,A=T.map((e,t)=>{let n=e.record,r=`### Result ${t+1} (score: ${e.score.toFixed(3)})`,i=[`- **Source**: ${n.sourcePath}`,n.headingPath?`- **Section**: ${n.headingPath}`:null,`- **Type**: ${n.contentType}`,n.startLine?`- **Lines**: ${n.startLine}-${n.endLine}`:null,n.origin===`indexed`?null:`- **Origin**: ${n.origin}`,n.category?`- **Category**: ${n.category}`:null,n.tags?.length?`- **Tags**: ${n.tags.join(`, `)}`:null,ne?.get(n.id)??null].filter(Boolean).join(`
|
|
2995
|
+
`),{body:a,truncated:o}=b_(n,ae);return oe||=o,`${r}\n${i}\n\n${a}${o?`\n\n_Full content: use \`lookup\` on \`${n.sourcePath}\`._`:``}`}).join(`
|
|
2995
2996
|
|
|
2996
2997
|
---
|
|
2997
2998
|
|
|
2998
|
-
`),se=(f===`hybrid`?`hybrid (vector + keyword RRF)`:f===`keyword`?`keyword (FTS)`:`semantic (vector)`)+te,ce=Pg(T,e),j=ce.length>0?`\n_Distinctive terms: ${ce.map(e=>`\`${e}\``).join(`, `)}_`:``,M=await Ig(n,T),N=[];if(T.length===0)N.push("`reindex` — no results found, index may be stale"),N.push("`find` — try federated search with glob/regex");else{let e=T[0]?.record.sourcePath;e&&N.push(`\`lookup\` — see all chunks from \`${e}\``),N.push("`symbol` — resolve a specific symbol from the results"),N.push("`compact` — compress a result file for focused reading")}let P=[re?`${re}\n\n`:``,M?`${M}\n\n`:``,A,`\n\n---\n_Search mode: ${se} | ${T.length} results_${j}`,`\n_Next: ${N.join(` | `)}_`],le=O+P.join(``),ue=!1;if(b){let e=En(le,b);ue=e!==le,le=e}ue||=oe;let de=T.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}:{}})),fe=[re,M].filter(e=>!!e),pe=et({text:le,query:e,searchMode:f,limit:d,results:de,durationMs:Date.now()-C,truncated:ue,caveats:fe}),me=Al(pe.summary),he=new Set,ge=[];for(let e of T){if(e.record.origin!==`curated`||e.record.sourcePath.startsWith(`[`))continue;let t=Kd(e.record.sourcePath);if(!t)continue;let n=Wd(t,e.record.headingPath??t);n&&!he.has(n.uri)&&(he.add(n.uri),ge.push(n))}return{content:[{type:`text`,text:jl(pe.summary,me)},...ge],isError:!pe.ok,structuredContent:{...pe.data??{results:[],totalResults:0,searchMode:f,query:e},ref:me}}}catch(t){Cg.error(`Search failed`,R(t));let n=et({text:`Search failed: ${t instanceof Error?t.message:String(t)}`,query:e??``,searchMode:f??`hybrid`,limit:d,results:[],durationMs:Date.now()-C}),r=Al(n.summary);return{content:[{type:`text`,text:jl(n.summary,r)}],structuredContent:{...n.data??{results:[],totalResults:0,searchMode:f??`hybrid`,query:e??``},ref:r}}}})}const Rg=L(`tools`);function zg(e,t,n){let r=G(`session_digest`);e.registerTool(`session_digest`,{title:r.title,description:`Compress the current session's tool trajectory into a focused digest. Aggregates replay log, stash state, and checkpoints. Supports deterministic and LLM-assisted (sampling) modes with configurable token budget.`,inputSchema:{scope:z.enum([`tools`,`stash`,`all`]).default(`all`).describe(`What to include: tools (replay only), stash (stash + checkpoints only), or all`),since:z.string().optional().describe(`ISO timestamp — only include activity after this time`),last:z.number().min(1).max(500).optional().describe(`Max replay entries to consider (default: 50)`),focus:z.string().optional().describe(`Focus query — prioritize entries matching this topic`),mode:z.enum([`deterministic`,`sampling`]).default(`deterministic`).describe(`Summary mode: deterministic (fast, template-based) or sampling (LLM-assisted, richer)`),token_budget:z.number().min(100).max(8e3).default(2e3).describe(`Target token budget for the digest output`),persist:z.boolean().default(!0).describe(`Auto-save digest to stash for crash recovery`)},annotations:r.annotations},Y(`session_digest`,async({scope:e,since:r,last:i,focus:a,mode:o,token_budget:s,persist:c})=>{try{let l={scope:e,since:r,last:i,focus:a,mode:o,tokenBudget:s,persist:c},u=t?{stateStore:t}:void 0;return{content:[{type:`text`,text:(o===`sampling`&&n?.available?await pn(l,async(e,t,r)=>(await n.createMessage({prompt:e,systemPrompt:t,maxTokens:r})).text,u):fn(l,u)).digest}]}}catch(e){return Rg.error(`Session digest failed`,R(e)),J(`INTERNAL`,`Session digest failed: ${e instanceof Error?e.message:String(e)}`)}}))}const Bg=1e4,Vg={defaultTtlSeconds:300,defaultLeaseTtlMinutes:10,globalEnabled:!1};function Hg(e){return e??Vg}function Ug(e,t){let n=e.trim();if(!n)throw Error(`${t} is required`);return n}function Wg(e,t,n){let r=Ug(e,t);if(r.length>n)throw Error(`${t} exceeds max length of ${n}`);return r}function Gg(e,t){if(!Number.isFinite(e)||e<=0)throw Error(`${t} must be greater than 0`);return Math.trunc(e)}function Kg(e,t=!1,n){Ug(e,`workspace`);let r=Hg(n);if(!t)return e;if(!r.globalEnabled)throw Error(`Global signal scope is disabled`);return`__global__`}function qg(e,t,n){let r=Hg(n),i=Kg(t.workspace,t.global??!1,r),a=Wg(t.key,`key`,500),o=Wg(t.value,`value`,Bg),s=t.agent?Wg(t.agent,`agent`,500):void 0,c=Gg(t.ttlSeconds??r.defaultTtlSeconds,`ttlSeconds`);return e.signalPost(i,a,o,s,c)}function Jg(e,t,n){let r=Ug(t,`workspace`),i=Wg(n,`key`,500);return e.signalGet(r,i)}function Yg(e,t){let n=Ug(t,`workspace`);return e.signalList(n)}function Xg(e,t,n){let r=Ug(t,`workspace`),i=n===void 0?void 0:Wg(n,`key`,500);return e.signalClear(r,i)}function Zg(e,t,n){let r=Hg(n),i=Wg(t.resource,`resource`,500),a=Wg(t.holder,`holder`,500),o=Ug(t.workspace,`workspace`),s=t.intent?Wg(t.intent,`intent`,Bg):void 0,c=Gg(t.ttlMinutes??r.defaultLeaseTtlMinutes,`ttlMinutes`);if(c>60)throw Error(`ttlMinutes exceeds max of 60`);let l=e.leaseAcquire(i,a,o,s,c),u=e.leaseGet(i,o);return u?{acquired:l,holder:u.holder,expiresAt:u.expiresAt}:{acquired:l}}function Qg(e,t,n,r){let i=Ug(t,`workspace`),a=Wg(n,`resource`,500),o=Wg(r,`holder`,500);return e.leaseRelease(a,o,i)}function $g(e,t){let n=Ug(t,`workspace`);return e.leaseList(n)}const e_=L(`tools:signal`);function t_(e){return JSON.stringify(e,null,2)}function n_(e,t,n){let r=G(`signal`),i={...Vg,...n};e.registerTool(`signal`,{title:r.title,description:`Inter-agent signaling and lease coordination`,inputSchema:{action:z.enum([`post`,`get`,`list`,`clear`,`lease`,`unlease`,`leases`]).describe(`Signal action to perform`),workspace:z.string().describe(`Workspace identifier (required)`),key:z.string().optional().describe(`Signal key (for post/get/clear)`),value:z.string().optional().describe(`Signal value (for post)`),agent:z.string().optional().describe(`Agent identifier`),resource:z.string().optional().describe(`Resource path (for lease/unlease)`),holder:z.string().optional().describe(`Lease holder ID (for lease/unlease)`),intent:z.string().optional().describe(`What the holder plans to do`),ttl:z.number().optional().describe(`TTL (seconds for signals, minutes for leases)`),global:z.boolean().optional().describe(`Use global scope (default: false)`)},annotations:r.annotations},Y(`signal`,async({action:e,workspace:n,key:r,value:a,agent:o,resource:s,holder:c,intent:l,ttl:u,global:d})=>{try{switch(e){case`post`:{if(!r||a===void 0)throw Error(`key and value are required for post`);let e=qg(t,{workspace:n,key:r,value:a,agent:o,ttlSeconds:u,global:d},i);return{content:[{type:`text`,text:t_({id:e})}],structuredContent:{id:e}}}case`get`:{if(!r)throw Error(`key is required for get`);let e=Jg(t,Kg(n,d??!1,i),r);return{content:[{type:`text`,text:e.length===0?`[]`:t_(e)}],structuredContent:{signals:e}}}case`list`:{let e=Yg(t,Kg(n,d??!1,i));return{content:[{type:`text`,text:e.length===0?`[]`:t_(e)}],structuredContent:{signals:e}}}case`clear`:{let e=Xg(t,Kg(n,d??!1,i),r);return{content:[{type:`text`,text:t_({cleared:e})}],structuredContent:{cleared:e}}}case`lease`:{if(!s||!c)throw Error(`resource and holder are required for lease`);let e=Zg(t,{resource:s,holder:c,workspace:n,intent:l,ttlMinutes:u},i);return{content:[{type:`text`,text:t_(e)}],structuredContent:e}}case`unlease`:{if(!s||!c)throw Error(`resource and holder are required for unlease`);let e=Qg(t,n,s,c);return{content:[{type:`text`,text:t_({released:e})}],structuredContent:{released:e}}}case`leases`:{let e=$g(t,n);return{content:[{type:`text`,text:e.length===0?`[]`:t_(e)}],structuredContent:{leases:e}}}}}catch(e){return e_.error(`Signal operation failed`,R(e)),J(`INTERNAL`,`Signal operation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function r_(e,t){return e.length<=t?e:e.slice(0,t)}function i_(e){if(!e)return 0;let t=Date.parse(e);return Number.isNaN(t)?0:t}async function a_(e,t,n=d){if(!e||!t)return null;try{let[r,i,o]=await Promise.all([e.list({category:`lessons`}),e.list({category:`conventions`}),e.list({category:`session`})]),s=r.filter(e=>e.tags.includes(`lesson`)).map(e=>{let r=t.memoryMetaGet(e.path);return!r||r.supersededBy!=null?null:{entry:e,confidence:c(r.confidence,r.lastAccessedAt,r.createdAt,n)}}).filter(e=>e!==null).sort((e,t)=>t.confidence-e.confidence).slice(0,3);return{lessons:await Promise.all(s.map(async({entry:t,confidence:n})=>{let r=a((await e.read(t.path)).content);return{title:t.title,insight:r_(r.insight??``,150),confidence:n}})),conventions:i.map(e=>({entry:e,lastAccessedAt:t.memoryMetaGet(e.path)?.lastAccessedAt??null})).sort((e,t)=>i_(t.lastAccessedAt)-i_(e.lastAccessedAt)).slice(0,2).map(({entry:e})=>({title:e.title,preview:e.contentPreview})),checkpoint:o.map(e=>({entry:e,lastAccessedAt:t.memoryMetaGet(e.path)?.lastAccessedAt??null})).sort((e,t)=>i_(t.lastAccessedAt)-i_(e.lastAccessedAt)).map(({entry:e})=>r_(e.contentPreview,200))[0]??null}}catch{return null}}const o_=L(`tools`),s_=14400*1e3,c_={includePrelude:z.boolean().default(!1).describe(`Include session prelude with top lessons, conventions, and last checkpoint`)};function l_(e,t,n,r=15e3){let i,a=new Promise(e=>{i=setTimeout(()=>{o_.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),o_.warn(`Status sub-operation "${n}" failed: ${e instanceof Error?e.message:String(e)}`),{value:t,timedOut:!1})),a])}function u_(e){return e.onboarded?e.indexStale?{kind:`reindex`,reason:`Index stale. Run reindex() to update.`}:e.contextPressure>70?{kind:`handoff`,reason:`Context pressure high. Consider session handoff.`}:{kind:`proceed`,reason:`Ready to work.`}:{kind:`onboard`,reason:`Index not initialized. Run onboard({ path: "." }) first.`}}function d_(){let e=ar.get(),t=ir.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(`
|
|
2999
|
+
`),se=(f===`hybrid`?`hybrid (vector + keyword RRF)`:f===`keyword`?`keyword (FTS)`:`semantic (vector)`)+te,ce=T_(T,e),j=ce.length>0?`\n_Distinctive terms: ${ce.map(e=>`\`${e}\``).join(`, `)}_`:``,M=await D_(n,T),N=[];if(T.length===0)N.push("`reindex` — no results found, index may be stale"),N.push("`find` — try federated search with glob/regex");else{let e=T[0]?.record.sourcePath;e&&N.push(`\`lookup\` — see all chunks from \`${e}\``),N.push("`symbol` — resolve a specific symbol from the results"),N.push("`compact` — compress a result file for focused reading")}let P=[re?`${re}\n\n`:``,M?`${M}\n\n`:``,A,`\n\n---\n_Search mode: ${se} | ${T.length} results_${j}`,`\n_Next: ${N.join(` | `)}_`],le=O+P.join(``),ue=!1;if(b){let e=z(le,b);ue=e!==le,le=e}ue||=oe;let de=T.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}:{}})),fe=[re,M].filter(e=>!!e),pe=et({text:le,query:e,searchMode:f,limit:d,results:de,durationMs:Date.now()-C,truncated:ue,caveats:fe}),me=jl(pe.summary),he=new Set,ge=[];for(let e of T){if(e.record.origin!==`curated`||e.record.sourcePath.startsWith(`[`))continue;let t=qd(e.record.sourcePath);if(!t)continue;let n=Gd(t,e.record.headingPath??t);n&&!he.has(n.uri)&&(he.add(n.uri),ge.push(n))}return{content:[{type:`text`,text:Ml(pe.summary,me)},...ge],isError:!pe.ok,structuredContent:{...pe.data??{results:[],totalResults:0,searchMode:f,query:e},ref:me}}}catch(t){m_.error(`Search failed`,R(t));let n=et({text:`Search failed: ${t instanceof Error?t.message:String(t)}`,query:e??``,searchMode:f??`hybrid`,limit:d,results:[],durationMs:Date.now()-C}),r=jl(n.summary);return{content:[{type:`text`,text:Ml(n.summary,r)}],structuredContent:{...n.data??{results:[],totalResults:0,searchMode:f??`hybrid`,query:e??``},ref:r}}}})}const k_=L(`tools`);function A_(e,t,n){let r=K(`session_digest`);e.registerTool(`session_digest`,{title:r.title,description:`Compress the current session's tool trajectory into a focused digest. Aggregates replay log, stash state, and checkpoints. Supports deterministic and LLM-assisted (sampling) modes with configurable token budget.`,inputSchema:{scope:B.enum([`tools`,`stash`,`all`]).default(`all`).describe(`What to include: tools (replay only), stash (stash + checkpoints only), or all`),since:B.string().optional().describe(`ISO timestamp — only include activity after this time`),last:B.number().min(1).max(500).optional().describe(`Max replay entries to consider (default: 50)`),focus:B.string().optional().describe(`Focus query — prioritize entries matching this topic`),mode:B.enum([`deterministic`,`sampling`]).default(`deterministic`).describe(`Summary mode: deterministic (fast, template-based) or sampling (LLM-assisted, richer)`),token_budget:B.number().min(100).max(8e3).default(2e3).describe(`Target token budget for the digest output`),persist:B.boolean().default(!0).describe(`Auto-save digest to stash for crash recovery`)},annotations:r.annotations},X(`session_digest`,async({scope:e,since:r,last:i,focus:a,mode:o,token_budget:s,persist:c})=>{try{let l={scope:e,since:r,last:i,focus:a,mode:o,tokenBudget:s,persist:c},u=t?{stateStore:t}:void 0;return{content:[{type:`text`,text:(o===`sampling`&&n?.available?await pn(l,async(e,t,r)=>(await n.createMessage({prompt:e,systemPrompt:t,maxTokens:r})).text,u):fn(l,u)).digest}]}}catch(e){return k_.error(`Session digest failed`,R(e)),Y(`INTERNAL`,`Session digest failed: ${e instanceof Error?e.message:String(e)}`)}}))}const j_=1e4,M_={defaultTtlSeconds:300,defaultLeaseTtlMinutes:10,globalEnabled:!1};function N_(e){return e??M_}function P_(e,t){let n=e.trim();if(!n)throw Error(`${t} is required`);return n}function F_(e,t,n){let r=P_(e,t);if(r.length>n)throw Error(`${t} exceeds max length of ${n}`);return r}function I_(e,t){if(!Number.isFinite(e)||e<=0)throw Error(`${t} must be greater than 0`);return Math.trunc(e)}function L_(e,t=!1,n){P_(e,`workspace`);let r=N_(n);if(!t)return e;if(!r.globalEnabled)throw Error(`Global signal scope is disabled`);return`__global__`}function R_(e,t,n){let r=N_(n),i=L_(t.workspace,t.global??!1,r),a=F_(t.key,`key`,500),o=F_(t.value,`value`,j_),s=t.agent?F_(t.agent,`agent`,500):void 0,c=I_(t.ttlSeconds??r.defaultTtlSeconds,`ttlSeconds`);return e.signalPost(i,a,o,s,c)}function z_(e,t,n){let r=P_(t,`workspace`),i=F_(n,`key`,500);return e.signalGet(r,i)}function B_(e,t){let n=P_(t,`workspace`);return e.signalList(n)}function V_(e,t,n){let r=P_(t,`workspace`),i=n===void 0?void 0:F_(n,`key`,500);return e.signalClear(r,i)}function H_(e,t,n){let r=N_(n),i=F_(t.resource,`resource`,500),a=F_(t.holder,`holder`,500),o=P_(t.workspace,`workspace`),s=t.intent?F_(t.intent,`intent`,j_):void 0,c=I_(t.ttlMinutes??r.defaultLeaseTtlMinutes,`ttlMinutes`);if(c>60)throw Error(`ttlMinutes exceeds max of 60`);let l=e.leaseAcquire(i,a,o,s,c),u=e.leaseGet(i,o);return u?{acquired:l,holder:u.holder,expiresAt:u.expiresAt}:{acquired:l}}function U_(e,t,n,r){let i=P_(t,`workspace`),a=F_(n,`resource`,500),o=F_(r,`holder`,500);return e.leaseRelease(a,o,i)}function W_(e,t){let n=P_(t,`workspace`);return e.leaseList(n)}const G_=L(`tools:signal`);function K_(e){return JSON.stringify(e,null,2)}function q_(e,t,n){let r=K(`signal`),i={...M_,...n};e.registerTool(`signal`,{title:r.title,description:`Inter-agent signaling and lease coordination`,inputSchema:{action:B.enum([`post`,`get`,`list`,`clear`,`lease`,`unlease`,`leases`]).describe(`Signal action to perform`),workspace:B.string().describe(`Workspace identifier (required)`),key:B.string().optional().describe(`Signal key (for post/get/clear)`),value:B.string().optional().describe(`Signal value (for post)`),agent:B.string().optional().describe(`Agent identifier`),resource:B.string().optional().describe(`Resource path (for lease/unlease)`),holder:B.string().optional().describe(`Lease holder ID (for lease/unlease)`),intent:B.string().optional().describe(`What the holder plans to do`),ttl:B.number().optional().describe(`TTL (seconds for signals, minutes for leases)`),global:B.boolean().optional().describe(`Use global scope (default: false)`)},annotations:r.annotations},X(`signal`,async({action:e,workspace:n,key:r,value:a,agent:o,resource:s,holder:c,intent:l,ttl:u,global:d})=>{try{switch(e){case`post`:{if(!r||a===void 0)throw Error(`key and value are required for post`);let e=R_(t,{workspace:n,key:r,value:a,agent:o,ttlSeconds:u,global:d},i);return{content:[{type:`text`,text:K_({id:e})}],structuredContent:{id:e}}}case`get`:{if(!r)throw Error(`key is required for get`);let e=z_(t,L_(n,d??!1,i),r);return{content:[{type:`text`,text:e.length===0?`[]`:K_(e)}],structuredContent:{signals:e}}}case`list`:{let e=B_(t,L_(n,d??!1,i));return{content:[{type:`text`,text:e.length===0?`[]`:K_(e)}],structuredContent:{signals:e}}}case`clear`:{let e=V_(t,L_(n,d??!1,i),r);return{content:[{type:`text`,text:K_({cleared:e})}],structuredContent:{cleared:e}}}case`lease`:{if(!s||!c)throw Error(`resource and holder are required for lease`);let e=H_(t,{resource:s,holder:c,workspace:n,intent:l,ttlMinutes:u},i);return{content:[{type:`text`,text:K_(e)}],structuredContent:e}}case`unlease`:{if(!s||!c)throw Error(`resource and holder are required for unlease`);let e=U_(t,n,s,c);return{content:[{type:`text`,text:K_({released:e})}],structuredContent:{released:e}}}case`leases`:{let e=W_(t,n);return{content:[{type:`text`,text:e.length===0?`[]`:K_(e)}],structuredContent:{leases:e}}}}}catch(e){return G_.error(`Signal operation failed`,R(e)),Y(`INTERNAL`,`Signal operation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function J_(e,t){return e.length<=t?e:e.slice(0,t)}function Y_(e){if(!e)return 0;let t=Date.parse(e);return Number.isNaN(t)?0:t}async function X_(e,t,n=d){if(!e||!t)return null;try{let[r,i,o]=await Promise.all([e.list({category:`lessons`,limit:200,orderBy:`updated`,order:`desc`}),e.list({category:`conventions`,limit:200,orderBy:`updated`,order:`desc`}),e.list({category:`session`,limit:200,orderBy:`updated`,order:`desc`})]),s=r.filter(e=>e.tags.includes(`lesson`)).map(e=>{let r=t.memoryMetaGet(e.path);return!r||r.supersededBy!=null?null:{entry:e,confidence:c(r.confidence,r.lastAccessedAt,r.createdAt,n)}}).filter(e=>e!==null).sort((e,t)=>t.confidence-e.confidence).slice(0,3);return{lessons:await Promise.all(s.map(async({entry:t,confidence:n})=>{let r=a((await e.read(t.path)).content);return{title:t.title,insight:J_(r.insight??``,150),confidence:n}})),conventions:i.map(e=>({entry:e,lastAccessedAt:t.memoryMetaGet(e.path)?.lastAccessedAt??null})).sort((e,t)=>Y_(t.lastAccessedAt)-Y_(e.lastAccessedAt)).slice(0,2).map(({entry:e})=>({title:e.title,preview:e.contentPreview})),checkpoint:o.map(e=>({entry:e,lastAccessedAt:t.memoryMetaGet(e.path)?.lastAccessedAt??null})).sort((e,t)=>Y_(t.lastAccessedAt)-Y_(e.lastAccessedAt)).map(({entry:e})=>J_(e.contentPreview,200))[0]??null}}catch{return null}}const Z_=L(`tools`),Q_=14400*1e3,$_={includePrelude:B.boolean().default(!1).describe(`Include session prelude with top lessons, conventions, and last checkpoint`)};function ev(e,t,n,r=15e3){let i,a=new Promise(e=>{i=setTimeout(()=>{Z_.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),Z_.warn(`Status sub-operation "${n}" failed: ${e instanceof Error?e.message:String(e)}`),{value:t,timedOut:!1})),a])}function tv(e){return e.onboarded?e.indexStale?{kind:`reindex`,reason:`Index stale. Run reindex() to update.`}:e.contextPressure>70?{kind:`handoff`,reason:`Context pressure high. Consider session handoff.`}:{kind:`proceed`,reason:`Ready to work.`}:{kind:`onboard`,reason:`Index not initialized. Run onboard({ path: "." }) first.`}}function nv(){let e=ir.get(),t=rr.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(`
|
|
2999
3000
|
`):` 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(`
|
|
3000
|
-
`)}const
|
|
3001
|
-
`)}],structuredContent:o}}))}function
|
|
3002
|
-
`),le=e||D>=
|
|
3003
|
-
`)};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
|
|
3004
|
-
|
|
3005
|
-
`);return c===o.length?
|
|
3006
|
-
`)}]}}catch(e){return
|
|
3007
|
-
`)}]}}))}function
|
|
3001
|
+
`)}const rv=5*6e4;let iv=null,av=null;function ov(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 sv(){let e=Date.now();if(iv&&e-iv.ts<rv)return iv.value;try{let t=I(Rn(),`.copilot`,`.aikit-scaffold.json`);if(!M(t))return iv={value:null,ts:e},null;let n=JSON.parse(P(t,`utf-8`)).version??null;return iv={value:n,ts:e},n}catch{return iv={value:null,ts:e},null}}function cv(){let e=Date.now();if(av&&e-av.ts<rv)return av.value;try{let t=I(process.cwd(),`.github`,`.aikit-scaffold.json`);if(!M(t))return av={value:null,ts:e},null;let n=JSON.parse(P(t,`utf-8`)).version??null;return av={value:n,ts:e},n}catch{return av={value:null,ts:e},null}}function lv(e){let t=K(`status`);e.registerTool(`status`,{title:t.title,description:`Get the current status and statistics of the AI Kit index.`,inputSchema:$_,annotations:t.annotations},X(`status`,async()=>{let e=ie(),t=sv(),n=cv(),r=t!=null&&t!==e,i=n!=null&&n!==e,a=[`## AI Kit Status`,``,`⏳ **AI Kit is initializing** — index stats will be available shortly.`,``,`### Runtime`,`- **Tree-sitter (WASM)**: ${ir.get()?`✅ Available (AST analysis)`:`⚠ Unavailable (regex fallback)`}`,``,`### Version`,`- **Server**: ${e}`,`- **Scaffold (user)**: ${t??`not installed`}`,`- **Scaffold (workspace)**: ${n??`not installed`}`];if(r||i){let o=ae(),s=[];r&&s.push(`user scaffold v${t}`),i&&s.push(`workspace scaffold v${n}`);let c=s.join(`, `);o.state===`success`?a.push(``,`### ✅ Upgrade Applied`,`- Server v${e} — ${c} auto-upgraded successfully.`,`- _Restart the MCP server to use the updated version._`):o.state===`pending`?a.push(``,`### ⏳ Upgrade In Progress`,`- Server v${e} ≠ ${c}`,`- Auto-upgrade is running in the background…`):o.state===`failed`?(re(),a.push(``,`### ⬆ Upgrade Available (auto-upgrade failed, retrying)`,`- Server v${e} ≠ ${c}`,`- Error: ${o.error??`unknown`}`)):(re(),a.push(``,`### ⬆ Upgrade Available`,`- Server v${e} ≠ ${c}`,`- Auto-upgrade triggered — check again shortly.`))}let o={totalRecords:0,totalFiles:0,lastIndexedAt:null,onboarded:!1,onboardDir:``,contentTypes:{},wasmAvailable:!!ir.get(),wasmDiagnostics:rr.get(),graphStats:null,curatedCount:0,serverVersion:e,scaffoldVersion:t??null,workspaceScaffoldVersion:n??null,upgradeAvailable:r||i,contextPressure:0,nextAction:tv({onboarded:!1,indexStale:!1,contextPressure:0})};return{content:[{type:`text`,text:a.join(`
|
|
3002
|
+
`)}],structuredContent:o}}))}function uv(e,t,n,r,i,a,o,s,c){let l=K(`status`);e.registerTool(`status`,{title:l.title,description:`Get the current status and statistics of the AI Kit index.`,inputSchema:$_,annotations:l.annotations},X(`status`,async({includePrelude:e=!1})=>{let l=[];try{let[u,d]=await Promise.all([ev(t.getStats(),{totalRecords:0,totalFiles:0,lastIndexedAt:null,contentTypeBreakdown:{}},`store.getStats`),ev(t.listSourcePaths(),[],`store.listSourcePaths`)]),f=u.value;u.timedOut&&l.push(`⚠ Index stats timed out — values may be incomplete`);let p=d.value;d.timedOut&&l.push(`⚠ File listing timed out`);let m=null,h=0,g=[`## AI Kit Status`,``,`- **Total Records**: ${f.totalRecords}`,`- **Total Files**: ${f.totalFiles}`,`- **Last Indexed**: ${f.lastIndexedAt??`Never`}`,``,`### Content Types`,...Object.entries(f.contentTypeBreakdown).map(([e,t])=>`- ${e}: ${t}`),``,`### Indexed Files`,...p.slice(0,50).map(e=>`- ${e}`),p.length>50?`\n... and ${p.length-50} more files`:``];if(n)try{let e=await ev(n.getStats(),{nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}},`graphStore.getStats`);if(e.timedOut)l.push(`⚠ Graph stats timed out`),g.push(``,`### Knowledge Graph`,`- Graph stats timed out`);else{let t=e.value;m={nodes:t.nodeCount,edges:t.edgeCount},g.push(``,`### Knowledge Graph`,`- **Nodes**: ${t.nodeCount}`,`- **Edges**: ${t.edgeCount}`,...Object.entries(t.nodeTypes).map(([e,t])=>` - ${e}: ${t}`));try{let e=await ev(n.validate(),{valid:!0,danglingEdges:[],orphanNodes:[],stats:{nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}}},`graphStore.validate`);if(!e.timedOut){let t=e.value;t.valid||g.push(`- **⚠ Integrity Issues**: ${t.danglingEdges.length} dangling edges`),t.orphanNodes.length>0&&g.push(`- **Orphan nodes**: ${t.orphanNodes.length}`)}}catch{}}}catch{g.push(``,`### Knowledge Graph`,`- Graph store unavailable`)}let _=a?.onboardDir??``,v=M(_),y=i?.onboardComplete||v;if(g.push(``,`### Onboard Status`,y?`- ✅ Complete${i?.onboardTimestamp?` (last: ${i.onboardTimestamp})`:``}`:'- ❌ Not run — call `onboard({ path: "." })` to analyze the codebase',`- **Onboard Directory**: \`${_}\``),r)try{let e=await ev(r.count(),0,`curated.count`);e.timedOut?(l.push(`⚠ Curated knowledge count timed out`),g.push(``,`### Curated Knowledge`,`- Listing timed out`)):(h=e.value,g.push(``,`### Curated Knowledge`,h>0?`- ${h} entries`:'- Empty — use `knowledge({ action: "remember", ... })` to persist decisions'))}catch{g.push(``,`### Curated Knowledge`,`- Unable to read curated entries`)}let b=ov(f.totalRecords,m?.nodes??0,m?.edges??0,h),x=f.lastIndexedAt?new Date(f.lastIndexedAt).getTime():0,S=x>0?Date.now()-x:1/0,C=tv({onboarded:y,indexStale:y&&S>1440*60*1e3,contextPressure:b});g.push(``),g.push(`## 📊 Context Pressure: ${b}/100`),b>=80?g.push(`⚠️ High pressure — consider pruning stale entries or compacting context.`):b>=50?g.push(`ℹ️ Moderate pressure — AI Kit memory is well-populated.`):g.push(`✅ Low pressure — plenty of headroom for more content.`);let w=0;if(f.lastIndexedAt){w=new Date(f.lastIndexedAt).getTime();let e=(Date.now()-w)/(1e3*60*60);g.push(``,`### Index Freshness`,e>24?o===`smart`?`- ⚠ Last indexed ${Math.floor(e)}h ago — smart indexing will refresh automatically`:`- ⚠ Last indexed ${Math.floor(e)}h ago — may be stale. Run \`reindex({})\``:`- ✅ Last indexed ${e<1?`less than 1h`:`${Math.floor(e)}h`} ago`)}g.push(``,`### Next Action`,`- **${C.kind}**: ${C.reason}`);let T=null,E=t;if(typeof E.getDiagnostics==`function`)try{let e=E.getDiagnostics();T={adapterType:e.adapterType,vectorSearchEnabled:e.vectorSearchEnabled,ftsEnabled:e.ftsEnabled,degradedMode:e.degradedMode,dbPath:e.dbPath,dbSizeBytes:e.dbSizeBytes,embeddingDim:e.embeddingDim,vectorDtype:e.vectorDtype},g.push(``,`### Storage`,`- **Backend**: ${a?.store?.backend??`unknown`}`,`- **Adapter**: ${T.adapterType}`,`- **Vector search**: ${T.vectorSearchEnabled?`✅ enabled`:`⚠ disabled (FTS-only fallback)`}`,T.dbPath?`- **DB**: ${T.dbPath}`:``,T.dbSizeBytes==null?``:`- **DB size**: ${(T.dbSizeBytes/1024/1024).toFixed(2)} MB`,`- **Embedding dim**: ${T.embeddingDim}`,`- **Vector dtype**: ${T.vectorDtype}`)}catch{}if(o===`smart`)if(g.push(``,`### Smart Indexing`),s){let e=s();e?g.push(`- **Mode**: Smart (trickle)`,`- **Status**: ${e.running?`✅ Running`:`⏸ Stopped`}`,`- **Queue**: ${e.queueSize} files pending`,`- **Changed files**: ${e.changedFilesSize} detected`,`- **Interval**: ${Math.round(e.intervalMs/1e3)}s per batch of ${e.batchSize}`):g.push(`- **Mode**: Smart (trickle)`,`- **Status**: scheduler state unavailable (init may have failed)`)}else g.push(`- **Mode**: Smart (trickle) — scheduler state unavailable`);let D=0;{try{let e=a?.stateDir?F(a.stateDir,`stash`):null;if(e&&M(e)){let t=fe(e).mtimeMs;t>w&&(w=t)}}catch{}let e=[];if(r)try{let t=h>0?await r.list({limit:5,orderBy:`updated`,order:`desc`}):[];for(let e of t){let t=new Date(e.updated||e.created).getTime();t>w&&(w=t)}e.push(...t)}catch{}if(D=w>0?Date.now()-w:0,D>=Q_){let t=Math.floor(D/36e5);if(g.push(``,`### 🌅 Session Briefing`,`_${t}+ hours since last activity — here's what to pick up:_`,``),e.length>0){g.push(`**Recent decisions/notes:**`);for(let t of e)g.push(`- **${t.title}** (${t.category??`note`}) — ${(t.contentPreview??``).slice(0,80)}…`)}g.push(``,`**Suggested next steps:**`,'- `search({ query: "SESSION CHECKPOINT", origin: "curated" })` — find your last checkpoint',"- `restore({})` — resume from a saved checkpoint",'- `knowledge({ action: "list" })` — browse all stored knowledge')}}g.push(``,`### Runtime`,nv());let O=Ee.instance().getAll(),k=O.filter(e=>e.status!==`healthy`);if(k.length>0){g.push(``,`### ⚠️ Subsystem Health`);for(let e of k){let t=Math.round((Date.now()-e.since)/1e3);g.push(`- **${e.name}**: ${e.status} (${t}s ago${e.reason?` — ${e.reason}`:``})`)}}else O.length>0&&g.push(``,`### ✅ Subsystem Health`,`- All ${O.length} subsystems healthy`);let ee=we.getAll();if(ee.size>0){g.push(``,`### 🔌 Circuit Breakers`);for(let[e,t]of ee){let n=t.getState(),r=`- **${e}**: ${n===`closed`?`🟢`:n===`open`?`🔴`:`🟡`} ${n}`;if(n===`open`){let e=t.remainingCooldownMs();r+=` (recovery in ${Math.ceil(e/1e3)}s)`}g.push(r)}}let te=sv(),ne=cv(),oe=ie(),A=te!=null&&te!==oe,se=ne!=null&&ne!==oe;if(A||se){let e=ae(),t=[];A&&t.push(`user scaffold v${te}`),se&&t.push(`workspace scaffold v${ne}`);let n=t.join(`, `);e.state===`success`?g.push(``,`### ✅ Upgrade Applied`,`- Server v${oe} — ${n} auto-upgraded successfully.`,`- _Restart the MCP server to use the updated version._`):e.state===`pending`?g.push(``,`### ⏳ Upgrade In Progress`,`- Server v${oe} ≠ ${n}`,`- Auto-upgrade is running in the background…`):e.state===`failed`?(re(),g.push(``,`### ⬆ Upgrade Available (auto-upgrade failed, retrying)`,`- Server v${oe} ≠ ${n}`,`- Error: ${e.error??`unknown`}`)):(re(),g.push(``,`### ⬆ Upgrade Available`,`- Server v${oe} ≠ ${n}`,`- Auto-upgrade triggered — check again shortly.`))}l.length>0&&g.push(``,`### ⚠ Warnings`,...l.map(e=>`- ${e}`));let ce=zo();if(ce.length>0){let e=ce.sort((e,t)=>t.callCount-e.callCount);g.push(``,`### Tool Usage This Session`,``),g.push(`| Tool | Calls | Tokens In | Tokens Out | Errors | Avg Latency |`),g.push(`|------|-------|-----------|------------|--------|-------------|`);for(let t of e.slice(0,15)){let e=Math.round(t.totalInputChars/4),n=Math.round(t.totalOutputChars/4),r=Math.round(t.totalDurationMs/t.callCount);g.push(`| ${t.tool} | ${t.callCount} | ${e.toLocaleString()} | ${n.toLocaleString()} | ${t.errorCount} | ${r}ms |`)}}let j=Fo();j.callCount>0&&(g.push(``),g.push(`### Session Token Usage`),g.push(`- Tool calls: ${j.callCount}`),g.push(`- Input chars: ${j.totalInputChars.toLocaleString()}`),g.push(`- Output chars: ${j.totalOutputChars.toLocaleString()}`),g.push(`- Est. input tokens: ${Math.round(j.totalInputChars/4).toLocaleString()}`),g.push(`- Est. total tokens: ${Math.round((j.totalInputChars+j.totalOutputChars)/4).toLocaleString()}`));let N=Oo();if(N.bufferSize>=10){let e=N.state===`healthy`?`🟢`:N.state===`degraded`?`🔴`:`🟡`;g.push(``,`### Auto-GC: ${e} ${N.state}`),g.push(`- p95 latency: ${N.p95}ms | buffer: ${N.bufferSize} samples`),N.gcCount>0&&g.push(`- GC cycles triggered: ${N.gcCount}`)}let P=g.join(`
|
|
3003
|
+
`),le=e||D>=Q_?await X_(r,c):void 0,ue={totalRecords:f.totalRecords,totalFiles:f.totalFiles,lastIndexedAt:f.lastIndexedAt??null,onboarded:y,onboardDir:_,contentTypes:f.contentTypeBreakdown,wasmAvailable:!!ir.get(),wasmDiagnostics:rr.get(),graphStats:m,curatedCount:h,serverVersion:oe,scaffoldVersion:te??null,workspaceScaffoldVersion:ne??null,upgradeAvailable:A||se,storeBackend:a?.store?.backend,storeDiagnostics:T??null,contextPressure:b,nextAction:C,sessionTokens:{callCount:j.callCount,totalInputChars:j.totalInputChars,totalOutputChars:j.totalOutputChars,estInputTokens:Math.round(j.totalInputChars/4),estTotalTokens:Math.round((j.totalInputChars+j.totalOutputChars)/4),startTime:j.startTime},...le===void 0?{}:{prelude:le}};return{content:[{type:`text`,text:P+(o===`smart`?"\n\n---\n_Next: Use `search` to query indexed content or `graph({action:'find_nodes', name_pattern:'<top-level-module>'})` → then `graph({action:'neighbors', node_id})` for relationships. Smart indexing handles updates automatically._":"\n\n---\n_Next: Use `search` to query indexed content, `graph({action:'find_nodes', name_pattern:'<top-level-module>'})` → then `graph({action:'neighbors', node_id})` for relationships, or `reindex` to refresh the index._")}],structuredContent:ue}}catch(e){return Z_.error(`Status failed`,R(e)),Y(`INTERNAL`,`Status check failed: ${e instanceof Error?e.message:String(e)}`)}}))}const dv=L(`tools`);function fv(e){return e instanceof Error?(`code`in e?e.code:void 0)===`ENOENT`||e.message.startsWith(`File not found:`)||e.message.startsWith(`Path not found:`):!1}function pv(e){let t=K(`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:B.array(B.string().max(2e3)).min(1).max(5).describe('Search queries (1–5). Single: `["react hooks"]`. Multiple searched in parallel.'),limit:B.number().min(1).max(20).default(5).describe(`Max results per query`),site:B.string().optional().describe(`Restrict to domain (e.g., "docs.aws.amazon.com")`),provider:B.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},X(`web_search`,async({queries:e,limit:t,site:n,provider:r})=>{let i=e,a=async e=>{let i=await An({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(`
|
|
3004
|
+
`)};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 dv.error(`Web search failed`,R(e)),Y(`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);dv.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(`
|
|
3005
|
+
|
|
3006
|
+
`);return c===o.length?Y(`INTERNAL`,u):{content:[{type:`text`,text:u}]}}))}function mv(e){let t=K(`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:B.string().url().describe(`Request URL (http/https only)`),method:B.enum([`GET`,`POST`,`PUT`,`PATCH`,`DELETE`,`HEAD`]).default(`GET`).describe(`HTTP method`),headers:B.record(B.string(),B.string()).optional().describe(`Request headers as key-value pairs`),body:B.string().optional().describe(`Request body (for POST/PUT/PATCH)`),timeout:B.number().min(1e3).max(6e4).default(15e3).describe(`Timeout in milliseconds`)},annotations:t.annotations},X(`http`,async({url:e,method:t,headers:n,body:r,timeout:i})=>{try{let a=await wt({url:e,method:t,headers:n,body:r,timeout:i}),o=[`## ${t} ${e}`,``,`**Status:** ${a.status} ${a.statusText}`,`**Time:** ${a.durationMs}ms`,`**Size:** ${a.sizeBytes} bytes`,`**Content-Type:** ${a.contentType}`,``,`### Headers`,"```json",JSON.stringify(a.headers),"```",``,`### Body`,a.contentType.includes(`json`)?"```json":"```",a.body,"```"];return a.truncated&&o.push(``,`_Response truncated — total size: ${a.sizeBytes} bytes_`),{content:[{type:`text`,text:o.join(`
|
|
3007
|
+
`)}]}}catch(e){return dv.error(`HTTP request failed`,R(e)),Y(`INTERNAL`,`HTTP request failed: ${e instanceof Error?e.message:String(e)}`)}}))}function hv(e){let t=K(`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:B.string().max(500).describe(`Regex pattern (without delimiters)`),flags:B.string().max(10).regex(/^[gimsuy]*$/).default(``).describe(`Regex flags (g, i, m, s, etc.)`),test_strings:B.array(B.string().max(1e4)).max(50).describe(`Strings to test the pattern against`),mode:B.enum([`match`,`replace`,`split`]).default(`match`).describe(`Test mode`),replacement:B.string().optional().describe(`Replacement string (for replace mode)`)},annotations:t.annotations},X(`regex_test`,async({pattern:e,flags:t,test_strings:n,mode:r,replacement:i})=>{let a=Qt({pattern:e,flags:t,testStrings:n,mode:r,replacement:i});if(!a.valid)return Y(`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(`
|
|
3008
|
+
`)}]}}))}function gv(e){let t=K(`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:B.enum([`base64_encode`,`base64_decode`,`url_encode`,`url_decode`,`sha256`,`md5`,`jwt_decode`,`hex_encode`,`hex_decode`]).describe(`Operation to perform`),input:B.string().max(1e6).describe(`Input text`)},annotations:t.annotations},X(`encode`,async({operation:e,input:t})=>{try{let n=st({operation:e,input:t});return{content:[{type:`text`,text:`## ${e}\n\n**Input:** \`${t.length>100?`${t.slice(0,100)}...`:t}\`\n**Output:**\n\`\`\`\n${n.output}\n\`\`\``}]}}catch(e){return dv.error(`Encode failed`,R(e)),Y(`INTERNAL`,`Encode failed: ${e instanceof Error?e.message:String(e)}`)}}))}function _v(e){let t=K(`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:Ps,inputSchema:{path:B.string().describe(`File or directory path to measure`),extensions:B.array(B.string()).optional().describe(`File extensions to include (default: .ts,.tsx,.js,.jsx)`),include_hidden:B.boolean().optional().describe(`Include hidden trees such as .generated and .cache. Default false.`),max_tokens:B.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`)},annotations:t.annotations},X(`measure`,async({path:e,extensions:t,include_hidden:n,max_tokens:r})=>{try{let i=await Pt({path:e,extensions:t,includeHidden:n}),a=[`## Code Metrics`,``,`**Files:** ${i.summary.totalFiles}`,`**Total lines:** ${i.summary.totalLines} (${i.summary.totalCodeLines} code)`,`**Functions:** ${i.summary.totalFunctions}`,`**Avg complexity:** ${i.summary.avgComplexity}`,`**Max complexity:** ${i.summary.maxComplexity.value} (${i.summary.maxComplexity.file})`,``,`### Top files by complexity`,``,`| File | Lines | Code | Complexity | Cognitive | Functions | Imports |`,`|------|-------|------|------------|-----------|-----------|---------|`];for(let e of i.files.slice(0,20)){let t=e.cognitiveComplexity===void 0?`—`:String(e.cognitiveComplexity);a.push(`| ${e.path} | ${e.lines.total} | ${e.lines.code} | ${e.complexity} | ${t} | ${e.functions} | ${e.imports} |`)}i.files.length>20&&a.push(``,`_...and ${i.files.length-20} more files_`);let o={summary:{totalFiles:i.summary.totalFiles,totalLines:i.summary.totalLines,totalCodeLines:i.summary.totalCodeLines,totalFunctions:i.summary.totalFunctions,avgComplexity:i.summary.avgComplexity,maxComplexity:{value:i.summary.maxComplexity.value,file:i.summary.maxComplexity.file}},files:i.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?z(a.join(`
|
|
3008
3009
|
`),r):a.join(`
|
|
3009
|
-
`)}],structuredContent:o}}catch(e){return
|
|
3010
|
+
`)}],structuredContent:o}}catch(e){return fv(e)?(dv.warn(`Measure failed`,{error:`File not found`}),Y(`NOT_FOUND`,`File not found`)):(dv.error(`Measure failed`,R(e)),Y(`INTERNAL`,`Measure failed: ${e instanceof Error?e.message:String(e)}`))}}))}function vv(e){let t=K(`changelog`);e.registerTool(`changelog`,{title:t.title,description:`Generate a changelog from git history between two refs. Groups by conventional commit type.`,inputSchema:{from:B.string().max(200).describe(`Start ref (tag, SHA, HEAD~N)`),to:B.string().max(200).default(`HEAD`).describe(`End ref (default: HEAD)`),format:B.enum([`grouped`,`chronological`,`per-scope`]).default(`grouped`).describe(`Output format`),include_breaking:B.boolean().default(!0).describe(`Highlight breaking changes`),cwd:B.string().optional().describe(`Repository root or working directory`)},annotations:t.annotations},X(`changelog`,async({from:e,to:t,format:n,include_breaking:r,cwd:i})=>{try{let a=Ve({from:e,to:t,format:n,includeBreaking:r,cwd:i}),o=`${a.stats.total} commits (${Object.entries(a.stats.types).map(([e,t])=>`${t} ${e}`).join(`, `)})`;return{content:[{type:`text`,text:`${a.markdown}\n---\n_${o}_`}]}}catch(e){return dv.error(`Changelog failed`,R(e)),Y(`INTERNAL`,`Changelog failed: ${e instanceof Error?e.message:String(e)}`)}}))}function yv(e){let t=K(`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:B.string().max(5e5).describe(`JSON data to validate (as string)`),schema:B.string().max(5e5).describe(`JSON Schema to validate against (as string)`)},annotations:t.annotations},X(`schema_validate`,async({data:e,schema:t})=>{try{let n=ln({data:JSON.parse(e),schema:JSON.parse(t)});if(n.valid)return{content:[{type:`text`,text:`## Validation: PASSED
|
|
3010
3011
|
|
|
3011
3012
|
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(`
|
|
3012
|
-
`)}]}}catch(e){return
|
|
3013
|
-
`)}],structuredContent:a}}))}function
|
|
3014
|
-
`)}],structuredContent:o}}catch(e){return
|
|
3013
|
+
`)}]}}catch(e){return dv.error(`Schema validation failed`,R(e)),Y(`INTERNAL`,`Schema validation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function bv(e){let t=K(`env`);e.registerTool(`env`,{title:t.title,description:`Get system and runtime environment info. Sensitive env vars are redacted by default.`,outputSchema:Fs,inputSchema:{include_env:B.boolean().default(!1).describe(`Include environment variables`),filter_env:B.string().optional().describe(`Filter env vars by name substring`),show_sensitive:B.boolean().default(!1).describe(`Show sensitive values (keys, tokens, etc.) — redacted by default`)},annotations:t.annotations},X(`env`,async({include_env:e,filter_env:t,show_sensitive:n})=>{let r=lt({includeEnv:e,filterEnv:t,showSensitive:n}),i=[`## Environment`,``,`**Platform:** ${r.system.platform} ${r.system.arch}`,`**OS:** ${r.system.type} ${r.system.release}`,`**Host:** ${r.system.hostname}`,`**CPUs:** ${r.system.cpus}`,`**Memory:** ${r.system.memoryFreeGb}GB free / ${r.system.memoryTotalGb}GB total`,``,`**Node:** ${r.runtime.node}`,`**V8:** ${r.runtime.v8}`,`**CWD:** ${r.cwd}`];if(r.env){i.push(``,`### Environment Variables`,``);for(let[e,t]of Object.entries(r.env))i.push(`- \`${e}\`: ${t}`)}let a={platform:r.system.platform,arch:r.system.arch,nodeVersion:r.runtime.node,cwd:r.cwd,cpus:r.system.cpus,memoryFreeGb:r.system.memoryFreeGb,memoryTotalGb:r.system.memoryTotalGb};return{content:[{type:`text`,text:i.join(`
|
|
3014
|
+
`)}],structuredContent:a}}))}function xv(e){let t=K(`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:Is,inputSchema:{operation:B.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:B.string().optional().describe(`Date input (ISO, unix timestamp, or parseable string). For diff: two comma-separated dates`),timezone:B.string().optional().describe(`Target timezone (e.g., "America/New_York", "Asia/Tokyo")`),duration:B.string().optional().describe(`Duration to add (e.g., "2h30m", "1d", "30s") — for add operation`)},annotations:t.annotations},X(`time`,async({operation:e,input:t,timezone:n,duration:r})=>{try{let i=wn({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(`
|
|
3015
|
+
`)}],structuredContent:o}}catch(e){return dv.error(`Time failed`,R(e)),Y(`INTERNAL`,`Time failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Sv(e){try{let t=F(e,`.flows`);if(!M(t))return null;let n=le(t,{withFileTypes:!0});for(let e of n){if(!e.isDirectory())continue;let n=F(t,e.name,`meta.json`);if(M(n)&&JSON.parse(P(n,`utf-8`)).status===`active`)return e.name}}catch{return null}return null}function Cv(e){let{server:t,aikit:n,config:r,elicitor:i,resourceNotifier:a,samplingClient:o,indexMode:s,getSmartState:c,getSmartScheduler:l,precomputedActiveTools:u}=e,d=new xo,f=r.sources[0]?.path??process.cwd(),p=je(f),m={activeSlug:null};m.activeSlug=Sv(f);let h=new Ba(F(r.stateDir??``,`flow-context`),()=>m.activeSlug),g=new Ca;g.register(Oi()),g.register(ba),g.register(Ri),g.register(la),g.register(Fi),g.register(ki),g.register(Ai),g.register(_a),g.register(Mi),g.register(Sa),g.register(ca(()=>m.activeSlug?{active:!0,slug:m.activeSlug}:null));let _=new Oa(g,n.curated,{},h),v=u??Os(r,[...Fa,...Zo],G,$o(r)),y=e=>v.has(e),b=new Set([...v].filter(e=>!wp.includes(e)&&!oo.has(e))),x=new uo;d.use(Ea(_),{order:5,name:`auto-knowledge`}),d.use(Vo(),{order:10,name:`replay`}),d.use(mo(x,{stateStore:n.stateStore,curatedStore:n.curated},{trackedTools:b}),{order:94,name:`procedural-memory`}),d.use(no(new eo(n.stateStore,n.curated)),{order:95,name:`observation-capture`}),d.use(ns(),{order:1,name:`structured-content-guard`}),d.use(za(Ra(r.tokenBudget)),{order:90,name:`compression`}),ps(t,d,r.toolPrefix??``);let S=[...v].filter(e=>Qo.has(e)?Xo.includes(e)?!!n.bridge:e===`er_update_policy`?!!n.policyStore:e===`er_evolve_review`?!!n.evolutionCollector:!1:!0);y(`search`)&&O_(t,n.embedder,n.store,n.graphStore,n.bridge,n.evolutionCollector,o,n.stateStore,r.memory?.retention,r.memory?.consolidation,p);let C={store:n.store,graphStore:n.graphStore,embedder:n.embedder},w=l?e=>{l()?.prioritize(e)}:void 0;y(`lookup`)&&cp(t,n.store,C);let T={onboardComplete:n.onboardComplete,onboardTimestamp:n.onboardTimestamp};y(`status`)&&uv(t,n.store,n.graphStore,n.curated,T,r,s,c,n.stateStore),y(`config`)&&Sl(t,r),y(`reindex`)&&o_(t,n.indexer,r,n.curated,n.store,a,s),y(`knowledge`)&&op(t,n.curated,n.policyStore,n.evolutionCollector,a,h,n.stateStore,r.memory?.retention,r.memory?.supersession,r.memory?.consolidation,r.memory?.lessons,C),y(`memory_explain`)&&Cp(t,n.embedder,n.store),y(`analyze`)&&Bc(t,n.store,n.embedder,C),y(`blast_radius`)&&Vc(t,n.store,n.embedder,n.graphStore,C),y(`produce_knowledge`)&&i_(t,r),y(`onboard`)&&Kp(t,n.store,n.embedder,r,T,C),y(`graph`)&&pd(t,n.graphStore,C),y(`audit`)&&Kc(t,n.store,n.embedder,r.tokenBudget),y(`compact`)&&Bl(t,n.embedder,n.fileCache,f,r.allRoots,C,w),y(`scope_map`)&&Vl(t,n.embedder,n.store,C),y(`find`)&&Hl(t,n.embedder,n.store,f,C,p),y(`parse_output`)&&nu(t),y(`workset`)&&Jp(t),y(`check`)&&$l(t,C,r.tokenBudget),y(`symbol`)&&Ul(t,n.embedder,n.store,n.graphStore,C,p),y(`eval`)&&eu(t),y(`test_run`)&&tu(t,C),y(`stash`)&&Yp(t,n.stateStore),y(`signal`)&&q_(t,n.stateStore),y(`git_context`)&&fp(t),y(`diff_parse`)&&pp(t),y(`rename`)&&mp(t,r),y(`codemod`)&&hp(t,r),y(`restore`)&&u_(t),y(`file_summary`)&&Wl(t,n.fileCache,f,r.allRoots,C,w),y(`checkpoint`)&&Xp(t,n.stateStore),y(`data_transform`)&&gp(t),y(`trace`)&&Gl(t,n.embedder,n.store,n.graphStore,C),y(`process`)&&hd(t),y(`watch`)&&gd(t),y(`dead_symbols`)&&Kl(t,n.embedder,n.store,f,r.allRoots,C),y(`delegate`)&&ru(t,o),y(`health`)&&_d(t),y(`lane`)&&Zp(t),y(`queue`)&&Qp(t),y(`web_fetch`)&&vd(t),y(`guide`)&&yd(t,s),wp.some(e=>y(e))&&Tp(t,r,S),y(`evidence_map`)&&ad(t),y(`digest`)&&od(t,n.embedder),y(`forge_classify`)&&sd(t,C),y(`stratum_card`)&&cd(t,n.embedder,n.fileCache),y(`forge_ground`)&&ld(t,n.embedder,n.store),y(`present`)&&n_(t,i),y(`browser`)&&Jn(t,r),y(`web_search`)&&pv(t),y(`http`)&&mv(t),y(`regex_test`)&&hv(t),y(`encode`)&&gv(t),y(`measure`)&&_v(t),y(`changelog`)&&vv(t),y(`schema_validate`)&&yv(t),y(`env`)&&bv(t),y(`time`)&&xv(t),y(`flow`)&&rd(t,r,{store:n.store?{search:async(e,t)=>(await n.store.ftsSearch(e,t)).map(e=>({content:e.record.content}))}:null,graphStore:n.graphStore,embedder:n.embedder},e=>{m.activeSlug=e}),n.bridge&&Xo.some(e=>y(e))&&(Xc(t,n.bridge,n.evolutionCollector),Zc(t,n.bridge),Qc(t,n.bridge)),n.policyStore&&y(`er_update_policy`)&&im(t,n.policyStore),n.evolutionCollector&&y(`er_evolve_review`)&&Zl(t,n.evolutionCollector),Yo(t,n.store,n.curated),y(`compliance_score`)&&tl(t),y(`replay`)&&c_(t),y(`session_digest`)&&A_(t,n.stateStore,o)}function wv(e,t,n){let r=e=>!n||n.has(e);r(`check`)&&$l(e,void 0,t.tokenBudget),r(`eval`)&&eu(e),r(`test_run`)&&tu(e),r(`parse_output`)&&nu(e),r(`delegate`)&&ru(e),r(`git_context`)&&fp(e),r(`diff_parse`)&&pp(e),r(`rename`)&&mp(e,t),r(`codemod`)&&hp(e,t),r(`data_transform`)&&gp(e),r(`workset`)&&Jp(e),r(`restore`)&&u_(e),r(`lane`)&&Zp(e),r(`queue`)&&Qp(e),r(`session_digest`)&&A_(e),r(`health`)&&_d(e),r(`process`)&&hd(e),r(`watch`)&&gd(e),r(`web_fetch`)&&vd(e),r(`guide`)&&yd(e),wp.some(e=>r(e))&&Tp(e,t,[...n??new Set(Fa)]),r(`evidence_map`)&&ad(e),r(`forge_classify`)&&sd(e),r(`present`)&&n_(e),r(`browser`)&&Jn(e,t),r(`produce_knowledge`)&&i_(e),r(`compliance_score`)&&tl(e),r(`replay`)&&c_(e),r(`status`)&&lv(e),r(`flow`)&&rd(e,t),r(`web_search`)&&pv(e),r(`http`)&&mv(e),r(`regex_test`)&&hv(e),r(`encode`)&&gv(e),r(`measure`)&&_v(e),r(`changelog`)&&vv(e),r(`schema_validate`)&&yv(e),r(`env`)&&bv(e),r(`time`)&&xv(e)}const Tv=L(`resource-notifier`);var Ev=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){Tv.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){Tv.debug(`sendResourceUpdated failed`,{uri:e,error:String(t)})}}};const Dv=L(`server`);function Ov(e){let t=e?.trim().toLowerCase();return t===`1`||t===`true`||t===`yes`||t===`on`}async function kv(n){Dv.info(`Initializing AI Kit components`);let r=n.store.backend,i=n.embedding,a={model:i.model,nativeDim:i.nativeDim??Te.nativeDim,dimensions:i.dimensions,queryPrefix:i.queryPrefix??Te.queryPrefix},o=n.store.path,s=Ov(process.env.AIKIT_SPLIT_STATE),c=F(o,`aikit.db`),l={splitEnabled:s,contentDbPath:c,controlDbPath:s?F(o,`aikit-control.db`):c},u=null;if(r===`sqlite-vec`){let e=l.contentDbPath;M(o)||N(o,{recursive:!0}),u=await vr(e),Dv.debug(`SQLite adapter ready`,{type:u.type,vectorCapable:u.vectorCapable,dbPath:e}),u.vectorCapable||Dv.warn(`┌──────────────────────────────────────────────────────────────────┐
|
|
3015
3016
|
│ ⚠ SQLite vector extension unavailable — DEGRADED MODE │
|
|
3016
3017
|
│ Vector search is disabled. Hybrid search returns FTS only. │
|
|
3017
3018
|
│ To enable: install/rebuild better-sqlite3 (native module). │
|
|
3018
|
-
└──────────────────────────────────────────────────────────────────┘`);let t=F(o,`lance`);M(t)&&
|
|
3019
|
-
`)}const
|
|
3019
|
+
└──────────────────────────────────────────────────────────────────┘`);let t=F(o,`lance`);M(t)&&Dv.info(`Old LanceDB data found at ${t} — ignored. Safe to delete after verifying sqlite-vec works.`)}let d;if(u)if(l.splitEnabled&&l.controlDbPath!==l.contentDbPath){let{migrateToSplitState:e}=await import(`../../store/dist/index.js`);await e(l),d=await vr(l.controlDbPath),xr(d,_r),Dv.info(`State store adapter ready`,{type:d.type,dbPath:l.controlDbPath,splitEnabled:!0})}else d=u;else{let e=F(o,`aikit-state.db`);M(o)||N(o,{recursive:!0}),d=await vr(e),xr(d,_r),Dv.info(`State store adapter ready`,{type:d.type,dbPath:e})}let[f,p,m,h]=await Promise.all([(async()=>{if(n.embedding.childProcess!==!1){let e=new Fr({model:a.model,dimensions:a.dimensions,nativeDim:a.nativeDim,queryPrefix:a.queryPrefix,interOpNumThreads:i.interOpNumThreads,intraOpNumThreads:i.intraOpNumThreads,idleTimeoutMs:i.idleTimeoutMs});return await e.initialize(),Dv.debug(`Embedder loaded (child process)`,{modelId:e.modelId,dimensions:e.dimensions}),e}let{OnnxEmbedder:e}=await import(`../../embeddings/dist/index.js`),t=new e({model:a.model,dimensions:a.dimensions,nativeDim:a.nativeDim,queryPrefix:a.queryPrefix,interOpNumThreads:i.interOpNumThreads,intraOpNumThreads:i.intraOpNumThreads});return await t.initialize(),Dv.debug(`Embedder loaded (in-process)`,{modelId:t.modelId,dimensions:t.dimensions}),t})(),(async()=>{let e=r===`sqlite-vec`?await br({backend:r,path:o,adapter:u??void 0,embeddingDim:a.dimensions,embeddingProfile:a,partition:l}):await br({backend:r,path:o,adapter:u??void 0,embeddingDim:a.dimensions,partition:void 0});return await e.initialize(),Dv.debug(`Store initialized`,{backend:r}),e})(),(async()=>{let e=u?new gr({adapter:u}):new gr({path:o});return await e.initialize(),Dv.debug(`Graph store initialized`,{shared:!!u}),e})(),(async()=>{let e=await ar();if(e){let e=rr.get();Dv.debug(`WASM tree-sitter enabled`,{grammars:e.grammarCount,dir:e.wasmDir})}else{let e=rr.get();Dv.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})()]),g=new Lr(f,p),_=yr(d),v=new Ir(n.store.path);v.load(),g.setHashCache(v);let y=n.curated.path,b=new e(y);await b.initialize();let x=new t(y,p,f,b);g.setGraphStore(m);let S=Yc(n.er),C=S?new lr(n.curated.path):void 0;C&&Dv.debug(`Policy store initialized`,{ruleCount:C.getRules().length});let w=S?new cr:void 0,T=I(n.sources[0]?.path??process.cwd(),Se.aiContext),E=M(T),D=n.onboardDir?M(n.onboardDir):!1,O=E||D,k,ee=E?T:n.onboardDir;if(O&&ee)try{k=fe(ee).mtime.toISOString()}catch{}return Dv.debug(`Onboard state detected`,{onboardComplete:O,onboardTimestamp:k,aiKbExists:E,onboardDirExists:D}),{embedder:f,store:p,stateStore:_,closeStateStore:d===u?void 0:async()=>d.close(),indexer:g,curated:x,graphStore:m,fileCache:new Ie,bridge:S,policyStore:C,evolutionCollector:w,onboardComplete:O,onboardTimestamp:k}}function Av(e,t,n){if(e.serverInstructions)return e.serverInstructions;let r=new Set;for(let e of t){let t=n[e];if(t?.category)for(let e of t.category)r.add(e)}let i=[`This server provides ${t.size} tools across ${r.size} categories: ${[...r].sort().join(`, `)}.`,`TOOL ROUTING:`,`- Understand a file -> file_summary (structure) or compact (extract section)`,`- Find code/symbols -> search (hybrid) or symbol (definition + refs)`,`- Validate changes -> check (typecheck+lint) or test_run (tests)`,`- Read file for editing -> read_file (only for exact lines before edits)`,`FORBIDDEN: DO NOT USE native equivalents when AI Kit provides same:`,`- grep/find -> search or find tool`,`- cat/read_file (for understanding) -> file_summary or compact`,`- terminal tsc/lint -> check tool`,`- terminal test -> test_run tool`];return e.readOnly&&i.push(`Server is in read-only mode. Mutating operations are disabled.`),e.features?.length&&i.push(`Active feature groups: ${e.features.join(`, `)}.`),i.join(`
|
|
3020
|
+
`)}const jv=L(`background-task`);var Mv=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,jv.info(`Background task started`,{task:e.name,pending:this.queue.length});let t=Date.now();try{await e.fn();let n=Date.now()-t;jv.info(`Background task completed`,{task:e.name,durationMs:n}),e.resolve()}catch(n){let r=Date.now()-t;jv.error(`Background task failed`,{task:e.name,durationMs:r,err:n}),e.reject(n instanceof Error?n:Error(String(n)))}}this.running=null}};const Nv=L(`idle-timer`);var Pv=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){Nv.info(`Idle timeout reached with no active session — skipping cleanup (waiting for first tool call)`);return}if(this._busy){Nv.info(`Skipping idle cleanup — background work in progress`);return}Nv.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`&&Nv.warn(`Idle cleanup callback failed`,{error:String(t.reason)})}};const Fv=L(`memory-monitor`);var Iv=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(),Fv.debug(`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`?Fv.warn(`Memory CRITICAL: ${n}MB RSS — consider restarting the server`):t===`warning`?Fv.warn(`Memory WARNING: ${n}MB RSS`):this.lastLevel!==`normal`&&Fv.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 Lv=L(`tool-timeout`),Rv=new Set([`onboard`,`reindex`,`produce_knowledge`,`analyze`,`codemod`,`audit`]);var zv=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 Bv(e){return Rv.has(e)?6e5:12e4}function Vv(e,t,n){return new Promise((r,i)=>{let a=!1,o=setTimeout(()=>{if(!a){a=!0;let e=new zv(n,t);Lv.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 $=L(`server`),Hv=new Set([`status`,`list_tools`,`describe_tool`,`config`,`env`,`present`]);function Uv(e,t=28){let n=e.replace(/\s+/g,` `).trim();return n.length<=t?n:`${n.slice(0,t-3)}...`}function Wv(e){let t=[`query`,`path`,`task`,`name`,`start`,`symbol`,`file`,`pattern`],n=[];for(let r of t){let t=e[r];typeof t==`string`&&t.length>0&&t.length<200&&n.push(t)}return n.join(` `).slice(0,200)}async function Gv(e,t,n){let r=[];try{t.statePath&&ct(e.stateStore,{stateDir:t.statePath});let i=e.stateStore.stashList().map(e=>e.key);if(i.length>0){let e=n.toLowerCase().split(/\s+/).filter(e=>e.length>2);if(e.length===0)r.push(`stash: ${i.length} entries available`);else{let t=i.filter(t=>e.some(e=>t.toLowerCase().includes(e))).slice(0,3);t.length>0?r.push(`stash: ${t.map(e=>`"${Uv(e)}"`).join(`, `)}${i.length>t.length?` (${i.length} total)`:``}`):r.push(`stash: ${i.length} entries available`)}}}catch{}try{if(n){let t=await Promise.race([e.store.ftsSearch(n,{limit:3}),new Promise(e=>setTimeout(()=>e(null),50))]);if(Array.isArray(t)&&t.length>0){let e=t.filter(e=>e&&typeof e==`object`&&`record`in e&&(e.record.origin===`produced`||e.record.origin===`curated`));if(e.length>0){let t=e.slice(0,2).map(e=>{let t=e.record;return`"${Uv(t.headingPath||t.sourcePath||`knowledge`)}"`});r.push(`knowledge: ${t.join(`, `)}`)}}}}catch{}return r.length===0?null:`\n---\nContext available: ${r.join(` | `)}\nPull with: stash({action:'get', key:'...'}) or search({query:'...', origin:'produced'})\n---`}function Kv(e,t,n){let r=3;for(let[i,a]of Object.entries(e)){let e=a.handler;a.handler=async(...a)=>{let o=await e(...a);if(!o||typeof o!=`object`||r<=0||o.isError||Hv.has(i))return o;try{r--;let e=a[0],i=await Gv(t,n,Wv(e&&typeof e==`object`?e:{}));i&&(o.content=Array.isArray(o.content)?o.content:[],o.content.push({type:`text`,text:i}))}catch{}return o}}}function qv(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`,`cannot find package`,`module not found`].some(e=>t.includes(e))}function Jv(e){return Ip(e)?[`Auto-heal tried to repair missing runtime dependency files in the npx install.`,`If this persists, clear the broken npx cache and restart:`,` npm cache clean --force`,` npx -y @vpxa/aikit@latest serve`].join(`
|
|
3020
3021
|
`):[`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.`].join(`
|
|
3021
|
-
`)}async function
|
|
3022
|
-
`),`utf8`),$.info(`Auto-heal: created ESM shim for @huggingface/transformers (.mjs wrapper → .cjs)`,{path:t}))}catch(e){$.warn(`Auto-heal: failed to create ESM shim`,{error:e instanceof Error?e.message:String(e),path:t})}}}if(n.includes(`embedding`)||n.includes(`onnx`)||n.includes(`protobuf`)||n.includes(`model`)){let t=e.embedding?.model;if(t){let e=F(
|
|
3023
|
-
`):[`AI Kit is still initializing (loading embeddings model & store).`,``,`**${
|
|
3024
|
-
`);Vr(i);let p=new So;p.use(ts(),{order:1,name:`structured-content-guard`}),fs(i,p,e.toolPrefix??``);let m=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let h=[];for(let e of Ia){if(!n.has(e))continue;let t=G(e),r=i.registerTool(e,{title:t.title,description:`${t.title} — initializing, available shortly`,inputSchema:{},annotations:t.annotations},async()=>({content:[{type:`text`,text:f()}]}));La.has(e)?r.remove():h.push(r)}N_(i,e,n),i.sendToolListChanged=m;let g=i.registerResource(`aikit-status`,`aikit://status`,{description:`AI Kit status (initializing...)`,mimeType:`text/plain`},async()=>({contents:[{uri:`aikit://status`,text:`AI Kit is initializing...`,mimeType:`text/plain`}]})),_=i.registerPrompt(`_init`,{description:`Initializing AI Kit…`,argsSchema:{_dummy:qn(z.string(),()=>[])}},async()=>({messages:[]})),v,y,b=new Promise((e,t)=>{v=e,y=t}),x,S=new Promise(e=>{x=e}),C=()=>x?.(),w=(async()=>{await S;try{let{createRequire:e}=await import(`node:module`),{readFileSync:t,existsSync:n}=await import(`node:fs`),{fileURLToPath:r}=await import(`node:url`),{resolve:i,dirname:a}=await import(`node:path`),o=e(import.meta.url),s=a(r(import.meta.url)),c=i(s,`..`,`package.json`),l=i(s,`..`,`..`),u=JSON.parse(t(c,`utf8`)),d=Object.keys(u.dependencies??{}),f=[`@mixmark-io/domino`],p=[...d,...f.filter(e=>!d.includes(e))],m=p.filter(e=>!e.startsWith(`@aikit/`)),h=p.filter(e=>e.startsWith(`@aikit/`)),g=[];for(let e of m)try{o.resolve(e)}catch{try{o.resolve(`${e}/package.json`)}catch{g.push(e)}}g.length>0&&$.warn(`Dependencies not resolvable — server may operate in degraded mode`,{missing:g,hint:`Run: npm cache clean --force && npx -y @vpxa/aikit@latest serve`});let _=[];if(h.length>0){for(let e of h)n(i(l,e.slice(7),`dist`))||_.push(e);_.length>0&&$.warn(`Workspace sibling packages missing dist — server may have degraded features`,{missing:_,hint:`Reinstall: npm cache clean --force && npx -y @vpxa/aikit@latest serve`})}}catch{}let n;try{n=await L_(e)}catch(t){let r=t instanceof Error?t.message:String(t);if(tv(r)){$.warn(`AI Kit initialization failed with recoverable error — attempting auto-heal retry`,{error:r}),await rv(e,r);try{n=await L_(e),$.info(`AI Kit auto-heal successful — initialization recovered after retry`)}catch(e){a=`failed`,o=e instanceof Error?e.message:String(e),$.error(`AI Kit initialization failed after auto-heal attempt — server continuing with zero-dep tools only`,{error:o,originalError:r}),y?.(e instanceof Error?e:Error(o));return}}else{a=`failed`,o=r,$.error(`AI Kit initialization failed — server continuing with zero-dep tools only`,{error:o}),y?.(t instanceof Error?t:Error(o));return}}let r=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let f=i.sendPromptListChanged.bind(i);i.sendPromptListChanged=()=>{};let p=i.sendResourceListChanged.bind(i);i.sendResourceListChanged=()=>{};for(let e of h)e.remove();g.remove(),_.remove();let m=i._registeredTools??{};for(let e of La)m[e]?.remove();let b=new F_(i),x=su(i);M_({server:i,aikit:n,config:e,elicitor:zr(i),resourceNotifier:b,samplingClient:x,indexMode:t,getSmartState:t===`smart`?(()=>{let e=u;return e?.getState?e.getState():null}):null,getSmartScheduler:t===`smart`?()=>{let e=u;return e?{prioritize:e.prioritize.bind(e)}:null}:null}),Qr(i,{curated:n.curated,store:n.store,graphStore:n.graphStore,stateStore:n.stateStore},t),i.sendToolListChanged=r,i.sendPromptListChanged=f,i.sendResourceListChanged=p,Promise.resolve(i.sendToolListChanged()).catch(()=>{}),Promise.resolve(i.sendPromptListChanged()).catch(()=>{}),Promise.resolve(i.sendResourceListChanged()).catch(()=>{});let C=i._registeredTools??{};for(let[e,t]of Object.entries(C)){if(Ra.has(e))continue;let r=t.handler;t.handler=async(...i)=>{if(!n.indexer.isIndexing)return r(...i);let a=s?`re-indexing`:`running initial index`,o=new Promise(n=>setTimeout(()=>n({content:[{type:`text`,text:`⏳ AI Kit is ${a}. The tool "${e}" timed out waiting for index data (${$o/1e3}s).\n\nThe existing index may be temporarily locked. Please retry shortly — indexing will complete automatically.`}],...t.config?.outputSchema?{structuredContent:ss(t.config.outputSchema)}:{}}),$o));return Promise.race([r(...i),o])}}for(let[e,t]of Object.entries(C)){let n=t.handler,r=J_(e);t.handler=async(...i)=>{try{return await Y_(()=>n(...i),r,e)}catch(n){if(n instanceof q_)return{content:[{type:`text`,text:`⏳ Tool "${e}" timed out after ${r/1e3}s. This may indicate a long-running operation. Please retry or break the task into smaller steps.`}],...t.config?.outputSchema?{structuredContent:ss(t.config.outputSchema)}:{}};throw n}}}let w=Object.keys(C).length;w<Ia.length&&$.warn(`ALL_TOOL_NAMES count mismatch`,{expectedToolCount:Ia.length,registeredToolCount:w}),$.debug(`MCP server configured`,{toolCount:Ia.length,resourceCount:4});let T=new W_;T.onPressure((e,t)=>{e===`warning`&&Gr(),e===`critical`&&($.warn(`Memory pressure critical — consider restarting`,{rssMB:Math.round(t/1024/1024)}),Gr())}),T.registerMemoryPressureCallback(()=>n.embedder.shutdown?.()),T.start();let D=new H_;l=D,D.onIdle(async()=>{if(E.isRunning||n.indexer.isIndexing){$.info(`Idle cleanup deferred — background tasks still running`),D.touch();return}$.info(`Idle cleanup: releasing cached memory (connections stay open)`);try{n.store.releaseMemory?.(),n.graphStore.releaseMemory?.()}catch{}}),D.touch();let O=!1;for(let e of Object.values(C)){let t=e.handler;e.handler=async(...e)=>{if(O||(O=!0,D.markSessionActive()),D.touch(),u){let t=d(e[0]);t.length>0&&u.prioritize(...t)}return t(...e)}}ev(C,n,{statePath:e.stateDir??``});for(let[,e]of Object.entries(C)){let t=e.config?.outputSchema;if(!t)continue;let n=e.handler;e.handler=async(...e)=>{let r=await n(...e);if(!r||typeof r!=`object`)return r;let i=r;return!(`content`in i)||i.isError||i.structuredContent!=null&&typeof i.structuredContent==`object`?r:(i.structuredContent=ss(t),i.structuredContent??={},r)}}process.stdin.on(`end`,()=>($.info(`stdin closed — MCP client disconnected. Shutting down.`),process.exit(0))),process.stdin.on(`error`,()=>($.info(`stdin error — MCP client disconnected. Shutting down.`),process.exit(0))),c=n,v?.(n)})(),T=async()=>{let t;try{t=await b}catch{$.warn(`Skipping initial index — AI Kit initialization failed`);return}l?.setBusy(!0);try{let n=e.sources.map(e=>e.path).join(`, `);$.info(`Running initial index`,{sourcePaths:n});let r=await t.indexer.index(e,e=>{e.phase===`crawling`||e.phase===`done`||(e.phase===`chunking`&&e.currentFile&&$.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&$.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});s=!0,$.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){$.warn(`FTS index creation failed`,R(e))}try{let e=await t.curated.reindexAll();$.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){$.error(`Curated re-index failed`,R(e))}}catch(e){$.error(`Initial index failed; will retry on aikit_reindex`,R(e))}finally{l?.setBusy(!1)}},E=new B_,D=()=>E.schedule({name:`initial-index`,fn:T}),O=process.ppid,k=setInterval(()=>{try{process.kill(O,0)}catch{$.info(`Parent process died; shutting down`,{parentPid:O}),clearInterval(k),u?.stop&&u.stop(),import(`../../tools/dist/index.js`).then(({processStopAll:e})=>e()).catch(()=>{}),b.then(async e=>{await Promise.all([e.embedder.shutdown?.().catch(()=>{})??Promise.resolve(),e.graphStore.close().catch(()=>{}),e.closeStateStore?.().catch(()=>{})??Promise.resolve(),e.store.close().catch(()=>{})])}).catch(()=>{}).finally(()=>process.exit(0))}},5e3);return k.unref(),{server:i,startInit:C,ready:w,runInitialIndex:D,get aikit(){return c},scheduler:E,setSmartScheduler(e){u=e}}}const av=L(`server`);function ov(e,t){let n=Ds(t,[...Ia,...Xo],W,Qo(t)),r=R_(t,n,W),i=new Vn({name:t.serverName??`aikit`,version:ie()},{capabilities:{logging:{},completions:{},prompts:{},extensions:{roots:{}}},instructions:r}),a=i;return a.setNotificationHandler(Un,async()=>{try{let{roots:e}=await a.listRoots();if(e&&e.length>0){let n=be(e[0].uri);process.env.AIKIT_TRANSPORT===`http`?(t.sources[0]={path:n,excludePatterns:t.sources[0]?.excludePatterns??[]},t.allRoots=e.map(e=>be(e.uri)),av.info(`Workspace root updated (HTTP mode)`,{rootPath:n,sourceCount:t.sources.length})):(x(t,n),av.info(`Workspace root updated (stdio mode)`,{rootPath:n}))}}catch(e){av.debug(`MCP roots/list not available`,{error:R(e)})}}),Vr(i),M_({server:i,aikit:e,config:t,elicitor:zr(i),resourceNotifier:new F_(i),samplingClient:su(i),precomputedActiveTools:n}),Qr(i,{curated:e.curated,store:e.store,graphStore:e.graphStore,stateStore:e.stateStore},t.indexMode),i}async function sv(e){let t=await L_(e),n=ov(t,e);av.debug(`MCP server configured`,{toolCount:Ia.length,resourceCount:2});let r=async()=>{try{let n=e.sources.map(e=>e.path).join(`, `);av.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&&av.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&av.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});av.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){av.warn(`FTS index creation failed`,R(e))}try{let e=await t.curated.reindexAll();av.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){av.error(`Curated re-index failed`,R(e))}}catch(e){av.error(`Initial index failed; will retry on aikit_reindex`,R(e))}},i=async()=>{av.info(`Shutting down`),await Promise.all([t.embedder.shutdown?.().catch(()=>{})??Promise.resolve(),t.graphStore.close().catch(()=>{}),t.closeStateStore?.().catch(()=>{})??Promise.resolve(),t.store.close().catch(()=>{})]),process.exit(0)};process.on(`SIGINT`,i),process.on(`SIGTERM`,i);let a=process.ppid,o=setInterval(()=>{try{process.kill(a,0)}catch{av.info(`Parent process died; shutting down`,{parentPid:a}),clearInterval(o),i()}},5e3);return o.unref(),{server:n,runInitialIndex:r,shutdown:i}}export{Ia as ALL_TOOL_NAMES,iv as createLazyServer,ov as createMcpServer,sv as createServer,L_ as initializeAikit,M_ as registerMcpTools};
|
|
3022
|
+
`)}async function Yv(e,t){let n=t.toLowerCase(),r;try{({rm:r}=await import(`node:fs/promises`))}catch{return}if(n.includes(`transformers.node.mjs`)&&n.includes(`cannot find module`)){let e=t.match(/Cannot find module '([^']+transformers\.node\.mjs)'/);if(e){let t=e[1],n=t.replace(/\.mjs$/,`.cjs`);try{let{existsSync:e,writeFileSync:r}=await import(`node:fs`);e(n)&&!e(t)&&(r(t,[`// Auto-generated ESM shim — published package missing this file`,`import { createRequire } from 'node:module';`,`const require = createRequire(import.meta.url);`,`const mod = require('./transformers.node.cjs');`,`export default mod;`,``].join(`
|
|
3023
|
+
`),`utf8`),$.info(`Auto-heal: created ESM shim for @huggingface/transformers (.mjs wrapper → .cjs)`,{path:t}))}catch(e){$.warn(`Auto-heal: failed to create ESM shim`,{error:e instanceof Error?e.message:String(e),path:t})}}}if(n.includes(`embedding`)||n.includes(`onnx`)||n.includes(`protobuf`)||n.includes(`model`)){let t=e.embedding?.model;if(t){let e=F(Rn(),`.cache`,`huggingface`,`transformers-js`,t);try{await r(e,{recursive:!0,force:!0}),$.info(`Auto-heal: cleared embedding model cache`,{path:e})}catch{}}}if(n.includes(`lance`)||n.includes(`database`)||n.includes(`store`)){let t=F(e.store.path,`lance`);try{await r(t,{recursive:!0,force:!0}),$.info(`Auto-heal: cleared LanceDB store`,{path:t})}catch{}}if(n.includes(`sqlite`)||n.includes(`database disk image`)||n.includes(`graph`)){let t=F(e.store.path,`graph.db`);try{await r(t,{force:!0}),$.info(`Auto-heal: cleared graph database`,{path:t})}catch{}let n=F(e.store.path,`aikit.db`);try{await r(n,{force:!0}),await r(`${n}-wal`,{force:!0}).catch(()=>{}),await r(`${n}-shm`,{force:!0}).catch(()=>{}),$.info(`Auto-heal: cleared corrupted aikit database`,{path:n})}catch{}}if(Ip(t)){let e=await zp(t);e.repaired||$.warn(`Auto-heal: missing runtime dependency repair did not complete`,{packages:e.packages,reason:e.reason,error:e.error,hint:`Run: npm cache clean --force && npx -y @vpxa/aikit@latest serve`})}else n.includes(`cannot find module`)&&!n.includes(`.cache`)&&$.warn(`Auto-heal: missing module detected during initialization cleanup`,{hint:`Run: npm cache clean --force && npx -y @vpxa/aikit@latest serve`})}function Xv(e,t){let n=Os(e,Fa,G,$o(e)),r=Av(e,n,G),i=new Bn({name:e.serverName??`aikit`,version:ie()},{capabilities:{logging:{},completions:{},prompts:{}},instructions:r}),a=`initializing`,o=``,s=!1,c=null,l=null,u=null;function d(e){if(!e||typeof e!=`object`)return[];let t=e,n=[];for(let e of[`path`,`file`,`source_path`,`sourcePath`,`filePath`]){let r=t[e];typeof r==`string`&&r&&n.push(r)}for(let e of[`changed_files`,`paths`,`files`]){let r=t[e];if(Array.isArray(r))for(let e of r){if(typeof e==`string`){n.push(e);continue}e&&typeof e==`object`&&typeof e.path==`string`&&n.push(e.path)}}if(Array.isArray(t.sources))for(let e of t.sources)e&&typeof e==`object`&&typeof e.path==`string`&&n.push(e.path);return n}let f=()=>a===`failed`?[`❌ AI Kit initialization failed — this tool is unavailable.`,``,o?`Error: ${o}`:``,``,`**${Ia.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.`,``,Jv(o),``,`Try restarting the MCP server to retry initialization.`].filter(Boolean).join(`
|
|
3024
|
+
`):[`AI Kit is still initializing (loading embeddings model & store).`,``,`**${Ia.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(`
|
|
3025
|
+
`);Br(i);let p=new xo;p.use(ns(),{order:1,name:`structured-content-guard`}),ps(i,p,e.toolPrefix??``);let m=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let h=[];for(let e of Fa){if(!n.has(e))continue;let t=K(e),r=i.registerTool(e,{title:t.title,description:`${t.title} — initializing, available shortly`,inputSchema:{},annotations:t.annotations},async()=>({content:[{type:`text`,text:f()}]}));Ia.has(e)?r.remove():h.push(r)}wv(i,e,n),i.sendToolListChanged=m;let g=i.registerResource(`aikit-status`,`aikit://status`,{description:`AI Kit status (initializing...)`,mimeType:`text/plain`},async()=>({contents:[{uri:`aikit://status`,text:`AI Kit is initializing...`,mimeType:`text/plain`}]})),_=i.registerPrompt(`_init`,{description:`Initializing AI Kit…`,argsSchema:{_dummy:Kn(B.string(),()=>[])}},async()=>({messages:[]})),v,y,b=new Promise((e,t)=>{v=e,y=t}),x,S=new Promise(e=>{x=e}),C=()=>x?.(),w=(async()=>{await S;try{let{createRequire:e}=await import(`node:module`),{readFileSync:t,existsSync:n}=await import(`node:fs`),{fileURLToPath:r}=await import(`node:url`),{resolve:i,dirname:a}=await import(`node:path`),o=e(import.meta.url),s=a(r(import.meta.url)),c=i(s,`..`,`package.json`),l=i(s,`..`,`..`),u=JSON.parse(t(c,`utf8`)),d=Object.keys(u.dependencies??{}),f=[`@mixmark-io/domino`],p=[...d,...f.filter(e=>!d.includes(e))],m=p.filter(e=>!e.startsWith(`@aikit/`)),h=p.filter(e=>e.startsWith(`@aikit/`)),g=[];for(let e of m)try{o.resolve(e)}catch{try{o.resolve(`${e}/package.json`)}catch{g.push(e)}}g.length>0&&$.warn(`Dependencies not resolvable — server may operate in degraded mode`,{missing:g,hint:`Run: npm cache clean --force && npx -y @vpxa/aikit@latest serve`});let _=[];if(h.length>0){for(let e of h)n(i(l,e.slice(7),`dist`))||_.push(e);_.length>0&&$.warn(`Workspace sibling packages missing dist — server may have degraded features`,{missing:_,hint:`Reinstall: npm cache clean --force && npx -y @vpxa/aikit@latest serve`})}}catch{}let n;try{n=await kv(e)}catch(t){let r=t instanceof Error?t.message:String(t);if(qv(r)){$.warn(`AI Kit initialization failed with recoverable error — attempting auto-heal retry`,{error:r}),await Yv(e,r);try{n=await kv(e),$.info(`AI Kit auto-heal successful — initialization recovered after retry`)}catch(e){a=`failed`,o=e instanceof Error?e.message:String(e),$.error(`AI Kit initialization failed after auto-heal attempt — server continuing with zero-dep tools only`,{error:o,originalError:r}),y?.(e instanceof Error?e:Error(o));return}}else{a=`failed`,o=r,$.error(`AI Kit initialization failed — server continuing with zero-dep tools only`,{error:o}),y?.(t instanceof Error?t:Error(o));return}}let r=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let f=i.sendPromptListChanged.bind(i);i.sendPromptListChanged=()=>{};let p=i.sendResourceListChanged.bind(i);i.sendResourceListChanged=()=>{};for(let e of h)e.remove();g.remove(),_.remove();let m=i._registeredTools??{};for(let e of Ia)m[e]?.remove();let b=new Ev(i),x=cu(i);Cv({server:i,aikit:n,config:e,elicitor:Rr(i),resourceNotifier:b,samplingClient:x,indexMode:t,getSmartState:t===`smart`?(()=>{let e=u;return e?.getState?e.getState():null}):null,getSmartScheduler:t===`smart`?()=>{let e=u;return e?{prioritize:e.prioritize.bind(e)}:null}:null}),Zr(i,{curated:n.curated,store:n.store,graphStore:n.graphStore,stateStore:n.stateStore},t),i.sendToolListChanged=r,i.sendPromptListChanged=f,i.sendResourceListChanged=p,Promise.resolve(i.sendToolListChanged()).catch(()=>{}),Promise.resolve(i.sendPromptListChanged()).catch(()=>{}),Promise.resolve(i.sendResourceListChanged()).catch(()=>{});let C=i._registeredTools??{};for(let[e,t]of Object.entries(C)){if(La.has(e))continue;let r=t.handler;t.handler=async(...i)=>{if(!n.indexer.isIndexing)return r(...i);let a=s?`re-indexing`:`running initial index`,o=new Promise(n=>setTimeout(()=>n({content:[{type:`text`,text:`⏳ AI Kit is ${a}. The tool "${e}" timed out waiting for index data (${es/1e3}s).\n\nThe existing index may be temporarily locked. Please retry shortly — indexing will complete automatically.`}],...t.config?.outputSchema?{structuredContent:cs(t.config.outputSchema)}:{}}),es));return Promise.race([r(...i),o])}}for(let[e,t]of Object.entries(C)){let n=t.handler,r=Bv(e);t.handler=async(...i)=>{try{return await Vv(()=>n(...i),r,e)}catch(n){if(n instanceof zv)return{content:[{type:`text`,text:`⏳ Tool "${e}" timed out after ${r/1e3}s. This may indicate a long-running operation. Please retry or break the task into smaller steps.`}],...t.config?.outputSchema?{structuredContent:cs(t.config.outputSchema)}:{}};throw n}}}let w=Object.keys(C).length;w<Fa.length&&$.warn(`ALL_TOOL_NAMES count mismatch`,{expectedToolCount:Fa.length,registeredToolCount:w}),$.debug(`MCP server configured`,{toolCount:Fa.length,resourceCount:4});let T=new Iv;T.onPressure((e,t)=>{e===`warning`&&Wr(),e===`critical`&&($.warn(`Memory pressure critical — consider restarting`,{rssMB:Math.round(t/1024/1024)}),Wr())}),T.registerMemoryPressureCallback(()=>n.embedder.shutdown?.()),T.start();let D=new Pv;l=D,D.onIdle(async()=>{if(E.isRunning||n.indexer.isIndexing){$.info(`Idle cleanup deferred — background tasks still running`),D.touch();return}$.info(`Idle cleanup: releasing cached memory (connections stay open)`);try{n.store.releaseMemory?.(),n.graphStore.releaseMemory?.()}catch{}}),D.touch();let O=!1;for(let e of Object.values(C)){let t=e.handler;e.handler=async(...e)=>{if(O||(O=!0,D.markSessionActive()),D.touch(),u){let t=d(e[0]);t.length>0&&u.prioritize(...t)}return t(...e)}}Kv(C,n,{statePath:e.stateDir??``});for(let[,e]of Object.entries(C)){let t=e.config?.outputSchema;if(!t)continue;let n=e.handler;e.handler=async(...e)=>{let r=await n(...e);if(!r||typeof r!=`object`)return r;let i=r;return!(`content`in i)||i.isError||i.structuredContent!=null&&typeof i.structuredContent==`object`?r:(i.structuredContent=cs(t),i.structuredContent??={},r)}}process.stdin.on(`end`,()=>($.info(`stdin closed — MCP client disconnected. Shutting down.`),process.exit(0))),process.stdin.on(`error`,()=>($.info(`stdin error — MCP client disconnected. Shutting down.`),process.exit(0))),c=n,v?.(n)})(),T=async()=>{let t;try{t=await b}catch{$.warn(`Skipping initial index — AI Kit initialization failed`);return}l?.setBusy(!0);try{let n=e.sources.map(e=>e.path).join(`, `);$.info(`Running initial index`,{sourcePaths:n});let r=await t.indexer.index(e,e=>{e.phase===`crawling`||e.phase===`done`||(e.phase===`chunking`&&e.currentFile&&$.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&$.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});s=!0,$.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){$.warn(`FTS index creation failed`,R(e))}try{let e=await t.curated.reindexAll();$.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){$.error(`Curated re-index failed`,R(e))}}catch(e){$.error(`Initial index failed; will retry on aikit_reindex`,R(e))}finally{l?.setBusy(!1)}},E=new Mv,D=()=>E.schedule({name:`initial-index`,fn:T}),O=process.ppid,k=setInterval(()=>{try{process.kill(O,0)}catch{$.info(`Parent process died; shutting down`,{parentPid:O}),clearInterval(k),u?.stop&&u.stop(),import(`../../tools/dist/index.js`).then(({processStopAll:e})=>e()).catch(()=>{}),b.then(async e=>{await Promise.all([e.embedder.shutdown?.().catch(()=>{})??Promise.resolve(),e.graphStore.close().catch(()=>{}),e.closeStateStore?.().catch(()=>{})??Promise.resolve(),e.store.close().catch(()=>{})])}).catch(()=>{}).finally(()=>process.exit(0))}},5e3);return k.unref(),{server:i,startInit:C,ready:w,runInitialIndex:D,get aikit(){return c},scheduler:E,setSmartScheduler(e){u=e}}}const Zv=L(`server`);function Qv(e,t){let n=Os(t,[...Fa,...Zo],G,$o(t)),r=Av(t,n,G),i=new Bn({name:t.serverName??`aikit`,version:ie()},{capabilities:{logging:{},completions:{},prompts:{},extensions:{roots:{}}},instructions:r}),a=i;return a.setNotificationHandler(Hn,async()=>{try{let{roots:e}=await a.listRoots();if(e&&e.length>0){let n=be(e[0].uri);process.env.AIKIT_TRANSPORT===`http`?(t.sources[0]={path:n,excludePatterns:t.sources[0]?.excludePatterns??[]},t.allRoots=e.map(e=>be(e.uri)),Zv.info(`Workspace root updated (HTTP mode)`,{rootPath:n,sourceCount:t.sources.length})):(x(t,n),Zv.info(`Workspace root updated (stdio mode)`,{rootPath:n}))}}catch(e){Zv.debug(`MCP roots/list not available`,{error:R(e)})}}),Br(i),Cv({server:i,aikit:e,config:t,elicitor:Rr(i),resourceNotifier:new Ev(i),samplingClient:cu(i),precomputedActiveTools:n}),Zr(i,{curated:e.curated,store:e.store,graphStore:e.graphStore,stateStore:e.stateStore},t.indexMode),i}async function $v(e){let t=await kv(e),n=Qv(t,e);Zv.debug(`MCP server configured`,{toolCount:Fa.length,resourceCount:2});let r=async()=>{try{let n=e.sources.map(e=>e.path).join(`, `);Zv.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&&Zv.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&Zv.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});Zv.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){Zv.warn(`FTS index creation failed`,R(e))}try{let e=await t.curated.reindexAll();Zv.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){Zv.error(`Curated re-index failed`,R(e))}}catch(e){Zv.error(`Initial index failed; will retry on aikit_reindex`,R(e))}},i=async()=>{Zv.info(`Shutting down`),await import(`../../tools/dist/index.js`).then(({processStopAll:e})=>e()).catch(()=>{}),await Promise.all([t.embedder.shutdown?.().catch(()=>{})??Promise.resolve(),t.graphStore.close().catch(()=>{}),t.closeStateStore?.().catch(()=>{})??Promise.resolve(),t.store.close().catch(()=>{})]),process.exit(0)};process.on(`SIGINT`,i),process.on(`SIGTERM`,i);let a=process.ppid,o=setInterval(()=>{try{process.kill(a,0)}catch{Zv.info(`Parent process died; shutting down`,{parentPid:a}),clearInterval(o),i()}},5e3);return o.unref(),{server:n,runInitialIndex:r,shutdown:i}}export{Fa as ALL_TOOL_NAMES,Xv as createLazyServer,Qv as createMcpServer,$v as createServer,kv as initializeAikit,Cv as registerMcpTools};
|