kontexta 4.3.1

package/bundle/standalone/apps/web/.next/server/app/api/install-snippets/route_client-reference-manifest.js

@@ -0,0 +1 @@
+globalThis.__RSC_MANIFEST=(globalThis.__RSC_MANIFEST||{});globalThis.__RSC_MANIFEST["/api/install-snippets/route"]={"moduleLoading":{"prefix":"/_next/"},"ssrModuleMapping":{"3870":{"*":{"id":"5010","name":"*","chunks":[],"async":false}},"10335":{"*":{"id":"74775","name":"*","chunks":[],"async":false}},"17518":{"*":{"id":"17504","name":"*","chunks":[],"async":false}},"18558":{"*":{"id":"68506","name":"*","chunks":[],"async":false}},"21660":{"*":{"id":"41634","name":"*","chunks":[],"async":false}},"22377":{"*":{"id":"75947","name":"*","chunks":[],"async":false}},"23670":{"*":{"id":"94854","name":"*","chunks":[],"async":false}},"23733":{"*":{"id":"24575","name":"*","chunks":[],"async":false}},"43319":{"*":{"id":"7715","name":"*","chunks":[],"async":false}},"55808":{"*":{"id":"27864","name":"*","chunks":[],"async":false}},"59413":{"*":{"id":"74839","name":"*","chunks":[],"async":false}},"72388":{"*":{"id":"57042","name":"*","chunks":[],"async":false}},"80062":{"*":{"id":"57074","name":"*","chunks":[],"async":false}},"91784":{"*":{"id":"16704","name":"*","chunks":[],"async":false}}},"edgeSSRModuleMapping":{},"clientModules":{"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/client/components/builtin/global-error.js":{"id":17518,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/esm/client/components/builtin/global-error.js":{"id":17518,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/client/components/client-page.js":{"id":43319,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/esm/client/components/client-page.js":{"id":43319,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/client/components/client-segment.js":{"id":23733,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/esm/client/components/client-segment.js":{"id":23733,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/client/components/http-access-fallback/error-boundary.js":{"id":80062,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/esm/client/components/http-access-fallback/error-boundary.js":{"id":80062,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/client/components/layout-router.js":{"id":23670,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/esm/client/components/layout-router.js":{"id":23670,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/client/components/metadata/async-metadata.js":{"id":18558,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/esm/client/components/metadata/async-metadata.js":{"id":18558,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/client/components/render-from-template-context.js":{"id":21660,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/esm/client/components/render-from-template-context.js":{"id":21660,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/lib/framework/boundary-components.js":{"id":10335,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/esm/lib/framework/boundary-components.js":{"id":10335,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/lib/metadata/generate/icon-mark.js":{"id":3870,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/dist/esm/lib/metadata/generate/icon-mark.js":{"id":3870,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/apps/web/src/components/theme/theme-provider.tsx":{"id":91784,"name":"*","chunks":["2377","static/chunks/2377-956eb9b333193ac6.js","7177","static/chunks/app/layout-9a9569fc88cd95d2.js"],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/font/google/target.css?{\"path\":\"src/app/layout.tsx\",\"import\":\"Inter\",\"arguments\":[{\"subsets\":[\"latin\"],\"variable\":\"--font-sans\",\"display\":\"swap\"}],\"variableName\":\"inter\"}":{"id":18701,"name":"*","chunks":["2377","static/chunks/2377-956eb9b333193ac6.js","7177","static/chunks/app/layout-9a9569fc88cd95d2.js"],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/font/google/target.css?{\"path\":\"src/app/layout.tsx\",\"import\":\"JetBrains_Mono\",\"arguments\":[{\"subsets\":[\"latin\"],\"variable\":\"--font-mono\",\"display\":\"swap\"}],\"variableName\":\"jetbrainsMono\"}":{"id":95120,"name":"*","chunks":["2377","static/chunks/2377-956eb9b333193ac6.js","7177","static/chunks/app/layout-9a9569fc88cd95d2.js"],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/font/google/target.css?{\"path\":\"src/app/layout.tsx\",\"import\":\"Manrope\",\"arguments\":[{\"subsets\":[\"latin\"],\"variable\":\"--font-title\",\"display\":\"swap\"}],\"variableName\":\"manrope\"}":{"id":77994,"name":"*","chunks":["2377","static/chunks/2377-956eb9b333193ac6.js","7177","static/chunks/app/layout-9a9569fc88cd95d2.js"],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/next@15.5.18_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/next/font/google/target.css?{\"path\":\"src/app/layout.tsx\",\"import\":\"Saira\",\"arguments\":[{\"subsets\":[\"latin\"],\"variable\":\"--font-saira\",\"display\":\"swap\"}],\"variableName\":\"saira\"}":{"id":27946,"name":"*","chunks":["2377","static/chunks/2377-956eb9b333193ac6.js","7177","static/chunks/app/layout-9a9569fc88cd95d2.js"],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/apps/web/src/app/globals.css":{"id":3281,"name":"*","chunks":["2377","static/chunks/2377-956eb9b333193ac6.js","7177","static/chunks/app/layout-9a9569fc88cd95d2.js"],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/node_modules/.pnpm/sonner@2.0.7_react-dom@19.2.6_react@19.2.6__react@19.2.6/node_modules/sonner/dist/index.mjs":{"id":22377,"name":"*","chunks":["2377","static/chunks/2377-956eb9b333193ac6.js","7177","static/chunks/app/layout-9a9569fc88cd95d2.js"],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/apps/web/src/app/login/login-client.tsx":{"id":59413,"name":"*","chunks":[],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/apps/web/src/app/home-client.tsx":{"id":55808,"name":"*","chunks":["2377","static/chunks/2377-956eb9b333193ac6.js","3068","static/chunks/3068-293b252158eb9d15.js","9794","static/chunks/9794-16144bed6de4bf26.js","8974","static/chunks/app/page-2b151d30cb29d2e5.js"],"async":false},"/Users/safiyudeen.saidumuha/projects/kontexta/apps/web/src/components/calendar/calendar-client.tsx":{"id":72388,"name":"*","chunks":[],"async":false}},"entryCSSFiles":{"/Users/safiyudeen.saidumuha/projects/kontexta/apps/web/src/":[],"/Users/safiyudeen.saidumuha/projects/kontexta/apps/web/src/app/layout":[{"inlined":false,"path":"static/css/c00514317f297826.css"}],"/Users/safiyudeen.saidumuha/projects/kontexta/apps/web/src/app/page":[],"/Users/safiyudeen.saidumuha/projects/kontexta/apps/web/src/app/api/install-snippets/route":[]},"rscModuleMapping":{"3281":{"*":{"id":"99807","name":"*","chunks":[],"async":false}},"3870":{"*":{"id":"53192","name":"*","chunks":[],"async":false}},"10335":{"*":{"id":"90657","name":"*","chunks":[],"async":false}},"17518":{"*":{"id":"28450","name":"*","chunks":[],"async":false}},"18558":{"*":{"id":"83840","name":"*","chunks":[],"async":false}},"21660":{"*":{"id":"12216","name":"*","chunks":[],"async":false}},"22377":{"*":{"id":"41801","name":"*","chunks":[],"async":false}},"23670":{"*":{"id":"64060","name":"*","chunks":[],"async":false}},"23733":{"*":{"id":"20909","name":"*","chunks":[],"async":false}},"43319":{"*":{"id":"51645","name":"*","chunks":[],"async":false}},"55808":{"*":{"id":"30127","name":"*","chunks":[],"async":false}},"59413":{"*":{"id":"56378","name":"*","chunks":[],"async":false}},"72388":{"*":{"id":"38186","name":"*","chunks":[],"async":false}},"80062":{"*":{"id":"92612","name":"*","chunks":[],"async":false}},"91784":{"*":{"id":"70474","name":"*","chunks":[],"async":false}}},"edgeRscModuleMapping":{"3870":{"*":{"id":"5010","name":"*","chunks":[],"async":false}},"10335":{"*":{"id":"74775","name":"*","chunks":[],"async":false}},"17518":{"*":{"id":"17504","name":"*","chunks":[],"async":false}},"18558":{"*":{"id":"68506","name":"*","chunks":[],"async":false}},"21660":{"*":{"id":"41634","name":"*","chunks":[],"async":false}},"22377":{"*":{"id":"75947","name":"*","chunks":[],"async":false}},"23670":{"*":{"id":"94854","name":"*","chunks":[],"async":false}},"23733":{"*":{"id":"24575","name":"*","chunks":[],"async":false}},"43319":{"*":{"id":"7715","name":"*","chunks":[],"async":false}},"80062":{"*":{"id":"57074","name":"*","chunks":[],"async":false}}}}

package/bundle/standalone/apps/web/.next/server/app/api/mcp-tools/route.js

@@ -0,0 +1 @@
+(()=>{var a={};a.id=2224,a.ids=[2224],a.modules={261:a=>{"use strict";a.exports=require("next/dist/shared/lib/router/utils/app-paths")},3295:a=>{"use strict";a.exports=require("next/dist/server/app-render/after-task-async-storage.external.js")},4751:()=>{},10846:a=>{"use strict";a.exports=require("next/dist/compiled/next-server/app-page.runtime.prod.js")},16040:(a,b,c)=>{"use strict";c.d(b,{BE:()=>i,Er:()=>h,Sg:()=>j,T1:()=>k,T5:()=>l});var d=c(77598),e=c.n(d),f=c(28684);function g(){if(globalThis.__kontextaSessionSecret)return globalThis.__kontextaSessionSecret;let a=null;try{a=(0,f.getSetting)("auth_session_secret")}catch{return globalThis.__kontextaTmpSessionSecret??(globalThis.__kontextaTmpSessionSecret=e().randomBytes(32).toString("hex"))}return a||(a=e().randomBytes(32).toString("hex"),(0,f.setSetting)("auth_session_secret",a)),globalThis.__kontextaSessionSecret=a,a}function h(a){let b=e().randomBytes(32).toString("hex");return{hash:e().scryptSync(a,b,64).toString("hex"),salt:b}}function i(a,b,c){let d=e().scryptSync(a,c,64).toString("hex");return e().timingSafeEqual(Buffer.from(b,"hex"),Buffer.from(d,"hex"))}function j(a){let b=g(),c=Buffer.from(JSON.stringify(a)).toString("base64"),d=e().createHmac("sha256",b).update(c).digest("hex");return`${c}.${d}`}function k(a){let b=!1;try{b="true"===(0,f.getSetting)("auth_trust_proxy_headers")}catch{b=!1}if(!b)return"direct";let c=a.headers.get("x-forwarded-for");if(c){let a=c.split(",")[0].trim();if(a)return a}let d=a.headers.get("x-real-ip");return d?d.trim():"direct"}function l(a){let b=null;try{b=(0,f.getSetting)("auth_password_hash")}catch{return!0}if(!b)return!0;let c=!1;try{c="true"===(0,f.getSetting)("auth_trust_proxy_headers")}catch{c=!1}let d=c?a.headers.get("x-forwarded-for")?.split(",")[0].trim()??a.headers.get("x-real-ip")??void 0:void 0,h=!1;if("cookies"in a&&"function"==typeof a.cookies.get)h=!!a.cookies.get("kontexta_locked")?.value;else{let b=a.headers.get("cookie");b&&(h=/(?:^|;\s*)kontexta_locked=1/.test(b))}if(!h&&function(a){let b=null;try{b=(0,f.getSetting)("auth_bypass_ips")}catch{return!1}if(!b)return!1;let c=b.split(",").map(a=>a.trim());return!!(a&&c.includes(a)||(c.includes("127.0.0.1")||c.includes("localhost")||c.includes("*"))&&("127.0.0.1"===a||"::1"===a||"localhost"===a))}(d))return!0;let i=null;if("cookies"in a&&"function"==typeof a.cookies.get)i=a.cookies.get("kontexta_session")?.value;else{let b=a.headers.get("cookie");if(b){let a=b.match(/(?:^|;\s*)kontexta_session=([^;]+)/);if(a)try{i=decodeURIComponent(a[1])}catch{i=a[1]}}}return!!(i&&function(a){try{let[b,c]=a.split(".");if(!b||!c)return null;let d=g(),f=e().createHmac("sha256",d).update(b).digest("hex"),h=Buffer.from(c,"hex"),i=Buffer.from(f,"hex");if(h.length!==i.length||!e().timingSafeEqual(h,i))return null;let j=JSON.parse(Buffer.from(b,"base64").toString("utf-8"));if("number"!=typeof j?.t||Date.now()-j.t>2592e6)return null;return j}catch{return null}}(i))}},19121:a=>{"use strict";a.exports=require("next/dist/server/app-render/action-async-storage.external.js")},28684:a=>{"use strict";a.exports=require("kxta-core")},29294:a=>{"use strict";a.exports=require("next/dist/server/app-render/work-async-storage.external.js")},35783:(a,b,c)=>{"use strict";c.r(b),c.d(b,{handler:()=>F,patchFetch:()=>E,routeModule:()=>A,serverHooks:()=>D,workAsyncStorage:()=>B,workUnitAsyncStorage:()=>C});var d={};c.r(d),c.d(d,{GET:()=>z});var e=c(20584),f=c(18093),g=c(84892),h=c(17262),i=c(55572),j=c(261),k=c(26370),l=c(97824),m=c(92768),n=c(98611),o=c(52333),p=c(67359),q=c(5601),r=c(92710),s=c(86439),t=c(79596),u=c(16040),v=c(36865);let w=JSON.parse('{"r":"2026-08-10T19:41:22.485Z","Y":[{"name":"journal_append","description":"Append a timestamped text entry to today\'s daily journal file in the Knowledge Base. Creates the file if it doesn\'t already exist. Both calls on the same calendar day return the same file_id. Returns { file_id }.","inputSchema":{"type":"object","properties":{"text":{"type":"string","description":"Text to append to today\'s journal entry"},"project_id":{"type":"number","description":"Optional project ID context"}},"required":["text"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"create_file","description":"Create a new markdown or mermaid file in the knowledge base or project. This operation writes a new file to disk and adds it to the local SQLite FTS5 index. Destination can be \'knowledge\' (global KB), \'project\' (reference file inside a project repo), or \'kontexta\' (internal Kontexta schema file). If destination is \'project\' or \'kontexta\', project_id is strictly required. No external auth required. Rate limits do not apply (local operation). Returns the created file metadata including its new ID, path, and estimated tokens. If the destination directory does not exist, it will be created automatically. Use this tool to instantiate new contextual documents or notes. To modify an existing file, use \'update_file\' instead. Parameters: \'destination\' dictates required fields; if \'project\' or \'kontexta\', \'project_id\' must be a valid integer. \'tags\' and \'folder\' are optional. Pass format=\'mmd\' to create a Mermaid diagram file (.mmd); defaults to \'md\'.","inputSchema":{"type":"object","properties":{"title":{"type":"string","description":"Title of the file"},"content":{"type":"string","description":"Content of the file"},"destination":{"type":"string","enum":["knowledge","project","kontexta"],"description":"Destination type"},"project_id":{"type":"number","description":"Project ID (required for project/kontexta destinations)"},"folder":{"type":"string","description":"Optional folder path"},"tags":{"type":"array","items":{"type":"string"},"description":"Optional array of tags"},"format":{"type":"string","enum":["md","mmd"],"description":"File extension to write. Defaults to \'md\'."}},"required":["title","content","destination"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"read_file","description":"Read one file\'s full body and metadata by ID. Read-only; no side effects, auth, or rate limits. Returns title, path, content, tags, est_tokens (so you can budget context before opening more files), and timestamps. Throws if the ID is unknown. Use for a single known file. Prefer `describe_file` to inspect without paying body tokens; `read_files` for batches; `read_file_lines`/`read_section` for partial reads; `read_file_by_path` when you only have the absolute path.","inputSchema":{"type":"object","properties":{"id":{"type":"number","description":"File ID"}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"read_files","description":"Batch read up to 200 files by ID in one call. Returns per-file annotated records, an aggregate `total_est_tokens`, and an isolated `errors[]` (one bad ID does NOT abort the batch). Read-only; no side effects, auth, or rate limits. Use instead of looping `read_file` to halve round-trips and get the combined token cost upfront. For >200 IDs, page yourself.","inputSchema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"number"},"minItems":1,"maxItems":200,"description":"File IDs to read (max 200 per call)"}},"required":["ids"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"describe_file","description":"Return everything ABOUT a file without pulling its content (no token cost from the body). Tags, size, est_tokens, history depth, related-file ids, backlinks, project, folder, last edited. Operates locally with no auth or rate limits. Use this when you\'d otherwise chain read_file + list_tags + get_history + find_related just to decide whether to actually read the file. Parameters: \'id\' must be a valid integer file ID.","inputSchema":{"type":"object","properties":{"id":{"type":"number","description":"File ID"}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"read_file_lines","description":"Return a 1-indexed inclusive line slice of a file. Out-of-range bounds clamp silently to the file\'s actual length; `to < from` throws. Read-only; no side effects, auth, or rate limits. Returns the snippet plus its size_bytes and est_tokens. Use to inspect a stack-trace region or a chunk of a large file without pulling the whole body. Prefer `read_section` if you know the heading, `grep_in_file` if you know a pattern but not the line number.","inputSchema":{"type":"object","properties":{"id":{"type":"number","description":"File ID"},"from":{"type":"integer","exclusiveMinimum":0,"description":"First line (1-indexed, inclusive)"},"to":{"type":"integer","exclusiveMinimum":0,"description":"Last line (1-indexed, inclusive)"}},"required":["id","from","to"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"grep_in_file","description":"Match a JS regex against one file\'s lines and return matched lines with line numbers (capped: default 100, max 500). Catches what FTS misses: URLs, hyphenated terms, code identifiers. Read-only; no side effects, auth, or rate limits. Invalid regex throws `invalid regex`. Returns `{matches, match_count, truncated}`. Use after `read_file_outline` when you know the file but need a specific reference; for cross-file regex use `regex_search`; for keyword/concept search use `search`.","inputSchema":{"type":"object","properties":{"id":{"type":"number","description":"File ID"},"pattern":{"type":"string","description":"Pattern to match. Treated as a JavaScript RegExp source."},"case_insensitive":{"type":"boolean","description":"Add the \'i\' flag (default false)"},"max_matches":{"type":"integer","exclusiveMinimum":0,"maximum":500,"description":"Cap on returned hits (default 100)"}},"required":["id","pattern"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"regex_search","description":"Match a JS regex against the body of every file in scope (project, KB, or all) and return per-file hits with line numbers. Slower than FTS `search` because it reads each file\'s content; use only when FTS misses substrings, URLs, or code identifiers. Read-only; no side effects, auth, or rate limits. Capped at 500 files / 10 hits per file by default; the response reports `files_truncated` and per-file truncation so the agent can re-scope. `project_id: null` = KB only; omit = everywhere. Invalid regex throws.","inputSchema":{"type":"object","properties":{"pattern":{"type":"string","description":"JavaScript RegExp source"},"project_id":{"type":["number","null"],"description":"Scope to one project, null for KB-only, omit for everything"},"case_insensitive":{"type":"boolean"},"max_files":{"type":"integer","exclusiveMinimum":0,"maximum":2000,"description":"Cap on files scanned (default 500)"},"max_matches_per_file":{"type":"integer","exclusiveMinimum":0,"maximum":100,"description":"Per-file hit cap (default 10)"}},"required":["pattern"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"update_file","description":"Update the entire content of an existing file by its ID. This replaces the file\'s content on disk and triggers an FTS5 re-index. Returns the updated file metadata including new estimated token counts. Operates locally with no external auth or rate limits. If you only need to modify a single section without replacing the entire file, use \'update_file_section\' instead to save context budget. Parameters: \'id\' must be a valid integer file ID. \'content\' is the complete markdown string that will replace the file.","inputSchema":{"type":"object","properties":{"id":{"type":"number","description":"File ID"},"content":{"type":"string","description":"New content"}},"required":["id","content"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"delete_file","description":"DESTRUCTIVE. Permanently delete one file by ID. KB files are unlinked from disk AND removed from the FTS5 index; project reference files only have their index entry removed (the file on disk is left alone so the watcher does not fight your editor). Not idempotent — deleting an unknown ID throws. No external auth or rate limits. Returns `{success: true}`. Use only when the file is truly obsolete; to deprioritise without losing data, untag (`remove_tags`) or unfavorite (`set_favorite`) instead. Bulk variant: `delete_files`.","inputSchema":{"type":"object","properties":{"id":{"type":"number","description":"File ID"}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"list_files","description":"List file metadata with optional filters (project_id, tag, favorite, folder, untagged) and pagination. Read-only; no side effects, auth, or rate limits. Each row is annotated with tags, est_tokens, and size_bytes; the response includes `total_est_tokens` so you can budget before reading bodies. `project_id: null` returns ONLY Knowledge Base files; omit the field to span everything. Use to browse known structure; for keyword/content lookup use `search`; for a denser whole-vault dump use `project_map`.","inputSchema":{"type":"object","properties":{"project_id":{"type":["number","null"],"description":"Filter by project ID. Pass null to list ONLY Knowledge Base files (project_id IS NULL)."},"tag":{"type":"string","description":"Filter by tag name"},"favorite":{"type":"boolean","description":"Filter by favorite status"},"folder":{"type":"string","description":"Filter by folder path"},"untagged":{"type":"boolean","description":"If true, return only files that have no tags. Useful for bulk-tagging workflows."},"limit":{"type":"number","description":"Maximum number of results"},"offset":{"type":"number","description":"Offset for pagination"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"search","description":"Full-text (SQLite FTS5) keyword search across files. Returns ranked matches with inline match_excerpt and title_highlight (no follow-up `read_file` needed for snippets) plus tags, est_tokens, size_bytes, and aggregate `total_est_tokens`. Read-only; no side effects, auth, or rate limits. FTS is tokenised: it WILL miss URLs, hyphenated terms, and partial substrings — fall back to `regex_search` for those. `project_id: null` searches only the KB; omit the field to span everything; `tags[]` requires ALL listed tags to match. For prompt-ready bundled bodies use `bundle_search`.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"project_id":{"type":["number","null"],"description":"Filter by project ID. Pass null to search ONLY Knowledge Base files."},"tags":{"type":"array","items":{"type":"string"},"description":"Filter by tags (all must match)"},"favorite":{"type":"boolean","description":"Filter by favorite status"}},"required":["query"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"bundle_search","description":"Run an FTS search and concatenate matched bodies into a single prompt-ready bundle (XML `<document>` blocks or markdown headers + fences) capped at `max_tokens`. Files are added in rank order until the next would exceed the budget; the rest go to `skipped[]`. Read-only; no side effects, auth, or rate limits. Use instead of `search` + N\xd7`read_file` when you need several related files as one context blob. Defaults: format=xml, max_tokens=50000. `project_id: null` = KB only; `tags[]` requires ALL to match.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Full-text search query"},"project_id":{"type":["number","null"],"description":"Filter by project ID. Pass null to bundle ONLY Knowledge Base files."},"tags":{"type":"array","items":{"type":"string"},"description":"Filter by tags (all must match)"},"favorite":{"type":"boolean","description":"Filter by favorite status"},"format":{"type":"string","enum":["xml","markdown"],"default":"xml","description":"Bundle format. xml = Anthropic-recommended <document> tags; markdown = ## headers + fenced blocks"},"max_tokens":{"type":"integer","exclusiveMinimum":0,"default":50000,"description":"Token budget. Files added in rank order until the next would exceed; remainder go to skipped[]"}},"required":["query"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"add_tags","description":"Append tags to ONE file. Additive — existing tags are preserved; re-adding an existing tag is a no-op (idempotent per tag). New tag names auto-create rows in the global `tags` table. Persists to local SQLite. No external auth or rate limits. Returns `{success: true}`; throws if file_id is unknown. Use to label a single file. To tag every file matching a query in one call use `tag_search_results`; to remove tags use `remove_tags`.","inputSchema":{"type":"object","properties":{"file_id":{"type":"number","description":"File ID"},"tags":{"type":"array","items":{"type":"string"},"description":"Array of tag names to add"}},"required":["file_id","tags"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"remove_tags","description":"Detach one or more tag IDs from ONE file. Destructive on the link only — does NOT delete the file or the global tag definition (orphan tags survive in `list_tags`). Idempotent: removing an already-absent tag is a no-op. No external auth or rate limits. Returns `{success: true}`. Note: takes tag IDs (integers), not names — fetch them via `list_tags`. To remove ALL tags from many files via a query, see `tag_search_results` (additive only) — there is no bulk-untag-by-query tool.","inputSchema":{"type":"object","properties":{"file_id":{"type":"number","description":"File ID"},"tag_ids":{"type":"array","items":{"type":"number"},"description":"Array of tag IDs to remove"}},"required":["file_id","tag_ids"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"set_favorite","description":"Set or clear the favorite flag on one file (idempotent — re-setting the same value is a no-op; not a toggle, you pass the desired state). Persists to local SQLite. No external auth or rate limits. Returns `{success: true}`. Use to curate quick-access pins; `list_files`/`search`/`bundle_search` accept `favorite: true` to filter to the pinned set.","inputSchema":{"type":"object","properties":{"file_id":{"type":"number","description":"File ID"},"favorite":{"type":"boolean","description":"Favorite status"}},"required":["file_id","favorite"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"list_tags","description":"List every tag in the global SQLite database with id, name, and applied count. Read-only; no side effects, auth, or rate limits. Returns the entire taxonomy (not paginated). Use to discover existing labels before tagging (so you reuse rather than fork) or to find tag IDs to feed into `remove_tags`. For tags on a specific file, use `describe_file`.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{}},"execution":{"taskSupport":"forbidden"}},{"name":"list_projects","description":"List every registered project with id, name, absolute path, and a derived `has_hands` flag (true when the path exists on disk AND contains a `kontexta.json`). Read-only; no side effects, auth, or rate limits. Use to find the project_id to pass to scoped tools (`search`, `list_files`, `commit_backup`, `refresh_index`, etc.). To register a new project use `register_project`; to inspect its Hands tools use `list_hands`.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{}},"execution":{"taskSupport":"forbidden"}},{"name":"register_project","description":"Register a new project and link it to the Kontexta knowledge system.\\n\\nSIDE EFFECTS: Writes project metadata to disk (persisted in the Kontexta data directory). Scans the project root recursively to discover and index all markdown files into the local database. Registers any kontexta.json-declared Hands tools found in the project root. This operation is idempotent — re-registering an existing project updates its metadata without data loss.\\n\\nAUTH / RATE LIMITS: None. Operates entirely on the local file system.\\n\\nPARAMETERS:\\n- name: Human-readable project name.\\n- path: Absolute path to the project root. Required. DO NOT guess or assume the path based on the active editor workspace unless the user explicitly asks to register the \\"current\\" or \\"open\\" project. If the user provides a project name but no path, ask them for the absolute path before calling this tool. Fails with a descriptive error if the path does not exist or is inaccessible.\\n- description: Optional free-text description stored with the project metadata.\\n\\nRETURNS: A JSON object containing:\\n- project: { id, name, path, description, created_at }\\n- discovered_files_count: number of markdown files indexed\\n- discovered_files: array of { path, est_tokens, size_bytes } for each file\\n- total_est_tokens: estimated total token cost of all discovered files\\n- hands: { found, tools_registered, tools_disabled, warnings }\\n- warnings: array of non-fatal issues (e.g. scan failures, token budget exceeded)\\n\\nERROR CONDITIONS: Returns isError=true if path is missing or unresolvable. Scan failures are non-fatal and reported in warnings rather than as errors.","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"Project name"},"path":{"type":"string","description":"Absolute path to the project root. Required. DO NOT guess from the active workspace unless asked. Ask the user if unsure."},"description":{"type":"string","description":"Optional project description"}},"required":["name","path"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"onboard_agent","description":"Write or update the kontexta workflow rules block in a project\'s agent context file(s). Idempotent — uses fenced markers + version to skip no-op writes.\\n\\nMANDATORY: This tool modifies project configuration files. You MUST seek explicit user consent before calling this tool. Set \'confirm: true\' only after the user has agreed.\\n\\nPARAMETERS:\\n- project_id: number, required.\\n- confirm: boolean, required. Must be true to proceed.\\n- files: string[], optional. Paths relative to project root. For update mode, defaults to recommendation.target_files. Ignored when files is empty AND target_agent is provided (create mode).\\n- target_agent: enum claude-code | codex | gemini | cursor | continue | aider | cline | copilot | generic. Required when files is empty AND no context file currently exists. Picks the canonical filename and the starter scaffold.\\n\\nRETURNS: { written: [{ path, action: created|updated|skipped, version }], skipped: [{ path, reason }] }","inputSchema":{"type":"object","properties":{"project_id":{"type":"number","description":"Project ID returned from register_project"},"confirm":{"type":"boolean","description":"MANDATORY: Set to true only after obtaining explicit user consent to modify context files."},"files":{"type":"array","items":{"type":"string"},"description":"Project-relative paths to update; defaults to detected context files"},"target_agent":{"type":"string","enum":["claude-code","codex","gemini","antigravity","cursor","continue","aider","cline","copilot","generic"],"description":"Required when files is empty AND no context file exists. Picks the canonical filename + scaffold."}},"required":["project_id","confirm"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"transfer_agent_context","description":"COPY existing agent context files (CLAUDE.md, AGENTS.md, .cursor/rules/*.mdc, etc.) from a project\'s repo into Kontexta\'s per-project knowledge base so they\'re indexed by FTS5 and can be git-synced through Kontexta\'s own backup engine.\\n\\nThis tool ONLY COPIES. It never deletes or modifies the originals in your repo. After a successful transfer, the response includes the list of source paths so the user can manually remove them if desired. No tool argument, no flag, and no code path in this tool ever calls a destructive filesystem operation against `project.path`.\\n\\nMANDATORY: This tool writes new files into Kontexta\'s data dir. You MUST seek explicit user consent before calling. Set \'confirm: true\' only after the user has agreed.\\n\\nPARAMETERS:\\n- project_id: number, required. Project ID returned from register_project.\\n- confirm: boolean, required. Must be true.\\n- files: string[], optional. Project-relative paths to transfer. Omit or pass [] to transfer all detected agent context files (uses the same detection list as register_project / onboard_agent).\\n\\nRETURNS: { transferred: [{ source_path, kb_id, kb_path, est_tokens }], skipped: [{ source_path, reason }], next_action }\\nSkip reasons: \\"missing\\" | \\"symlink\\" | \\"outside_project\\" | \\"already_transferred_same_content\\" | \\"read_error\\" | \\"write_error\\".\\n\\nIDEMPOTENT: re-running with the same files copies nothing if the content is unchanged — duplicate transfers are detected via SHA-256 hash comparison against existing project KB rows.","inputSchema":{"type":"object","properties":{"project_id":{"type":"number","description":"Project ID returned from register_project"},"confirm":{"type":"boolean","description":"MANDATORY: Set to true only after obtaining explicit user consent."},"files":{"type":"array","items":{"type":"string"},"description":"Project-relative paths to transfer. Omit to transfer all detected context files."}},"required":["project_id","confirm"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"commit_backup","description":"SIDE-EFFECTFUL — TOUCHES THE NETWORK. Sync the project\'s KB data into its git backup directory, create a commit, and `git push` to `origin`. AUTH: relies on the local user\'s git credentials (SSH agent, credential helper, etc.) — there is no in-server auth. Kontexta does not rate-limit, but the remote may. Idempotent in steady state: a no-op commit is skipped, but the push still runs. Throws if the project has no configured backup repo or if push fails (network, auth, conflict). Returns `{success, copied_files_count, copied_paths}`. Use after a batch of KB writes to get changes off-machine.","inputSchema":{"type":"object","properties":{"project_id":{"type":"number","description":"Project ID"}},"required":["project_id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"clip_url","description":"SIDE-EFFECTFUL — fetches an EXTERNAL URL and writes a NEW KB file. Downloads the page, extracts the main article via Readability, converts to markdown, and saves it as a new clipping. NOT idempotent / no de-dup — re-clipping the same URL creates a second file. AUTH: anonymous by default; pass `headers` (e.g. `{Cookie: \'session=...\'}` or `{Authorization: \'Bearer ...\'}`) to clip behind logins. Kontexta does not rate-limit but the upstream may throttle. On auth-required pages returns isError with `code: AUTH_REQUIRED`, optional `login_url`, and a hint to retry with `headers`. Returns `{file_id, path, title, source}`. Use to ingest external docs into the KB.","inputSchema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"The URL to clip"},"title":{"type":"string","description":"Optional title override (defaults to the page\'s <title>)"},"headers":{"type":"object","additionalProperties":{"type":"string"},"description":"Optional HTTP headers to forward with the fetch (e.g. {\\"Cookie\\": \\"session=...\\"} or {\\"Authorization\\": \\"Bearer ...\\"}). Use to clip pages behind auth walls after AUTH_REQUIRED."}},"required":["url"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"get_history","description":"Return the git commit history for one file (newest first), each entry with hash, message, date, and author. Reads the file\'s owning repo: the project\'s git repo for project files, the KB backup repo for KB files. Read-only; no side effects, auth, or rate limits. Returns `{file_id, path, history}`; an empty array means the file has not been committed yet. Use to understand a file\'s evolution before editing or restoring. Pair with `get_diff` to see exact line changes; use `restore_file` to roll back.","inputSchema":{"type":"object","properties":{"file_id":{"type":"number","description":"ID of the file"}},"required":["file_id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"get_diff","description":"Return the unified diff of one file between two commit hashes (typically obtained from `get_history` for the same file). Read-only; no side effects, auth, or rate limits. Order matters — `commit_a` is treated as the earlier side; reversing the args inverts the diff. Throws if either hash is unknown to the file\'s repo. Use after `get_history` to see WHAT changed, not just THAT it changed.","inputSchema":{"type":"object","properties":{"file_id":{"type":"number","description":"ID of the file"},"commit_a":{"type":"string","description":"Earlier commit hash (from get_history)"},"commit_b":{"type":"string","description":"Later commit hash (from get_history)"}},"required":["file_id","commit_a","commit_b"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"restore_file","description":"DESTRUCTIVE. Overwrite a file\'s current on-disk content with the version recorded at a specific git commit, then re-index FTS. The hash MUST come from `get_history` for THIS file (foreign hashes throw). The current uncommitted content is lost unless it was already committed elsewhere. The file watcher may also pick up the change before this returns. No external auth or rate limits. Returns `{file_id, path, hash, success, message}`. Use only to undo accidental edits or recover a known-good version.","inputSchema":{"type":"object","properties":{"file_id":{"type":"number","description":"ID of the file"},"hash":{"type":"string","description":"Commit hash to restore from (from get_history)"}},"required":["file_id","hash"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"read_file_outline","description":"Return a flat list of markdown headings for one file (level, text, line, byteStart, byteEnd). Read-only; no side effects, auth, or rate limits. Use as a cheap probe before `read_section` or `update_file_section` so you don\'t spend tokens on the full body just to learn what sections exist. Empty outline means the file has no markdown headings (it may still have content — fall back to `read_file` or `read_file_lines`).","inputSchema":{"type":"object","properties":{"file_id":{"type":"number","description":"File ID"}},"required":["file_id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"read_section","description":"Return the body of ONE heading (the heading line itself is excluded) plus level, line, size_bytes, and est_tokens. Heading match is case-insensitive but exact-string after trim — fuzzy / partial matches do NOT resolve. Returns isError if the heading is absent. Read-only; no side effects, auth, or rate limits. Pair with `read_file_outline` when you are unsure which headings exist; for non-heading line ranges use `read_file_lines`.","inputSchema":{"type":"object","properties":{"file_id":{"type":"number","description":"File ID"},"heading":{"type":"string","description":"Heading text to extract (case-insensitive)"}},"required":["file_id","heading"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"update_file_section","description":"Surgical write — replace the body of ONE heading without touching siblings. The heading line itself is preserved verbatim; only its body is rewritten. Persists via the same path as `update_file` (writes to disk → FTS reindex → git commit). Throws if the heading does not exist (this tool will NOT create a new section — append the section text via `update_file` first). Heading match is case-insensitive exact-string. No external auth or rate limits. Returns the updated file metadata. Use to make targeted edits without re-sending the whole body; for full-file replacement use `update_file`.","inputSchema":{"type":"object","properties":{"file_id":{"type":"number","description":"File ID"},"heading":{"type":"string","description":"Heading whose body to replace (case-insensitive)"},"content":{"type":"string","description":"New body content (heading line is preserved automatically)"}},"required":["file_id","heading","content"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"list_folders","description":"List folder paths under a project root (or the Knowledge Base when `project_id` is null/omitted). Returns `{folders: string[], base_path}` where `folders` are RELATIVE to `base_path`. Read-only; no side effects, auth, or rate limits. Throws if `project_id` references an unknown project. Use to discover where to drop a new file via `create_file`\'s `folder` argument or to navigate vault structure; to actually create one use `create_folder`.","inputSchema":{"type":"object","properties":{"project_id":{"type":["number","null"],"description":"Project ID. Pass null or omit to list KB folders."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"create_folder","description":"Create a folder under a project root or the KB. Idempotent — creating an existing folder succeeds. Nested paths like `notes/inbox` create intermediates. REJECTS: empty names, null bytes, leading path separators, and any segment equal to `..` (the call returns isError, no folder is touched). Side effect: a directory is mkdir\'d on disk; no DB rows are written until a file lands inside. No external auth or rate limits. Returns `{path, base_path}`.","inputSchema":{"type":"object","properties":{"project_id":{"type":["number","null"],"description":"Project ID. Pass null or omit to create the folder under the KB."},"name":{"type":"string","description":"Folder name (relative; supports nested paths via \'/\')"}},"required":["name"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"delete_folder","description":"DESTRUCTIVE — recursively delete a folder under the KB AND every file inside it (disk + FTS rows). REFUSES (returns isError) when `project_id` is supplied: deleting inside a registered project would race the file watcher and re-ingest the contents — remove project content via your editor instead. Same name validation as `create_folder`. Not recoverable from Kontexta after the call (only the git backup, if configured, retains it). No external auth or rate limits. Returns `{success: true}`.","inputSchema":{"type":"object","properties":{"project_id":{"type":["number","null"],"description":"Project ID. Pass null or omit to delete from the KB. Project IDs are rejected."},"name":{"type":"string","description":"Folder name (relative)"}},"required":["name"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"move_file","description":"Move/rename a file. Destination \'new_path\' must be absolute and resolve INSIDE the file\'s owning project or global knowledge directory. Cross-project moves are rejected. Operates locally with no auth or limits. Parameters: \'file_id\' is a valid file ID. \'new_path\' is an absolute path.","inputSchema":{"type":"object","properties":{"file_id":{"type":"number","description":"File ID"},"new_path":{"type":"string","description":"Absolute destination path"}},"required":["file_id","new_path"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"find_related","description":"Find other files sharing tags with the given file, ranked by `shared_tag_count` descending. Read-only; no side effects, auth, or rate limits. Returns annotated file rows with `shared_tag_count` and `shared_tags`. Empty result means the file has no tags or no other file shares them — try `search`/`regex_search` for content-based discovery, or `suggest_tags` to bootstrap labels first. Default limit 10.","inputSchema":{"type":"object","properties":{"file_id":{"type":"number","description":"ID of the file to find relations for"},"limit":{"type":"number","description":"Maximum number of related files to return (default 10)"}},"required":["file_id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"create_files","description":"Batch variant of `create_file` — create up to 200 markdown or mermaid files in one call. Each item follows the same rules (project_id required if destination is `project` or `kontexta`). SIDE EFFECTS: writes new files to disk and inserts FTS5 rows; missing folders are mkdir\'d. Per-item failures are isolated to `errors[]` and the rest of the batch still commits — partial success is the norm, always inspect `error_count`. No external auth or rate limits. Returns `{created_count, error_count, created, errors}`. Use for bulk ingestion; for >200 items, page yourself. Pass format=\'mmd\' on an item to create a Mermaid diagram file (.mmd); defaults to \'md\'.","inputSchema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"content":{"type":"string"},"destination":{"type":"string","enum":["knowledge","project","kontexta"]},"project_id":{"type":"number"},"folder":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"format":{"type":"string","enum":["md","mmd"]}},"required":["title","content","destination"],"additionalProperties":false},"minItems":1,"maxItems":200,"description":"Files to create (max 200 per call)"}},"required":["files"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"delete_files","description":"DESTRUCTIVE batch — delete up to 500 files by ID in one call. Same physical-deletion rules as `delete_file` (KB files unlinked from disk; project reference files only de-indexed). Per-ID failures isolated to `errors[]`; the batch keeps going — partial success is the norm. Not idempotent — unknown IDs surface as per-item errors. No external auth or rate limits. Returns `{deleted_count, error_count, deleted, errors}`. To preview the set before deleting, run `list_files` with the same filter and confirm the IDs.","inputSchema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"number"},"minItems":1,"maxItems":500,"description":"File IDs to delete (max 500 per call)"}},"required":["ids"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"tag_search_results","description":"Bulk-tag — run an FTS `search` and append `add_tags` to every matching file in one call. Side effect: each match gets `addTags` applied (additive, idempotent per tag); the matched files themselves are NOT modified beyond their tag links. Per-file failures isolated to `errors[]`. No external auth or rate limits. There is NO dry-run flag, so ALWAYS run `search` with the same query first to verify the match set before tagging. The `tags[]` filter requires existing tags to ALL match (it scopes the search; it does not control which tags get added). Returns `{matched_count, tagged_count, tags_applied, tagged_ids, errors}`.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Full-text search query"},"add_tags":{"type":"array","items":{"type":"string"},"minItems":1,"description":"Tags to add to every matching file"},"project_id":{"type":["number","null"]},"tags":{"type":"array","items":{"type":"string"},"description":"Filter — only matches that already carry ALL of these tags"},"favorite":{"type":"boolean"}},"required":["query","add_tags"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"read_file_by_path","description":"Look up a file by its absolute on-disk path and return the same shape as `read_file`. The path must EXACTLY match what Kontexta indexed — no symlink resolution, no path normalisation beyond what the OS does, no trailing-slash tolerance. Returns isError if no row matches (the file may exist on disk but not be indexed — try `refresh_index`). Read-only; no side effects, auth, or rate limits. Use when an agent has a path from its working directory but no file ID; if you have the ID, prefer `read_file`.","inputSchema":{"type":"object","properties":{"path":{"type":"string","description":"Absolute path on disk (must match the path stored in Kontexta)"}},"required":["path"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"stats","description":"Aggregate counts for a scope: `file_count`, `untagged_count`, `favorite_count`, `top_tags`. With `project_id` omitted (everything), also returns `by_project` breakdown. `include_token_total: true` stat()s every matching file on disk to compute a body-size estimate — measurably slower on large vaults; default false. `project_id: null` = KB only; omit = all. Read-only; no side effects, auth, or rate limits. Use as a cheap dashboard or to spot untagged content for cleanup; for live disk-vs-index drift use `diff_against_disk`.","inputSchema":{"type":"object","properties":{"project_id":{"type":["number","null"],"description":"Filter to a single project. Pass null for KB-only. Omit for everything."},"top_tags":{"type":"integer","exclusiveMinimum":0,"maximum":100,"description":"How many top tags to return (default 10)"},"include_token_total":{"type":"boolean","description":"If true, stat every matching file on disk to compute total est_tokens. Default false (cheap)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"suggest_tags","description":"Propose tags for a file by mining the existing tag corpus via FTS — picks distinctive terms from the file (≥4 chars, stopword-filtered) and returns tags applied to other files that score high on those terms. No LLM, no network. Already-applied tags are excluded so the suggestions are net-new. Read-only; no side effects, auth, or rate limits. Returns `{file_id, path, existing_tags, suggestions: [{tag, score, sources}]}`. Empty suggestions = no distinctive terms or no overlap with the existing taxonomy yet — bootstrap with `add_tags` first. Default limit 10, max 50. Suggestions are NOT auto-applied.","inputSchema":{"type":"object","properties":{"file_id":{"type":"number","description":"File ID to suggest tags for"},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":50,"description":"Max suggestions to return (default 10)"}},"required":["file_id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"diff_against_disk","description":"Diagnose drift between one file\'s disk content and its FTS index. Status is one of `in_sync`, `diverged`, `disk_unreadable`, or `no_index_row`. On divergence returns sizes, line counts, the first divergent line number, and the disk vs index sample for that line — NOT a full diff (use `get_diff` for full diffs between commits). Read-only; no side effects, auth, or rate limits. Use when search results look stale; if status is `diverged` or `no_index_row`, run `refresh_index` to fix.","inputSchema":{"type":"object","properties":{"file_id":{"type":"number","description":"File ID"}},"required":["file_id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"refresh_index","description":"Reconcile the FTS index against disk. For a project (`project_id` set), re-runs `discoverFiles`. For the KB (`project_id` null/omitted), walks `knowledge/`, ingests new .md files, reindexes any whose content hash drifted, and PRUNES rows for files no longer on disk. SIDE-EFFECTFUL: writes/updates/deletes file and FTS rows (the prune is destructive on stale index rows but never deletes files from disk). Idempotent — running twice is a near no-op. Skips files >5MB and standard junk dirs (`node_modules`, `.git`, `dist`, `build`, etc.). No external auth or rate limits. Returns `{scope, newly_indexed, refreshed, pruned}`. Use after editing files outside Kontexta, or when `diff_against_disk` reports drift.","inputSchema":{"type":"object","properties":{"project_id":{"type":["number","null"],"description":"Project ID. Pass null or omit to reindex the Knowledge Base."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"whats_new","description":"List files created or modified since a checkpoint. `since` accepts ISO-8601 (`2025-01-15T00:00:00Z`) or relative durations (`1h`, `7d`, `2w`); invalid formats throw. Read-only; no side effects, auth, or rate limits. Returns annotated rows plus aggregate `total_est_tokens` so you can decide what to read next. CAVEAT: hard-deleted files are NOT surfaced — only mtime-driven changes. Defaults: include_tags=true, limit=200. `project_id: null` = KB only; omit = everything. Use at session start to catch up.","inputSchema":{"type":"object","properties":{"since":{"type":"string","description":"ISO 8601 timestamp or relative duration (e.g. \\"1h\\", \\"7d\\", \\"2w\\")."},"project_id":{"type":["number","null"],"description":"Filter to a single project. Pass null for knowledge-base-only files. Omit for all."},"include_tags":{"type":"boolean","description":"Attach tags[] to each file. Default true."},"limit":{"type":"number","description":"Max files returned. Default 200."}},"required":["since"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"project_map","description":"Return a compact indented outline of folders, file titles, tags, and IDs in a single dense block — substantially fewer tokens than the equivalent `list_files` JSON for the same scope. Read-only; no side effects, auth, or rate limits. Capped at `max_lines` (default 5000); the response reports `est_tokens` and emits a `warning` field if it exceeds `KONTEXTA_PROJECT_TOKEN_WARN`. `project_id: null` = KB only; omit = everything. Defaults: include_tags=true, show_titles=true. Use to orient yourself in an unfamiliar vault or project; for keyword lookup use `search`.","inputSchema":{"type":"object","properties":{"project_id":{"type":["number","null"],"description":"Restrict to a single project. Pass null for knowledge-base-only files. Omit for everything."},"include_tags":{"type":"boolean","description":"Append #tags inline. Default true. Set false to shrink the outline."},"show_titles":{"type":"boolean","description":"Show file titles instead of filenames. Default true."},"max_lines":{"type":"number","description":"Hard cap on output lines (each line ≈ one folder or file). Default 5000."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"list_hands","description":"List every Hands command tool currently registered, with project scope, tool name, danger level, confirmation flag, and description. Hands tools come from per-project `kontexta.json` files loaded at register time. Read-only; no side effects, auth, or rate limits. Use to discover what side-effectful project commands the agent is permitted to run; for the `kontexta.json` schema see `describe_hands_schema`; reload after editing one with `reload_hands`.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{}},"execution":{"taskSupport":"forbidden"}},{"name":"reload_hands","description":"Re-scan every registered project\'s `kontexta.json` and rebuild the live Hands tool registry — newly-declared tools become callable immediately, removed tools disappear from `tools/list`. SIDE EFFECT is on the running MCP session\'s tool inventory only (no disk writes). Idempotent. No external auth or rate limits. Takes no parameters. Returns per-project load results (counts of registered/disabled tools and any validation warnings). Use after editing a `kontexta.json` mid-session; for the schema see `describe_hands_schema`.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{}},"execution":{"taskSupport":"forbidden"}},{"name":"confirm_hand","description":"Approve and EXECUTE a previously-issued Hands invocation by its single-use approval token. The token is returned by any confirm-required Hands tool; tokens expire after 60 seconds and CANNOT be reused. Side effect equals whatever the underlying Hand does — this can be highly destructive (running arbitrary shell commands, modifying files, etc.), so only call when the user has authorised the pending action. The token IS the auth (no external auth, no rate limits). Invalid, expired, or already-consumed tokens return an inert text response, NOT an error.","inputSchema":{"type":"object","properties":{"token":{"type":"string","description":"The approval token from the pending response"}},"required":["token"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"describe_hands_schema","description":"Return the complete authoring reference for `kontexta.json`: JSON schema, validation rules, security guarantees, limitations, and an annotated example. Static document — does not read any project file or DB row. Read-only; no side effects, auth, or rate limits. Takes no parameters. Use when helping a user write or fix a `kontexta.json`; to see the loaded tools themselves use `list_hands`; to apply edits use `reload_hands`.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{}},"execution":{"taskSupport":"forbidden"}},{"name":"get_profile","description":"Return the user profile stored in the Knowledge Base. The profile helps AI agents understand the user\'s context, role, preferences, and goals. Read-only; no side effects, auth, or rate limits. Returns existence status, full content, list of missing required sections, and a hint for new users. Use at session start to understand who you\'re working with.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{}},"execution":{"taskSupport":"forbidden"}},{"name":"journal_note","description":"Record a free-form decision/abandonment/observation note in the current project\'s journal. Stored as an `agent_note` event in Layer 1; surfaces in distilled task entries.","inputSchema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"description":"Body of the note (markdown allowed)."},"tags":{"type":"array","items":{"type":"string"},"description":"Optional tags for the note."}},"required":["text"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"journal_intent","description":"Record a topic/intent pivot. Use when the user redirects what you\'re working on; the distillation step uses this to split task buckets correctly.","inputSchema":{"type":"object","properties":{"summary":{"type":"string","minLength":1,"description":"One-line summary of the new intent."}},"required":["summary"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"distill_journal","description":"Run the distillation pipeline: read raw events since the high-water mark, group by topic, write mechanical markdown entries, advance high-water. Idempotent. Auto-provisions a project row for orphan slugs (e.g. `default`) that have no registered project yet.","inputSchema":{"type":"object","properties":{"project_slug":{"type":"string"},"max_events":{"type":"integer","exclusiveMinimum":0,"maximum":2000}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"journal_status","description":"Report the journal backlog and high-water mark for a project.","inputSchema":{"type":"object","properties":{"project_slug":{"type":"string"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"distill_journal_commit_upgrades","description":"After dispatching subagents to upgrade mechanical journal entries to LLM-narrative, call this with the affected task slugs. Updates journal_meta.status_latest to mark the entries as upgraded.","inputSchema":{"type":"object","properties":{"task_slugs":{"type":"array","items":{"type":"string"},"minItems":1,"description":"Task slugs whose entries were upgraded by subagents."}},"required":["task_slugs"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"housekeep_journal","description":"Run journal retention/archival for a project. Idempotent. Prunes old raw .jsonl files and archives cold tasks per the configured retention policy.","inputSchema":{"type":"object","properties":{"project_slug":{"type":"string"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"calendar_add_entity","description":"SIDE-EFFECTFUL. Create a new tracked entity — any named thing you schedule events against (a server, a delivery van, a store location, a piece of equipment, a room, etc.). Not idempotent: a duplicate name (case-insensitive) throws. Returns `{entity}`. Use `calendar_link_entities` afterwards to record dependencies for conflict detection.","inputSchema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Unique display name for the entity (case-insensitive)."},"kind":{"type":"string","description":"Freeform category, e.g. \'server\', \'vehicle\', \'location\', \'equipment\'."},"notes":{"type":"string","description":"Freeform notes."},"timezone":{"type":"string","description":"Optional IANA timezone (e.g. \'Europe/Berlin\') for display only — does not affect stored event times."}},"required":["name"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"calendar_update_entity","description":"SIDE-EFFECTFUL. Patch an existing entity\'s fields, including `active` (set false to soft-retire it without losing its history). Idempotent per patch. Returns `{entity}`. For a hard delete see `calendar_delete_entity`.","inputSchema":{"type":"object","properties":{"id":{"type":"integer","description":"Entity id (from `calendar_add_entity` or `calendar_list_entities`)."},"name":{"type":"string","minLength":1},"kind":{"type":["string","null"]},"notes":{"type":["string","null"]},"timezone":{"type":["string","null"]},"active":{"type":"boolean"}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"calendar_delete_entity","description":"DESTRUCTIVE. Permanently delete an entity AND cascade-delete every event and link attached to it. Not idempotent — deleting an unknown id throws. Returns `{success, deleted_events, deleted_links}`. To deactivate without losing history, use `calendar_update_entity` with `active: false` instead.","inputSchema":{"type":"object","properties":{"id":{"type":"integer","description":"Entity id to delete."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"calendar_list_entities","description":"Read-only; no side effects, auth, or rate limits. List tracked entities, each annotated with its outgoing and incoming dependency links. Returns `{entities, count}`.","inputSchema":{"type":"object","properties":{"active_only":{"type":"boolean","description":"If true, exclude retired (active=false) entities."},"kind":{"type":"string","description":"Filter to entities with this exact `kind`."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"calendar_link_entities","description":"SIDE-EFFECTFUL. Create or update a directed dependency edge between two entities (e.g. \\"A feeds B\\"), or remove one with `remove: true`. Idempotent — upserts the label on repeat calls; removing an absent link is a no-op. Used by `calendar_conflicts`/`calendar_list_events` to flag overlaps across connected entities (one hop, either direction). Returns `{link}` or `{removed}`.","inputSchema":{"type":"object","properties":{"from":{"type":"string","description":"Source entity — name (case-insensitive) or numeric id."},"to":{"type":"string","description":"Target entity — name (case-insensitive) or numeric id."},"label":{"type":"string","description":"Freeform label for the relationship, e.g. \'feeds\', \'depends on\'."},"remove":{"type":"boolean","description":"If true, remove the link instead of creating/updating it."}},"required":["from","to"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"calendar_add_event","description":"SIDE-EFFECTFUL. Add a one-off time window (downtime, maintenance, a delivery, a shift, an inspection, etc.) to an entity. NOT idempotent — calling this twice creates two events. `starts_at`/`ends_at` must be ISO 8601 with an explicit timezone (`Z` or `\xb1HH:MM`) — naive timestamps are rejected because their meaning would be ambiguous once stored as UTC. Returns `{event}`. Follow up with `calendar_conflicts` to check for overlaps.","inputSchema":{"type":"object","properties":{"entity":{"type":"string","description":"Entity the event applies to — name (case-insensitive) or numeric id."},"type":{"type":"string","minLength":1,"description":"Freeform event type, e.g. \'downtime\', \'maintenance\', \'delivery\', \'shift\'."},"title":{"type":"string","minLength":1,"description":"Short title for the event."},"starts_at":{"type":"string","description":"ISO 8601 timestamp with explicit timezone, e.g. \'2026-08-03T02:00:00+05:30\'."},"ends_at":{"type":"string","description":"ISO 8601 timestamp with explicit timezone; must be after starts_at."},"notes":{"type":"string"},"original_timezone":{"type":"string","description":"IANA timezone the window was originally communicated in, for display."},"source":{"type":"string","description":"Freeform provenance, e.g. \'email from ops team\'."}},"required":["entity","type","title","starts_at","ends_at"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"calendar_update_event","description":"SIDE-EFFECTFUL. Patch an existing event (move it, retitle it, re-home it to a different entity, etc.). The merged result is re-validated — shrinking `ends_at` below `starts_at` throws. Returns `{event}`.","inputSchema":{"type":"object","properties":{"id":{"type":"integer","description":"Event id."},"entity":{"type":"string","description":"Move the event to a different entity — name or numeric id."},"type":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"starts_at":{"type":"string","description":"ISO 8601 timestamp with explicit timezone."},"ends_at":{"type":"string","description":"ISO 8601 timestamp with explicit timezone."},"notes":{"type":["string","null"]},"original_timezone":{"type":["string","null"]},"source":{"type":["string","null"]}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"calendar_delete_event","description":"DESTRUCTIVE. Delete one event by id. Idempotent — deleting an already-absent id is a no-op. Returns `{success, existed}`.","inputSchema":{"type":"object","properties":{"id":{"type":"integer","description":"Event id to delete."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"calendar_list_events","description":"Read-only; no side effects, auth, or rate limits. List events overlapping a window (half-open — an event ending exactly at `from` is excluded), optionally filtered by entity/type. Set `include_conflicts` to also run conflict detection over the same window and attach it. Returns `{events, count, conflicts?}`. For conflicts alone, prefer `calendar_conflicts`.","inputSchema":{"type":"object","properties":{"from":{"type":"string","description":"Window start, ISO 8601 with explicit timezone."},"to":{"type":"string","description":"Window end, ISO 8601 with explicit timezone."},"entity":{"type":"string","description":"Filter to one entity — name or numeric id."},"type":{"type":"string","description":"Filter to an exact event type."},"limit":{"type":"integer","exclusiveMinimum":0,"description":"Max rows (default 500)."},"include_conflicts":{"type":"boolean","description":"If true, also compute conflicts for `from`..`to` (both required when set) and include them in the response."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"calendar_conflicts","description":"Read-only; no side effects, auth, or rate limits. Report scheduling conflicts in a window: overlaps on the same entity (`overlap`), overlaps between linked entities one hop apart (`linked_overlap`), and gaps smaller than a minimum buffer (`insufficient_buffer`). Computed on demand — nothing is persisted. Buffer defaults to the `calendar.min_buffer_minutes` setting (0 = off); pass `buffer_minutes` to override for this call. Returns `{conflicts, count, buffer_minutes, events_considered}`. See also `calendar_list_events` with `include_conflicts`.","inputSchema":{"type":"object","properties":{"from":{"type":"string","description":"Window start, ISO 8601 with explicit timezone."},"to":{"type":"string","description":"Window end, ISO 8601 with explicit timezone."},"entity":{"type":"string","description":"Scope to one entity (and its linked neighbors) — name or numeric id."},"buffer_minutes":{"type":"integer","minimum":0,"description":"Override the configured minimum gap between events, in minutes. 0 disables buffer checks."}},"required":["from","to"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}},{"name":"calendar_export_ics","description":"Read-only; no side effects, auth, or rate limits. Export events in a window as an RFC 5545 ICS calendar (UTC times, no VTIMEZONE needed) for import into Outlook/Calendar apps. Returns `{ics, event_count}` with the calendar text as a JSON string field.","inputSchema":{"type":"object","properties":{"from":{"type":"string","description":"Window start, ISO 8601 with explicit timezone."},"to":{"type":"string","description":"Window end, ISO 8601 with explicit timezone."},"entity":{"type":"string","description":"Filter to one entity — name or numeric id."},"calendar_name":{"type":"string","description":"Calendar display name (X-WR-CALNAME). Defaults to \'Kontexta Calendar\'."}},"required":["from","to"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"execution":{"taskSupport":"forbidden"}}]}'),x=["Read","Write","Search","Tags & Favorites","Folders & Projects","Versioning","Discovery","Calendar","Hands"],y={read_file:"Read",read_files:"Read",read_file_lines:"Read",read_file_outline:"Read",read_section:"Read",read_file_by_path:"Read",describe_file:"Read",list_files:"Read",get_profile:"Read",list_folders:"Folders & Projects",list_projects:"Folders & Projects",list_tags:"Tags & Favorites",create_file:"Write",create_files:"Write",update_file:"Write",update_file_section:"Write",delete_file:"Write",delete_files:"Write",move_file:"Write",create_folder:"Folders & Projects",delete_folder:"Folders & Projects",register_project:"Folders & Projects",onboard_agent:"Folders & Projects",transfer_agent_context:"Folders & Projects",journal_note:"Write",journal_intent:"Write",journal_append:"Write",distill_journal:"Write",journal_status:"Discovery",housekeep_journal:"Write",distill_journal_commit_upgrades:"Write",clip_url:"Write",search:"Search",bundle_search:"Search",regex_search:"Search",grep_in_file:"Search",find_related:"Search",add_tags:"Tags & Favorites",remove_tags:"Tags & Favorites",set_favorite:"Tags & Favorites",tag_search_results:"Tags & Favorites",suggest_tags:"Tags & Favorites",get_history:"Versioning",get_diff:"Versioning",restore_file:"Versioning",commit_backup:"Versioning",stats:"Discovery",whats_new:"Discovery",project_map:"Discovery",diff_against_disk:"Discovery",refresh_index:"Discovery",calendar_add_entity:"Calendar",calendar_update_entity:"Calendar",calendar_delete_entity:"Calendar",calendar_list_entities:"Calendar",calendar_link_entities:"Calendar",calendar_add_event:"Calendar",calendar_update_event:"Calendar",calendar_delete_event:"Calendar",calendar_list_events:"Calendar",calendar_conflicts:"Calendar",calendar_export_ics:"Calendar",list_hands:"Hands",reload_hands:"Hands",confirm_hand:"Hands",describe_hands_schema:"Hands"};async function z(a){if(!(0,u.T5)(a))return new v.NextResponse("Unauthorized",{status:401});let b=w.Y.map(a=>({...a,category:y[a.name]??"Discovery"}));return v.NextResponse.json({generatedAt:w.r,categoryOrder:x,tools:b})}let A=new e.AppRouteRouteModule({definition:{kind:f.RouteKind.APP_ROUTE,page:"/api/mcp-tools/route",pathname:"/api/mcp-tools",filename:"route",bundlePath:"app/api/mcp-tools/route"},distDir:".next",relativeProjectDir:"",resolvedPagePath:"/Users/safiyudeen.saidumuha/projects/kontexta/apps/web/src/app/api/mcp-tools/route.ts",nextConfigOutput:"standalone",userland:d}),{workAsyncStorage:B,workUnitAsyncStorage:C,serverHooks:D}=A;function E(){return(0,g.patchFetch)({workAsyncStorage:B,workUnitAsyncStorage:C})}async function F(a,b,c){var d;let e="/api/mcp-tools/route";"/index"===e&&(e="/");let g=await A.prepare(a,b,{srcPage:e,multiZoneDraftMode:!1});if(!g)return b.statusCode=400,b.end("Bad Request"),null==c.waitUntil||c.waitUntil.call(c,Promise.resolve()),null;let{buildId:u,params:v,nextConfig:w,isDraftMode:x,prerenderManifest:y,routerServerContext:z,isOnDemandRevalidate:B,revalidateOnlyGenerated:C,resolvedPathname:D}=g,E=(0,j.normalizeAppPath)(e),F=!!(y.dynamicRoutes[E]||y.routes[D]);if(F&&!x){let a=!!y.routes[D],b=y.dynamicRoutes[E];if(b&&!1===b.fallback&&!a)throw new s.NoFallbackError}let G=null;!F||A.isDev||x||(G="/index"===(G=D)?"/":G);let H=!0===A.isDev||!F,I=F&&!H,J=a.method||"GET",K=(0,i.getTracer)(),L=K.getActiveScopeSpan(),M={params:v,prerenderManifest:y,renderOpts:{experimental:{cacheComponents:!!w.experimental.cacheComponents,authInterrupts:!!w.experimental.authInterrupts},supportsDynamicResponse:H,incrementalCache:(0,h.getRequestMeta)(a,"incrementalCache"),cacheLifeProfiles:null==(d=w.experimental)?void 0:d.cacheLife,isRevalidate:I,waitUntil:c.waitUntil,onClose:a=>{b.on("close",a)},onAfterTaskError:void 0,onInstrumentationRequestError:(b,c,d)=>A.onRequestError(a,b,d,z)},sharedContext:{buildId:u}},N=new k.NodeNextRequest(a),O=new k.NodeNextResponse(b),P=l.NextRequestAdapter.fromNodeNextRequest(N,(0,l.signalFromNodeResponse)(b));try{let d=async c=>A.handle(P,M).finally(()=>{if(!c)return;c.setAttributes({"http.status_code":b.statusCode,"next.rsc":!1});let d=K.getRootSpanAttributes();if(!d)return;if(d.get("next.span_type")!==m.BaseServerSpan.handleRequest)return void console.warn(`Unexpected root span type '${d.get("next.span_type")}'. Please report this Next.js issue https://github.com/vercel/next.js`);let e=d.get("next.route");if(e){let a=`${J} ${e}`;c.setAttributes({"next.route":e,"http.route":e,"next.span_name":a}),c.updateName(a)}else c.updateName(`${J} ${a.url}`)}),g=async g=>{var i,j;let k=async({previousCacheEntry:f})=>{try{if(!(0,h.getRequestMeta)(a,"minimalMode")&&B&&C&&!f)return b.statusCode=404,b.setHeader("x-nextjs-cache","REVALIDATED"),b.end("This page could not be found"),null;let e=await d(g);a.fetchMetrics=M.renderOpts.fetchMetrics;let i=M.renderOpts.pendingWaitUntil;i&&c.waitUntil&&(c.waitUntil(i),i=void 0);let j=M.renderOpts.collectedTags;if(!F)return await (0,o.I)(N,O,e,M.renderOpts.pendingWaitUntil),null;{let a=await e.blob(),b=(0,p.toNodeOutgoingHttpHeaders)(e.headers);j&&(b[r.NEXT_CACHE_TAGS_HEADER]=j),!b["content-type"]&&a.type&&(b["content-type"]=a.type);let c=void 0!==M.renderOpts.collectedRevalidate&&!(M.renderOpts.collectedRevalidate>=r.INFINITE_CACHE)&&M.renderOpts.collectedRevalidate,d=void 0===M.renderOpts.collectedExpire||M.renderOpts.collectedExpire>=r.INFINITE_CACHE?void 0:M.renderOpts.collectedExpire;return{value:{kind:t.CachedRouteKind.APP_ROUTE,status:e.status,body:Buffer.from(await a.arrayBuffer()),headers:b},cacheControl:{revalidate:c,expire:d}}}}catch(b){throw(null==f?void 0:f.isStale)&&await A.onRequestError(a,b,{routerKind:"App Router",routePath:e,routeType:"route",revalidateReason:(0,n.c)({isRevalidate:I,isOnDemandRevalidate:B})},z),b}},l=await A.handleResponse({req:a,nextConfig:w,cacheKey:G,routeKind:f.RouteKind.APP_ROUTE,isFallback:!1,prerenderManifest:y,isRoutePPREnabled:!1,isOnDemandRevalidate:B,revalidateOnlyGenerated:C,responseGenerator:k,waitUntil:c.waitUntil});if(!F)return null;if((null==l||null==(i=l.value)?void 0:i.kind)!==t.CachedRouteKind.APP_ROUTE)throw Object.defineProperty(Error(`Invariant: app-route received invalid cache entry ${null==l||null==(j=l.value)?void 0:j.kind}`),"__NEXT_ERROR_CODE",{value:"E701",enumerable:!1,configurable:!0});(0,h.getRequestMeta)(a,"minimalMode")||b.setHeader("x-nextjs-cache",B?"REVALIDATED":l.isMiss?"MISS":l.isStale?"STALE":"HIT"),x&&b.setHeader("Cache-Control","private, no-cache, no-store, max-age=0, must-revalidate");let m=(0,p.fromNodeOutgoingHttpHeaders)(l.value.headers);return(0,h.getRequestMeta)(a,"minimalMode")&&F||m.delete(r.NEXT_CACHE_TAGS_HEADER),!l.cacheControl||b.getHeader("Cache-Control")||m.get("Cache-Control")||m.set("Cache-Control",(0,q.getCacheControlHeader)(l.cacheControl)),await (0,o.I)(N,O,new Response(l.value.body,{headers:m,status:l.value.status||200})),null};L?await g(L):await K.withPropagatedContext(a.headers,()=>K.trace(m.BaseServerSpan.handleRequest,{spanName:`${J} ${a.url}`,kind:i.SpanKind.SERVER,attributes:{"http.method":J,"http.target":a.url}},g))}catch(b){if(b instanceof s.NoFallbackError||await A.onRequestError(a,b,{routerKind:"App Router",routePath:E,routeType:"route",revalidateReason:(0,n.c)({isRevalidate:I,isOnDemandRevalidate:B})}),F)throw b;return await (0,o.I)(N,O,new Response(null,{status:500})),null}}},44870:a=>{"use strict";a.exports=require("next/dist/compiled/next-server/app-route.runtime.prod.js")},63033:a=>{"use strict";a.exports=require("next/dist/server/app-render/work-unit-async-storage.external.js")},76727:()=>{},77598:a=>{"use strict";a.exports=require("node:crypto")},86439:a=>{"use strict";a.exports=require("next/dist/shared/lib/no-fallback-error.external")}};var b=require("../../../webpack-runtime.js");b.C(a);var c=b.X(0,[2923,9372],()=>b(b.s=35783));module.exports=c})();