@octocodeai/octocode-tools-core 18.1.2 → 18.2.0

package/dist/shared/session/index.js

@@ -5,4 +5,4 @@ import { dirname as __dirname_fn } from 'path';
 const require = __createRequire(import.meta.url);
 const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_fn(__filename);
-import{randomUUID as nt}from"node:crypto";import{existsSync as M,readFileSync as Se,writeFileSync as Ye,unlinkSync as Ze,renameSync as Qe}from"node:fs";import{isStatsEnabled as ge}from"@octocodeai/config";function p(e){return e.toLowerCase().replace(/^https?:\/\//,"").replace(/\/$/,"")}function w(e){if(!e.token.expiresAt)return!1;let t=new Date(e.token.expiresAt);if(isNaN(t.getTime()))return!0;let r=new Date;return t.getTime()-r.getTime()<300*1e3}function B(e){if(!e.token.refreshTokenExpiresAt)return!1;let t=new Date(e.token.refreshTokenExpiresAt);return isNaN(t.getTime())?!0:new Date>=t}var P=new Map,ve=300*1e3;function Re(e){let t=p(e),r=P.get(t);return!r||Date.now()-r.cachedAt>=ve?!1:r.credentials?!w(r.credentials):!0}function q(e){e?P.delete(p(e)):P.clear()}function V(e){let t=p(e);if(Re(t))return P.get(t).credentials}function Y(e,t){let r=p(e);P.set(r,{credentials:t,cachedAt:Date.now()})}import{existsSync as X,readFileSync as ee,writeFileSync as te,unlinkSync as _t,statSync as He,chmodSync as Oe}from"node:fs";import{createCipheriv as De,createDecipheriv as Ie,randomBytes as re}from"node:crypto";import{existsSync as be,mkdirSync as we}from"node:fs";import{join as u}from"node:path";import{getOctocodeHome as Pe}from"@octocodeai/config";var Ee=448;function Ae(){return Pe(process.env)}var c=Ae(),d={home:c,config:u(c,".octocoderc"),credentials:u(c,"credentials.json"),key:u(c,".key"),session:u(c,"session.json"),stats:u(c,"stats.json"),tmp:u(c,"tmp"),clone:u(c,"tmp","clone"),tree:u(c,"tmp","tree"),repos:u(c,"tmp","clone"),cliConfig:u(c,"config.json"),lspConfig:u(c,"lsp-servers.json")};function Z(){be(d.home)||we(d.home,{recursive:!0,mode:Ee})}import{z as a}from"zod";var Le=a.object({token:a.string(),tokenType:a.literal("oauth"),scopes:a.array(a.string()).optional(),refreshToken:a.string().optional(),expiresAt:a.string().optional(),refreshTokenExpiresAt:a.string().optional()}),Fe=a.object({hostname:a.string(),username:a.string(),token:Le,gitProtocol:a.enum(["ssh","https"]),createdAt:a.string(),updatedAt:a.string()}),Q=a.object({version:a.number(),credentials:a.record(a.string(),Fe)});var _e=d.home,D=d.credentials,T=d.key,se="aes-256-gcm",Ge=16;function y(){Z()}function ne(){if(y(),X(T))return He(T).mode&511&63&&Oe(T,384),Buffer.from(ee(T,"utf8"),"hex");let e=re(32);return te(T,e.toString("hex"),{mode:384}),e}function oe(e){let t=ne(),r=re(Ge),s=De(se,t,r),n=s.update(e,"utf8","hex");n+=s.final("hex");let i=s.getAuthTag();return`${r.toString("hex")}:${i.toString("hex")}:${n}`}function ie(e){let t=ne(),[r,s,n]=e.split(":");if(!r||!s||!n)throw new Error("Invalid encrypted data format");let i=Buffer.from(r,"hex"),k=Buffer.from(s,"hex"),h=Ie(se,t,i);h.setAuthTag(k);let J=h.update(n,"hex","utf8");return J+=h.final("utf8"),J}function N(){if(y(),!X(D))return{version:1,credentials:{}};try{let e=ee(D,"utf8"),t=ie(e),r=JSON.parse(t),s=Q.safeParse(r);return s.success?s.data:{version:1,credentials:{}}}catch{return{version:1,credentials:{}}}}function ae(e){y();let t=oe(JSON.stringify(e,null,2));te(D,t,{mode:384})}import{refreshToken as Ue}from"@octokit/oauth-methods";import{request as je}from"@octokit/request";var I="178c6fc778ccc68e1d6a",E="github.com";function Be(e){return e.replace(/\b(ghp_|gho_|ghu_|ghs_|ghr_)[a-zA-Z0-9]{36,}\b/g,"***MASKED***").replace(/\b[a-zA-Z0-9]{40,}\b/g,"***MASKED***")}function Ne(e){return e==="github.com"||e===E?"https://api.github.com":`https://${e}/api/v3`}async function ce(e,t=E,r=I){let s=await e.getCredentials(t);if(!s)return{success:!1,error:`Not logged in to ${t}`};if(!s.token.refreshToken)return{success:!1,error:"Token does not support refresh (OAuth App tokens do not expire)"};if(B(s))return{success:!1,error:"Refresh token has expired. Please login again."};try{let n=await Ue({clientType:"github-app",clientId:r,clientSecret:"",refreshToken:s.token.refreshToken,request:je.defaults({baseUrl:Ne(t)})}),i={token:n.authentication.token,tokenType:"oauth",refreshToken:n.authentication.refreshToken,expiresAt:n.authentication.expiresAt,refreshTokenExpiresAt:n.authentication.refreshTokenExpiresAt};return await e.updateToken(t,i),{success:!0,username:s.username,hostname:t}}catch(n){return{success:!1,error:n instanceof Error?Be(n.message):"Token refresh failed"}}}async function ue(e,t=E,r=I){let s=await e.getCredentials(t);if(!s||!s.token)return{token:null,source:"none"};if(!w(s))return{token:s.token.token,source:"stored",username:s.username};if(s.token.refreshToken){let n=await ce(e,t,r);if(n.success){let i=await e.getCredentials(t);if(i?.token.token)return{token:i.token.token,source:"refreshed",username:i.username}}return{token:null,source:"none",refreshError:n.error}}return{token:null,source:"none",refreshError:"Token expired and no refresh token available"}}import{resolveEnvToken as Qt}from"@octocodeai/config";import{execFile as qt}from"child_process";var Me=null;function le(e){Me=e}async function ze(e){let t=p(e.hostname),r={...e,hostname:t,updatedAt:new Date().toISOString()};try{let s=N();return s.credentials[t]=r,ae(s),q(t),{success:!0}}catch{throw new Error("Failed to store credentials")}}async function de(e="github.com",t){let r=p(e);if(!t?.bypassCache){let i=V(r);if(i!==void 0)return i}let n=N().credentials[r]||null;return Y(r,n),n}async function We(e,t){let r=await de(e);return r?(r.token=t,r.updatedAt=new Date().toISOString(),await ze(r),!0):!1}async function $e(e,t){return ue({getCredentials:de,updateToken:We},e,t)}le({getTokenWithRefresh:$e});import{z as o}from"zod";var Ke=o.object({rawChars:o.number(),responseChars:o.number(),savedChars:o.number(),calls:o.number()}),Je=o.object({hits:o.record(o.string(),o.number()).default({}),rateLimits:o.number().default(0)}),_=o.record(o.string(),o.number()).default({}),qe=o.object({toolCalls:o.number(),errors:o.number(),rateLimits:o.number(),rateLimitsByProvider:_,rawChars:o.number(),responseChars:o.number(),savedChars:o.number(),charSavingsCalls:o.number(),githubCacheHits:o.number(),githubCacheRateLimits:o.number(),packageRegistryFailures:o.number().default(0),packageRegistryFailuresByRegistry:_}),G=o.object({toolCalls:o.number(),errors:o.number(),rateLimits:o.number(),rateLimitsByProvider:_,charsSavedByTool:o.record(o.string(),Ke).default({}),githubCacheHits:Je.default({hits:{},rateLimits:0}),packageRegistryFailures:_,totalUsage:qe.optional()}),fe=o.object({version:o.literal(1),sessionId:o.string(),createdAt:o.string(),lastActiveAt:o.string(),stats:G.optional()}),he=o.object({version:o.literal(1),stats:G});function pe(e){return Object.values(e).reduce((t,r)=>t+r,0)}function Ve(e){let t=e.charsSavedByTool??{},r=e.githubCacheHits??{hits:{},rateLimits:0},s=e.rateLimitsByProvider??{},n=e.packageRegistryFailures??{},i=Object.values(t).reduce((k,h)=>({rawChars:k.rawChars+h.rawChars,responseChars:k.responseChars+h.responseChars,savedChars:k.savedChars+h.savedChars,charSavingsCalls:k.charSavingsCalls+h.calls}),{rawChars:0,responseChars:0,savedChars:0,charSavingsCalls:0});return{toolCalls:e.toolCalls,errors:e.errors,rateLimits:e.rateLimits,rateLimitsByProvider:s,...i,githubCacheHits:pe(r.hits),githubCacheRateLimits:r.rateLimits,packageRegistryFailures:pe(n),packageRegistryFailuresByRegistry:n}}function m(e){let t={...e,rateLimitsByProvider:e.rateLimitsByProvider??{},charsSavedByTool:e.charsSavedByTool??{},githubCacheHits:e.githubCacheHits??{hits:{},rateLimits:0},packageRegistryFailures:e.packageRegistryFailures??{}};return{...t,totalUsage:Ve(t)}}function S(){return m({toolCalls:0,errors:0,rateLimits:0,rateLimitsByProvider:{},charsSavedByTool:{},githubCacheHits:{hits:{},rateLimits:0},packageRegistryFailures:{}})}var x=d.session,v=d.stats;function me(e,t){let r=`${e}.tmp`;Ye(r,JSON.stringify(t,null,2),{mode:384}),Qe(r,e)}function Xe(e){let t=JSON.parse(e),r=he.safeParse(t);if(r.success)return m(r.data.stats);let s=G.safeParse(t);return s.success?m(s.data):null}function et(){if(!M(v))return S();try{let e=Se(v,"utf8");return Xe(e)??S()}catch{return S()}}function U(e){y(),ge()&&me(v,{version:e.version,stats:m(e.stats)});let{stats:t,...r}=e;me(x,r)}function Ce(){if(!M(x))return null;try{let e=Se(x,"utf8"),t=JSON.parse(e),r=fe.safeParse(t);return r.success?{...r.data,stats:ge()?et():S()}:null}catch{return null}}function ke(){let e=!1;for(let t of[x,v])if(M(t))try{Ze(t),e=!0}catch{return!1}return e}var tt=6e4,l=null,g=!1,R=null,z=!1,A=null,L=null,F=null,j=!1;function rt(){z||(z=!0,A=()=>{H()},L=()=>{H()},F=()=>{H()},process.on("exit",A),process.on("SIGINT",L),process.on("SIGTERM",F))}function W(){A&&(process.removeListener("exit",A),A=null),L&&(process.removeListener("SIGINT",L),L=null),F&&(process.removeListener("SIGTERM",F),F=null),z=!1}function st(){R||(R=setInterval(()=>{g&&l&&(U(l),g=!1)},tt),R.unref())}function $(){R&&(clearInterval(R),R=null)}function b(){if(l)return l;let e=Ce();return e&&(l=e),e}function C(e){l=e,g=!0,rt(),st()}function O(){g&&l&&(U(l),g=!1)}function H(){if(!j&&g&&l){j=!0;try{U(l),g=!1}catch{}finally{j=!1}}}function K(){l=null,g=!1,j=!1}function Te(){K(),$(),W()}var ot=1;function it(e){return m(e)}function at(e,t){if(!t)return e;let r={...e};for(let[s,n]of Object.entries(t)){let i=r[s]??{rawChars:0,responseChars:0,savedChars:0,calls:0};r[s]={rawChars:i.rawChars+n.rawChars,responseChars:i.responseChars+n.responseChars,savedChars:i.savedChars+n.savedChars,calls:i.calls+n.calls}}return r}function ye(e,t){if(!t)return e;let r={...e};for(let[s,n]of Object.entries(t))r[s]=(r[s]??0)+n;return r}function ct(e,t){if(!t)return e;let r={...e.hits};for(let[s,n]of Object.entries(t.hits??{}))r[s]=(r[s]??0)+n;return{hits:r,rateLimits:e.rateLimits+(t.rateLimits??0)}}function xe(){let e=new Date().toISOString();return{version:ot,sessionId:nt(),createdAt:e,lastActiveAt:e,stats:S()}}function ut(){return b()}function lt(e){C(e)}function dt(){O()}function ft(){H()}function ht(e){if(e?.forceNew){let s=xe();return C(s),O(),s}let t=b();if(t){let s={...t,lastActiveAt:new Date().toISOString()};return C(s),O(),s}let r=xe();return C(r),O(),r}function pt(){return b()?.sessionId??null}function f(e){let t=b();if(!t)return{success:!1,session:null};let r=it(t.stats),s=m({toolCalls:r.toolCalls+(e.toolCalls??0),errors:r.errors+(e.errors??0),rateLimits:r.rateLimits+(e.rateLimits??0),rateLimitsByProvider:ye(r.rateLimitsByProvider,e.rateLimitsByProvider),charsSavedByTool:at(r.charsSavedByTool,e.charsSavedByTool),githubCacheHits:ct(r.githubCacheHits,e.githubCacheHits),packageRegistryFailures:ye(r.packageRegistryFailures,e.packageRegistryFailures)}),n={...t,lastActiveAt:new Date().toISOString(),stats:s};return C(n),{success:!0,session:n}}function mt(e=1){return f({toolCalls:e})}function St(e=1){return f({errors:e})}function gt(e=1){return f({rateLimits:e})}function Ct(e,t=1){return f({rateLimits:t,rateLimitsByProvider:{[e]:t}})}function kt(e,t,r){let s=Number.isFinite(t)?Math.max(0,t):0,n=Number.isFinite(r)?Math.max(0,r):0;return f({charsSavedByTool:{[e]:{rawChars:s,responseChars:n,savedChars:Math.max(0,s-n),calls:1}}})}function Tt(e,t=1){return f({githubCacheHits:{hits:{[e]:t},rateLimits:0}})}function yt(e=1){return f({githubCacheHits:{hits:{},rateLimits:e}})}function xt(e,t=1){return f({packageRegistryFailures:{[e]:t}})}function vt(){let e=b();if(!e)return{success:!1,session:null};let t={...e,lastActiveAt:new Date().toISOString(),stats:S()};return C(t),{success:!0,session:t}}function Rt(){return K(),$(),W(),ke()}function bt(){Te()}export{x as SESSION_FILE,v as STATS_FILE,bt as _resetSessionState,Rt as deleteSession,dt as flushSession,ft as flushSessionSync,ht as getOrCreateSession,pt as getSessionId,St as incrementErrors,Tt as incrementGitHubCacheHits,yt as incrementGitHubCacheRateLimits,xt as incrementPackageRegistryFailures,Ct as incrementRateLimitByProvider,gt as incrementRateLimits,mt as incrementToolCalls,kt as incrementToolCharSavings,ut as readSession,vt as resetSessionStats,f as updateSessionStats,lt as writeSession};
+import{randomUUID as ot}from"node:crypto";import{existsSync as M,readFileSync as Se,writeFileSync as Ze,unlinkSync as Qe,renameSync as Xe}from"node:fs";import{isPersistentStorageEnabled as ge,isStatsEnabled as Ce}from"@octocodeai/config";function p(e){return e.toLowerCase().replace(/^https?:\/\//,"").replace(/\/$/,"")}function w(e){if(!e.token.expiresAt)return!1;let t=new Date(e.token.expiresAt);if(isNaN(t.getTime()))return!0;let r=new Date;return t.getTime()-r.getTime()<300*1e3}function B(e){if(!e.token.refreshTokenExpiresAt)return!1;let t=new Date(e.token.refreshTokenExpiresAt);return isNaN(t.getTime())?!0:new Date>=t}var P=new Map,Re=300*1e3;function be(e){let t=p(e),r=P.get(t);return!r||Date.now()-r.cachedAt>=Re?!1:r.credentials?!w(r.credentials):!0}function q(e){e?P.delete(p(e)):P.clear()}function V(e){let t=p(e);if(be(t))return P.get(t).credentials}function Y(e,t){let r=p(e);P.set(r,{credentials:t,cachedAt:Date.now()})}import{existsSync as X,readFileSync as ee,writeFileSync as te,unlinkSync as Gt,statSync as Oe,chmodSync as De}from"node:fs";import{createCipheriv as Ie,createDecipheriv as _e,randomBytes as re}from"node:crypto";import{existsSync as we,mkdirSync as Pe}from"node:fs";import{join as u}from"node:path";import{getOctocodeHome as Ee}from"@octocodeai/config";var Ae=448;function Le(){return Ee(process.env)}var c=Le(),d={home:c,config:u(c,".octocoderc"),credentials:u(c,"credentials.json"),key:u(c,".key"),session:u(c,"session.json"),stats:u(c,"stats.json"),tmp:u(c,"tmp"),clone:u(c,"tmp","clone"),tree:u(c,"tmp","tree"),response:u(c,"tmp","response"),repos:u(c,"tmp","clone"),cliConfig:u(c,"config.json"),lspConfig:u(c,"lsp-servers.json")};function Z(){we(d.home)||Pe(d.home,{recursive:!0,mode:Ae})}import{z as a}from"zod";var Fe=a.object({token:a.string(),tokenType:a.literal("oauth"),scopes:a.array(a.string()).optional(),refreshToken:a.string().optional(),expiresAt:a.string().optional(),refreshTokenExpiresAt:a.string().optional()}),He=a.object({hostname:a.string(),username:a.string(),token:Fe,gitProtocol:a.enum(["ssh","https"]),createdAt:a.string(),updatedAt:a.string()}),Q=a.object({version:a.number(),credentials:a.record(a.string(),He)});var Ge=d.home,D=d.credentials,T=d.key,se="aes-256-gcm",Ue=16;function y(){Z()}function ne(){if(y(),X(T))return Oe(T).mode&511&63&&De(T,384),Buffer.from(ee(T,"utf8"),"hex");let e=re(32);return te(T,e.toString("hex"),{mode:384}),e}function oe(e){let t=ne(),r=re(Ue),s=Ie(se,t,r),n=s.update(e,"utf8","hex");n+=s.final("hex");let i=s.getAuthTag();return`${r.toString("hex")}:${i.toString("hex")}:${n}`}function ie(e){let t=ne(),[r,s,n]=e.split(":");if(!r||!s||!n)throw new Error("Invalid encrypted data format");let i=Buffer.from(r,"hex"),k=Buffer.from(s,"hex"),h=_e(se,t,i);h.setAuthTag(k);let J=h.update(n,"hex","utf8");return J+=h.final("utf8"),J}function N(){if(y(),!X(D))return{version:1,credentials:{}};try{let e=ee(D,"utf8"),t=ie(e),r=JSON.parse(t),s=Q.safeParse(r);return s.success?s.data:{version:1,credentials:{}}}catch{return{version:1,credentials:{}}}}function ae(e){y();let t=oe(JSON.stringify(e,null,2));te(D,t,{mode:384})}import{refreshToken as je}from"@octokit/oauth-methods";import{request as Be}from"@octokit/request";var I="178c6fc778ccc68e1d6a",E="github.com";function Ne(e){return e.replace(/\b(ghp_|gho_|ghu_|ghs_|ghr_)[a-zA-Z0-9]{36,}\b/g,"***MASKED***").replace(/\b[a-zA-Z0-9]{40,}\b/g,"***MASKED***")}function Me(e){return e==="github.com"||e===E?"https://api.github.com":`https://${e}/api/v3`}async function ce(e,t=E,r=I){let s=await e.getCredentials(t);if(!s)return{success:!1,error:`Not logged in to ${t}`};if(!s.token.refreshToken)return{success:!1,error:"Token does not support refresh (OAuth App tokens do not expire)"};if(B(s))return{success:!1,error:"Refresh token has expired. Please login again."};try{let n=await je({clientType:"github-app",clientId:r,clientSecret:"",refreshToken:s.token.refreshToken,request:Be.defaults({baseUrl:Me(t)})}),i={token:n.authentication.token,tokenType:"oauth",refreshToken:n.authentication.refreshToken,expiresAt:n.authentication.expiresAt,refreshTokenExpiresAt:n.authentication.refreshTokenExpiresAt};return await e.updateToken(t,i),{success:!0,username:s.username,hostname:t}}catch(n){return{success:!1,error:n instanceof Error?Ne(n.message):"Token refresh failed"}}}async function ue(e,t=E,r=I){let s=await e.getCredentials(t);if(!s||!s.token)return{token:null,source:"none"};if(!w(s))return{token:s.token.token,source:"stored",username:s.username};if(s.token.refreshToken){let n=await ce(e,t,r);if(n.success){let i=await e.getCredentials(t);if(i?.token.token)return{token:i.token.token,source:"refreshed",username:i.username}}return{token:null,source:"none",refreshError:n.error}}return{token:null,source:"none",refreshError:"Token expired and no refresh token available"}}import{resolveEnvToken as Xt}from"@octocodeai/config";import{execFile as Vt}from"child_process";var ze=null;function le(e){ze=e}async function We(e){let t=p(e.hostname),r={...e,hostname:t,updatedAt:new Date().toISOString()};try{let s=N();return s.credentials[t]=r,ae(s),q(t),{success:!0}}catch{throw new Error("Failed to store credentials")}}async function de(e="github.com",t){let r=p(e);if(!t?.bypassCache){let i=V(r);if(i!==void 0)return i}let n=N().credentials[r]||null;return Y(r,n),n}async function $e(e,t){let r=await de(e);return r?(r.token=t,r.updatedAt=new Date().toISOString(),await We(r),!0):!1}async function Ke(e,t){return ue({getCredentials:de,updateToken:$e},e,t)}le({getTokenWithRefresh:Ke});import{z as o}from"zod";var Je=o.object({rawChars:o.number(),responseChars:o.number(),savedChars:o.number(),calls:o.number()}),qe=o.object({hits:o.record(o.string(),o.number()).default({}),rateLimits:o.number().default(0)}),_=o.record(o.string(),o.number()).default({}),Ve=o.object({toolCalls:o.number(),errors:o.number(),rateLimits:o.number(),rateLimitsByProvider:_,rawChars:o.number(),responseChars:o.number(),savedChars:o.number(),charSavingsCalls:o.number(),githubCacheHits:o.number(),githubCacheRateLimits:o.number(),packageRegistryFailures:o.number().default(0),packageRegistryFailuresByRegistry:_}),G=o.object({toolCalls:o.number(),errors:o.number(),rateLimits:o.number(),rateLimitsByProvider:_,charsSavedByTool:o.record(o.string(),Je).default({}),githubCacheHits:qe.default({hits:{},rateLimits:0}),packageRegistryFailures:_,totalUsage:Ve.optional()}),fe=o.object({version:o.literal(1),sessionId:o.string(),createdAt:o.string(),lastActiveAt:o.string(),stats:G.optional()}),he=o.object({version:o.literal(1),stats:G});function pe(e){return Object.values(e).reduce((t,r)=>t+r,0)}function Ye(e){let t=e.charsSavedByTool??{},r=e.githubCacheHits??{hits:{},rateLimits:0},s=e.rateLimitsByProvider??{},n=e.packageRegistryFailures??{},i=Object.values(t).reduce((k,h)=>({rawChars:k.rawChars+h.rawChars,responseChars:k.responseChars+h.responseChars,savedChars:k.savedChars+h.savedChars,charSavingsCalls:k.charSavingsCalls+h.calls}),{rawChars:0,responseChars:0,savedChars:0,charSavingsCalls:0});return{toolCalls:e.toolCalls,errors:e.errors,rateLimits:e.rateLimits,rateLimitsByProvider:s,...i,githubCacheHits:pe(r.hits),githubCacheRateLimits:r.rateLimits,packageRegistryFailures:pe(n),packageRegistryFailuresByRegistry:n}}function m(e){let t={...e,rateLimitsByProvider:e.rateLimitsByProvider??{},charsSavedByTool:e.charsSavedByTool??{},githubCacheHits:e.githubCacheHits??{hits:{},rateLimits:0},packageRegistryFailures:e.packageRegistryFailures??{}};return{...t,totalUsage:Ye(t)}}function S(){return m({toolCalls:0,errors:0,rateLimits:0,rateLimitsByProvider:{},charsSavedByTool:{},githubCacheHits:{hits:{},rateLimits:0},packageRegistryFailures:{}})}var x=d.session,v=d.stats;function me(e,t){let r=`${e}.tmp`;Ze(r,JSON.stringify(t,null,2),{mode:384}),Xe(r,e)}function et(e){let t=JSON.parse(e),r=he.safeParse(t);if(r.success)return m(r.data.stats);let s=G.safeParse(t);return s.success?m(s.data):null}function tt(){if(!M(v))return S();try{let e=Se(v,"utf8");return et(e)??S()}catch{return S()}}function U(e){if(!ge())return;y(),Ce()&&me(v,{version:e.version,stats:m(e.stats)});let{stats:t,...r}=e;me(x,r)}function ke(){if(!ge()||!M(x))return null;try{let e=Se(x,"utf8"),t=JSON.parse(e),r=fe.safeParse(t);return r.success?{...r.data,stats:Ce()?tt():S()}:null}catch{return null}}function Te(){let e=!1;for(let t of[x,v])if(M(t))try{Qe(t),e=!0}catch{return!1}return e}var rt=6e4,l=null,g=!1,R=null,z=!1,A=null,L=null,F=null,j=!1;function st(){z||(z=!0,A=()=>{H()},L=()=>{H()},F=()=>{H()},process.on("exit",A),process.on("SIGINT",L),process.on("SIGTERM",F))}function W(){A&&(process.removeListener("exit",A),A=null),L&&(process.removeListener("SIGINT",L),L=null),F&&(process.removeListener("SIGTERM",F),F=null),z=!1}function nt(){R||(R=setInterval(()=>{g&&l&&(U(l),g=!1)},rt),R.unref())}function $(){R&&(clearInterval(R),R=null)}function b(){if(l)return l;let e=ke();return e&&(l=e),e}function C(e){l=e,g=!0,st(),nt()}function O(){g&&l&&(U(l),g=!1)}function H(){if(!j&&g&&l){j=!0;try{U(l),g=!1}catch{}finally{j=!1}}}function K(){l=null,g=!1,j=!1}function ye(){K(),$(),W()}var it=1;function at(e){return m(e)}function ct(e,t){if(!t)return e;let r={...e};for(let[s,n]of Object.entries(t)){let i=r[s]??{rawChars:0,responseChars:0,savedChars:0,calls:0};r[s]={rawChars:i.rawChars+n.rawChars,responseChars:i.responseChars+n.responseChars,savedChars:i.savedChars+n.savedChars,calls:i.calls+n.calls}}return r}function xe(e,t){if(!t)return e;let r={...e};for(let[s,n]of Object.entries(t))r[s]=(r[s]??0)+n;return r}function ut(e,t){if(!t)return e;let r={...e.hits};for(let[s,n]of Object.entries(t.hits??{}))r[s]=(r[s]??0)+n;return{hits:r,rateLimits:e.rateLimits+(t.rateLimits??0)}}function ve(){let e=new Date().toISOString();return{version:it,sessionId:ot(),createdAt:e,lastActiveAt:e,stats:S()}}function lt(){return b()}function dt(e){C(e)}function ft(){O()}function ht(){H()}function pt(e){if(e?.forceNew){let s=ve();return C(s),O(),s}let t=b();if(t){let s={...t,lastActiveAt:new Date().toISOString()};return C(s),O(),s}let r=ve();return C(r),O(),r}function mt(){return b()?.sessionId??null}function f(e){let t=b();if(!t)return{success:!1,session:null};let r=at(t.stats),s=m({toolCalls:r.toolCalls+(e.toolCalls??0),errors:r.errors+(e.errors??0),rateLimits:r.rateLimits+(e.rateLimits??0),rateLimitsByProvider:xe(r.rateLimitsByProvider,e.rateLimitsByProvider),charsSavedByTool:ct(r.charsSavedByTool,e.charsSavedByTool),githubCacheHits:ut(r.githubCacheHits,e.githubCacheHits),packageRegistryFailures:xe(r.packageRegistryFailures,e.packageRegistryFailures)}),n={...t,lastActiveAt:new Date().toISOString(),stats:s};return C(n),{success:!0,session:n}}function St(e=1){return f({toolCalls:e})}function gt(e=1){return f({errors:e})}function Ct(e=1){return f({rateLimits:e})}function kt(e,t=1){return f({rateLimits:t,rateLimitsByProvider:{[e]:t}})}function Tt(e,t,r){let s=Number.isFinite(t)?Math.max(0,t):0,n=Number.isFinite(r)?Math.max(0,r):0;return f({charsSavedByTool:{[e]:{rawChars:s,responseChars:n,savedChars:Math.max(0,s-n),calls:1}}})}function yt(e,t=1){return f({githubCacheHits:{hits:{[e]:t},rateLimits:0}})}function xt(e=1){return f({githubCacheHits:{hits:{},rateLimits:e}})}function vt(e,t=1){return f({packageRegistryFailures:{[e]:t}})}function Rt(){let e=b();if(!e)return{success:!1,session:null};let t={...e,lastActiveAt:new Date().toISOString(),stats:S()};return C(t),{success:!0,session:t}}function bt(){return K(),$(),W(),Te()}function wt(){ye()}export{x as SESSION_FILE,v as STATS_FILE,wt as _resetSessionState,bt as deleteSession,ft as flushSession,ht as flushSessionSync,pt as getOrCreateSession,mt as getSessionId,gt as incrementErrors,yt as incrementGitHubCacheHits,xt as incrementGitHubCacheRateLimits,vt as incrementPackageRegistryFailures,kt as incrementRateLimitByProvider,Ct as incrementRateLimits,St as incrementToolCalls,Tt as incrementToolCharSavings,lt as readSession,Rt as resetSessionStats,f as updateSessionStats,dt as writeSession};

package/dist/toolContract/descriptions.d.ts

@@ -0,0 +1,14 @@
+/** Canonical agent-facing descriptions for the public direct tools. */
+export declare const PUBLIC_TOOL_DESCRIPTIONS: {
+    readonly ghSearch: "Choose operation:\"code\" for code contents or file paths, \"repositories\" to discover repositories, or \"tree\" to browse a known repository.\nEach operation has a strict input branch; fields from other operations are rejected. Use ghGetFileContent only after a path is known. Empty GitHub search results do not prove absence.";
+    readonly ghGetFileContent: "Read a known GitHub path after search or structure discovery; a complete search snippet needs no reread. A path-only call returns a bounded standard-minified view. For large files, get a symbols outline, then an exact range or match. Read small config files whole with minify:\"none\".\nOptionally choose fullContent, matchString, or startLine+endLine. Partial content cannot prove absence; run the returned continuation. matchedLines are LSP anchors; match ranges and offsets are not. type:\"directory\" returns localPath when local access is enabled; otherwise use ghSearch operation:\"tree\".";
+    readonly ghSearchHistory: "Search or list repository history. Choose operation:\"pullRequests\", \"issues\", or \"commits\"; fields from other operations are rejected. Pull-request search may be global, while issue and commit history require owner+repo. Search branches never accept detail identities, content selectors, or diff pagination. Follow a result with ghGetHistoryItem.";
+    readonly ghGetHistoryItem: "Retrieve exact GitHub history. Choose operation:\"pullRequest\" or \"issue\" with number, \"commit\" with ref, or \"compare\" with base+head. Every branch requires owner+repo and rejects fields from other branches. PR/issue content and commit/compare diffs keep their branch-specific page and character windows; copy returned continuations exactly.";
+    readonly npmSearch: "Resolve npm packages to source repositories. Set exactly one of packageName for exact lookup or keywords for discovery. Follow the repository into GitHub tools.";
+    readonly ghCloneRepo: "Best for repeated reads, local AST/regex, or LSP; use ghGetFileContent for one read. Discover a bounded sparsePath first; complete is relative to that requested scope. branch selects the ref and forceRefresh bypasses the cached clone. Pass results[].data.location.localPath to local tools.";
+    readonly localSearch: "Choose operation:\"text\" for lexical anchors, \"structural\" for AST matches, \"files\" for path or metadata discovery, and \"tree\" for directory orientation. Each operation has a strict branch, so do not mix fields across operations. Files/tree prune common generated and vendor directories by default; pass excludeDir:[] to prune nothing. Read exact hits with localGetFileContent and prove symbol identity with lspGetSemantics.";
+    readonly localAnalyzeGraph: "Map file topology, not symbol identity. dependencies/dependents need file; path needs file+target; deadCode/reachability accept roots; cycles needs no selector. Import edges and dead-code results are candidates—verify changes and deletions with exact reads plus LSP.";
+    readonly localGetFileContent: "Read a known local path after search, find, or structure discovery. A path-only call returns a bounded standard-minified view. For large files, get a symbols outline, then an exact range or match. Read small config files whole with minify:\"none\".\nOptionally choose fullContent, matchString, or startLine+endLine. Partial content cannot prove absence; run the returned continuation. matchedLines are LSP anchors; match ranges and character offsets are not. Report fetched bytes only.";
+    readonly lspGetSemantics: "Use a real search/read line anchor for semantic proof. references finds usages; callers incoming calls; callees outgoing calls; callHierarchy both. Fall back to references if call hierarchy is unavailable.\ndocumentSymbols/diagnostic need uri; workspaceSymbol needs symbolName; other operations need uri+symbolName+lineHint. orderHint resolves same-line names. format:\"compact\" saves tokens. Empty/unavailable results call for a new anchor or text search.";
+};
+export type PublicToolName = keyof typeof PUBLIC_TOOL_DESCRIPTIONS;

package/dist/toolContract/input/resources/global.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { ToolNames } from '../types/index.js';
+export declare const toolNames: ToolNames;
+export declare const baseSchema: z.ZodObject<{
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BaseSchemaShape = typeof baseSchema.shape;
+/**
+ * Flat `field -> description` map derived from the Zod `baseSchema`. Consumed by
+ * `generateDefaultJson` (serialized verbatim under the `baseSchema` JSON key)
+ * and by `buildObject`, which merges these onto each tool's meta fields. Keeps
+ * the shipped JSON a plain string map while the source of truth stays Zod.
+ */
+export declare const baseSchemaDescriptions: Record<keyof BaseSchemaShape, string>;

package/dist/toolContract/input/resources/toolRelations.d.ts

@@ -0,0 +1 @@
+export declare function getToolSchemaRelations(toolName: string): string[];

package/dist/toolContract/input/resources/toolVariants.d.ts

@@ -0,0 +1,9 @@
+export interface ToolSchemaVariant {
+    name: string;
+    when: string;
+    requires: string[];
+    fields?: string[];
+    excludes?: string[];
+    example: Record<string, unknown>;
+}
+export declare function getToolSchemaVariants(name: string): ToolSchemaVariant[];

package/dist/toolContract/input/resources/tools/_toolkit.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+import type { ToolSchema, ToolSpec, ToolType } from '../../types/index.js';
+export declare const MAX_CONTEXT_LINES = 100;
+export declare const MAX_PAGE_NUMBER = 1000;
+export declare const MAX_CHAR_OFFSET = 100000000;
+export declare const MAX_CHAR_LENGTH = 50000;
+export declare const MAX_LINE_NUMBER = 1000000000;
+export declare const MAX_ORDER_HINT = 100000;
+export declare const MAX_LOCAL_DEPTH = 20;
+export declare const MAX_FIND_DEPTH = 100;
+export declare const MAX_LOCAL_LIMIT = 10000;
+export declare const MAX_LOCAL_ITEMS_PER_PAGE = 50;
+export declare const MAX_GITHUB_SEARCH_LIMIT = 100;
+export declare const DEFAULT_GITHUB_SEARCH_LIMIT = 30;
+export declare const MAX_GITHUB_STRUCTURE_ITEMS_PER_PAGE = 200;
+export declare const DEFAULT_GITHUB_STRUCTURE_ITEMS_PER_PAGE = 100;
+export declare const MAX_PR_ITEMS_PER_PAGE = 100;
+export declare const DEFAULT_PR_ITEMS_PER_PAGE = 20;
+export declare const MAX_MATCH_CONTENT_LENGTH = 100000;
+export declare const DEFAULT_MATCH_CONTENT_LENGTH = 500;
+export declare const MAX_MATCH_COUNT = 100000;
+export declare const MAX_SEARCH_ITEMS_PER_PAGE = 1000;
+export declare const MAX_LSP_DEPTH = 20;
+export declare const MAX_LSP_ITEMS_PER_PAGE = 100;
+export declare const MAX_GITHUB_STRUCTURE_DEPTH = 20;
+export declare const MAX_BINARY_ENTRIES = 10000;
+export declare const DEFAULT_BINARY_ENTRIES = 1000;
+export declare const MAX_BINARY_ENTRIES_PER_PAGE = 100;
+export declare const MAX_BINARY_CONTEXT_LINES = 50;
+export declare const DEFAULT_BINARY_CONTEXT_LINES = 3;
+export declare const MAX_STRINGS_MIN_LENGTH = 128;
+export declare const DEFAULT_STRINGS_MIN_LENGTH = 8;
+/**
+ * Authoring shape for a tool: the three human-written fields plus its schema.
+ * `description` is NOT authored — `defineTool` composes it from the others.
+ */
+export interface ToolDefinition {
+    readonly name: string;
+    readonly type: ToolType;
+    readonly shortDescription: string;
+    readonly instructions: string;
+    readonly schema: ToolSchema;
+}
+/**
+ * Build a {@link ToolSpec}, deriving the client-facing `description` as
+ * `instructions`. The tool name identifies the operation and
+ * `shortDescription` remains separately available for catalogs, so repeating
+ * either in every MCP description wastes context. Clients that only read
+ * `description` still get the routing contract, while the
+ * three parts stay individually addressable and can't drift out of sync.
+ */
+export declare function defineTool(def: ToolDefinition): ToolSpec;
+export declare function intRange(min: number, max: number): z.ZodNumber;
+export declare const StringArray: z.ZodOptional<z.ZodArray<z.ZodString>>;
+export declare function pageNumber(): z.ZodDefault<z.ZodNumber>;
+export declare function optionalPageNumber(): z.ZodOptional<z.ZodNumber>;
+export declare function contextLines(): z.ZodOptional<z.ZodNumber>;
+export declare function lineNumber(): z.ZodOptional<z.ZodNumber>;
+export declare function charOffset(): z.ZodOptional<z.ZodNumber>;
+export declare function charLength(): z.ZodOptional<z.ZodNumber>;
+export declare const metaFields: {
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+};
+export declare function buildObject<S extends z.ZodRawShape>(prose: ToolSchema, shape: S, prefix?: string): z.ZodObject<S>;
+/** Shared refinement: fullContent / matchString / startLine+endLine are
+ * mutually exclusive extraction modes; startLine and endLine must be supplied
+ * together; and endLine must be >= startLine. Used by both the local and
+ * GitHub file-content readers. */
+export declare function validateFileContentExtractionMode(data: {
+    fullContent?: boolean | undefined;
+    matchString?: string | undefined;
+    startLine?: number | undefined;
+    endLine?: number | undefined;
+}, ctx: z.RefinementCtx): void;

package/dist/toolContract/input/resources/tools/ghCloneRepo.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import type { ToolSpec } from '../../types/index.js';
+export declare const ghCloneRepo: ToolSpec;
+export declare const CloneRepoQuerySchema: z.ZodObject<{
+    owner: z.ZodString;
+    repo: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    sparsePath: z.ZodOptional<z.ZodString>;
+    forceRefresh: z.ZodOptional<z.ZodBoolean>;
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/toolContract/input/resources/tools/ghGetFileContent.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import type { ToolSpec } from '../../types/index.js';
+export declare const ghGetFileContent: ToolSpec;
+export declare const FileContentQuerySchema: z.ZodObject<{
+    owner: z.ZodString;
+    repo: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    startLine: z.ZodOptional<z.ZodNumber>;
+    endLine: z.ZodOptional<z.ZodNumber>;
+    fullContent: z.ZodOptional<z.ZodBoolean>;
+    matchString: z.ZodOptional<z.ZodString>;
+    matchStringIsRegex: z.ZodOptional<z.ZodBoolean>;
+    matchStringCaseSensitive: z.ZodOptional<z.ZodBoolean>;
+    forceRefresh: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodDefault<z.ZodEnum<{
+        file: "file";
+        directory: "directory";
+    }>>;
+    contextLines: z.ZodDefault<z.ZodNumber>;
+    charOffset: z.ZodOptional<z.ZodNumber>;
+    charLength: z.ZodOptional<z.ZodNumber>;
+    minify: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        standard: "standard";
+        symbols: "symbols";
+    }>>;
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/toolContract/input/resources/tools/ghSearch.d.ts

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import type { ToolSpec } from '../../types/index.js';
+export declare const ghSearch: ToolSpec;
+export declare const GitHubSearchQuerySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    owner: z.ZodOptional<z.ZodString>;
+    repo: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    extension: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    concise: z.ZodOptional<z.ZodBoolean>;
+    match: z.ZodDefault<z.ZodEnum<{
+        file: "file";
+        path: "path";
+    }>>;
+    pageSize: z.ZodDefault<z.ZodNumber>;
+    operation: z.ZodLiteral<"code">;
+}, z.core.$strict>, z.ZodObject<{
+    sort: z.ZodDefault<z.ZodEnum<{
+        updated: "updated";
+        "best-match": "best-match";
+        stars: "stars";
+        forks: "forks";
+        "help-wanted-issues": "help-wanted-issues";
+    }>>;
+    owner: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+    created: z.ZodOptional<z.ZodString>;
+    updated: z.ZodOptional<z.ZodString>;
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    page: z.ZodDefault<z.ZodNumber>;
+    concise: z.ZodOptional<z.ZodBoolean>;
+    stars: z.ZodOptional<z.ZodString>;
+    forks: z.ZodOptional<z.ZodString>;
+    goodFirstIssues: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodString>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+    visibility: z.ZodOptional<z.ZodEnum<{
+        public: "public";
+        private: "private";
+    }>>;
+    license: z.ZodOptional<z.ZodString>;
+    topics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    pageSize: z.ZodDefault<z.ZodNumber>;
+    match: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        name: "name";
+        description: "description";
+        readme: "readme";
+    }>>>;
+    operation: z.ZodLiteral<"repositories">;
+}, z.core.$strict>, z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    owner: z.ZodString;
+    repo: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        sizes: "sizes";
+        languages: "languages";
+        contributors: "contributors";
+        branches: "branches";
+        tags: "tags";
+    }>>>;
+    operation: z.ZodLiteral<"tree">;
+    pageSize: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>], "operation">;
+export type GitHubSearchQuery = z.infer<typeof GitHubSearchQuerySchema>;

package/dist/toolContract/input/resources/tools/githubCodeOperation.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export declare const githubCodeOperationDescriptions: {
+    keywords: string;
+    path: string;
+    match: string;
+    extension: string;
+    filename: string;
+    language: string;
+    concise: string;
+    limit: string;
+};
+export declare const GitHubCodeSearchQuerySchema: z.ZodObject<{
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    owner: z.ZodOptional<z.ZodString>;
+    repo: z.ZodOptional<z.ZodString>;
+    extension: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+    match: z.ZodDefault<z.ZodEnum<{
+        file: "file";
+        path: "path";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
+    concise: z.ZodOptional<z.ZodBoolean>;
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/toolContract/input/resources/tools/githubHistorySchema.d.ts

@@ -0,0 +1,114 @@
+import { z } from 'zod';
+export declare const GitHubPullRequestSearchQuerySchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<{
+        prs: "prs";
+        commits: "commits";
+    }>>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    includeDiff: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeAssets: z.ZodOptional<z.ZodBoolean>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    prNumber: z.ZodOptional<z.ZodNumber>;
+    issueNumber: z.ZodOptional<z.ZodNumber>;
+    owner: z.ZodOptional<z.ZodString>;
+    repo: z.ZodOptional<z.ZodString>;
+    concise: z.ZodOptional<z.ZodBoolean>;
+    state: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        closed: "closed";
+        merged: "merged";
+    }>>;
+    assignee: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    committer: z.ZodOptional<z.ZodString>;
+    commenter: z.ZodOptional<z.ZodString>;
+    mentions: z.ZodOptional<z.ZodString>;
+    'review-requested': z.ZodOptional<z.ZodString>;
+    'reviewed-by': z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    checks: z.ZodOptional<z.ZodEnum<{
+        success: "success";
+        pending: "pending";
+        failure: "failure";
+    }>>;
+    review: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        required: "required";
+        approved: "approved";
+        changes_requested: "changes_requested";
+    }>>;
+    head: z.ZodOptional<z.ZodString>;
+    base: z.ZodOptional<z.ZodString>;
+    created: z.ZodOptional<z.ZodString>;
+    updated: z.ZodOptional<z.ZodString>;
+    closed: z.ZodOptional<z.ZodString>;
+    'merged-at': z.ZodOptional<z.ZodString>;
+    comments: z.ZodOptional<z.ZodString>;
+    reactions: z.ZodOptional<z.ZodString>;
+    draft: z.ZodOptional<z.ZodBoolean>;
+    match: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        body: "body";
+        title: "title";
+        comments: "comments";
+    }>>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        comments: "comments";
+        reactions: "reactions";
+        created: "created";
+        updated: "updated";
+        "best-match": "best-match";
+    }>>;
+    order: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+    filePage: z.ZodOptional<z.ZodNumber>;
+    commentPage: z.ZodOptional<z.ZodNumber>;
+    commitPage: z.ZodOptional<z.ZodNumber>;
+    reviewMode: z.ZodOptional<z.ZodLiteral<"full">>;
+    content: z.ZodOptional<z.ZodObject<{
+        metadata: z.ZodOptional<z.ZodBoolean>;
+        body: z.ZodOptional<z.ZodBoolean>;
+        changedFiles: z.ZodOptional<z.ZodBoolean>;
+        patches: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodDefault<z.ZodEnum<{
+                none: "none";
+                selected: "selected";
+                all: "all";
+            }>>;
+            files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            ranges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                file: z.ZodString;
+                additions: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+                deletions: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+        comments: z.ZodOptional<z.ZodObject<{
+            discussion: z.ZodOptional<z.ZodBoolean>;
+            reviewInline: z.ZodOptional<z.ZodBoolean>;
+            includeBots: z.ZodDefault<z.ZodBoolean>;
+            file: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        reviews: z.ZodOptional<z.ZodBoolean>;
+        commits: z.ZodOptional<z.ZodObject<{
+            list: z.ZodOptional<z.ZodBoolean>;
+            includeFiles: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    matchString: z.ZodOptional<z.ZodString>;
+    commentBodyOffset: z.ZodOptional<z.ZodNumber>;
+    charOffset: z.ZodOptional<z.ZodNumber>;
+    charLength: z.ZodOptional<z.ZodNumber>;
+    minify: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        standard: "standard";
+    }>>;
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/toolContract/input/resources/tools/githubRepositoriesOperation.d.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+export declare const githubRepositoriesOperationDescriptions: {
+    keywords: string;
+    topicsToSearch: string;
+    match: string;
+    sort: string;
+    language: string;
+    stars: string;
+    forks: string;
+    goodFirstIssues: string;
+    updated: string;
+    created: string;
+    size: string;
+    license: string;
+    archived: string;
+    visibility: string;
+    concise: string;
+    limit: string;
+};
+export declare const GitHubReposSearchSingleQuerySchema: z.ZodObject<{
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    topicsToSearch: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    language: z.ZodOptional<z.ZodString>;
+    owner: z.ZodOptional<z.ZodString>;
+    stars: z.ZodOptional<z.ZodString>;
+    forks: z.ZodOptional<z.ZodString>;
+    goodFirstIssues: z.ZodOptional<z.ZodString>;
+    updated: z.ZodOptional<z.ZodString>;
+    created: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodString>;
+    match: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        name: "name";
+        description: "description";
+        readme: "readme";
+    }>>>;
+    sort: z.ZodDefault<z.ZodEnum<{
+        updated: "updated";
+        "best-match": "best-match";
+        stars: "stars";
+        forks: "forks";
+        "help-wanted-issues": "help-wanted-issues";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+    visibility: z.ZodOptional<z.ZodEnum<{
+        public: "public";
+        private: "private";
+    }>>;
+    license: z.ZodOptional<z.ZodString>;
+    concise: z.ZodOptional<z.ZodBoolean>;
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/toolContract/input/resources/tools/githubTreeOperation.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export declare const githubTreeOperationDescriptions: {
+    path: string;
+    branch: string;
+    maxDepth: string;
+    page: string;
+    include: string;
+};
+export declare const GitHubViewRepoStructureQuerySchema: z.ZodObject<{
+    owner: z.ZodString;
+    repo: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodDefault<z.ZodNumber>;
+    itemsPerPage: z.ZodDefault<z.ZodNumber>;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        sizes: "sizes";
+        languages: "languages";
+        contributors: "contributors";
+        branches: "branches";
+        tags: "tags";
+    }>>>;
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/toolContract/input/resources/tools/historyCommitInput.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const SearchCommitsQuerySchema: z.ZodObject<{
+    owner: z.ZodString;
+    repo: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    committer: z.ZodOptional<z.ZodString>;
+    base: z.ZodOptional<z.ZodString>;
+    head: z.ZodOptional<z.ZodString>;
+    pageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    includeDiff: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    page: z.ZodDefault<z.ZodNumber>;
+    filePage: z.ZodOptional<z.ZodNumber>;
+    charOffset: z.ZodOptional<z.ZodNumber>;
+    charLength: z.ZodOptional<z.ZodNumber>;
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/toolContract/input/resources/tools/historyIssueInput.d.ts

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+export declare const SearchIssuesQuerySchema: z.ZodObject<{
+    owner: z.ZodString;
+    repo: z.ZodString;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    issueNumber: z.ZodOptional<z.ZodNumber>;
+    concise: z.ZodOptional<z.ZodBoolean>;
+    state: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        closed: "closed";
+    }>>;
+    assignee: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    commenter: z.ZodOptional<z.ZodString>;
+    mentions: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    created: z.ZodOptional<z.ZodString>;
+    updated: z.ZodOptional<z.ZodString>;
+    closed: z.ZodOptional<z.ZodString>;
+    comments: z.ZodOptional<z.ZodString>;
+    reactions: z.ZodOptional<z.ZodString>;
+    match: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        body: "body";
+        title: "title";
+        comments: "comments";
+    }>>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        comments: "comments";
+        reactions: "reactions";
+        created: "created";
+        updated: "updated";
+        "best-match": "best-match";
+    }>>;
+    order: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    pageSize: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNumber>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+    commentPage: z.ZodOptional<z.ZodNumber>;
+    content: z.ZodOptional<z.ZodObject<{
+        body: z.ZodOptional<z.ZodLiteral<true>>;
+        comments: z.ZodOptional<z.ZodObject<{
+            discussion: z.ZodOptional<z.ZodLiteral<true>>;
+            includeBots: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    matchString: z.ZodOptional<z.ZodString>;
+    commentBodyOffset: z.ZodOptional<z.ZodNumber>;
+    charOffset: z.ZodOptional<z.ZodNumber>;
+    charLength: z.ZodOptional<z.ZodNumber>;
+    minify: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        standard: "standard";
+    }>>;
+    goal: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;