@octocodeai/octocode-tools-core 16.6.0 → 16.6.3

package/dist/shared/credentials/storage.d.ts

@@ -3,9 +3,7 @@ import { invalidateCredentialsCache, _getCacheStats, _resetCredentialsCache } fr
 import { OCTOCODE_DIR, CREDENTIALS_FILE, KEY_FILE, encrypt, decrypt, ensureOctocodeDir, readCredentialsStore, writeCredentialsStore } from './credentialEncryption.js';
 import { type RefreshResult, type TokenWithRefreshResult } from './tokenRefresh.js';
 import { resolveToken, type ResolvedToken, resolveTokenWithRefresh, type ResolvedTokenWithRefresh, resolveTokenFull, type FullTokenResolution, type GhCliTokenGetter, resetTokenResolution } from './tokenResolution.js';
-import { getTokenFromEnv, getEnvTokenSource, hasEnvToken, ENV_TOKEN_VARS } from './envTokens.js';
 import { isTokenExpired, isRefreshTokenExpired } from './credentialUtils.js';
-export { getTokenFromEnv, getEnvTokenSource, hasEnvToken, ENV_TOKEN_VARS };
 export declare function storeCredentials(credentials: StoredCredentials): Promise<StoreResult>;
 export interface GetCredentialsOptions {
     bypassCache?: boolean;

package/dist/shared/credentials/testing.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);
-function o(e){return e.toLowerCase().replace(/^https?:\/\//,"").replace(/\/$/,"")}function s(e){if(!e.token.expiresAt)return!1;let n=new Date(e.token.expiresAt);if(isNaN(n.getTime()))return!0;let t=new Date;return n.getTime()-t.getTime()<300*1e3}var r=new Map,i=300*1e3;function l(e){let n=o(e),t=r.get(n);return!t||Date.now()-t.cachedAt>=i?!1:t.credentials?!s(t.credentials):!0}function a(){let e=Date.now();return{size:r.size,entries:Array.from(r.entries()).map(([n,t])=>({hostname:n,age:e-t.cachedAt,valid:l(n)}))}}function u(){r.clear()}import{execFile as g}from"child_process";var c=null;function f(){c=null}export{a as _getCacheStats,u as _resetCredentialsCache,f as resetTokenResolution};
+function r(e){return e.toLowerCase().replace(/^https?:\/\//,"").replace(/\/$/,"")}function s(e){if(!e.token.expiresAt)return!1;let n=new Date(e.token.expiresAt);if(isNaN(n.getTime()))return!0;let t=new Date;return n.getTime()-t.getTime()<300*1e3}var o=new Map,i=300*1e3;function a(e){let n=r(e),t=o.get(n);return!t||Date.now()-t.cachedAt>=i?!1:t.credentials?!s(t.credentials):!0}function l(){let e=Date.now();return{size:o.size,entries:Array.from(o.entries()).map(([n,t])=>({hostname:n,age:e-t.cachedAt,valid:a(n)}))}}function c(){o.clear()}import m from"node:fs";import E from"node:path";import C from"node:os";import _ from"node:path";import{existsSync as k,readFileSync as R}from"node:fs";import y from"node:path";import{execFile as P}from"child_process";var u=null;function f(){u=null}export{l as _getCacheStats,c as _resetCredentialsCache,f as resetTokenResolution};

package/dist/shared/credentials/types.d.ts

@@ -25,4 +25,4 @@ export interface CredentialsStore {
     version: number;
     credentials: Record<string, StoredCredentials>;
 }
-export type TokenSource = 'env:OCTOCODE_TOKEN' | 'env:GH_TOKEN' | 'env:GITHUB_TOKEN' | 'octocode-storage' | 'gh-cli' | null;
+export type TokenSource = 'env:OCTOCODE_TOKEN' | 'env:GH_TOKEN' | 'env:GITHUB_TOKEN' | 'env:GITHUB_PERSONAL_ACCESS_TOKEN' | 'octocode-storage' | 'gh-cli' | null;

package/dist/shared/paths.d.ts

@@ -1,10 +1,15 @@
 /**
- * Octocode's home directory. Fixed per platform — there is no override env var:
+ * Octocode's home directory. Set OCTOCODE_HOME to isolate caches in tests/CI.
+ * Default per platform:
  *   - macOS:   `~/.octocode`
  *   - Linux:   `${XDG_CONFIG_HOME:-~/.config}/.octocode`
  *   - Windows: `%APPDATA%\.octocode`
+ *
+ * Implementation delegated to @octocodeai/config — single source of truth.
  */
 export declare function getDefaultOctocodeHome(): string;
+/** Octocode home directory — same as OCTOCODE_HOME, exposed for tool/cache use. */
+export declare function getOctocodeDir(): string;
 export declare const OCTOCODE_HOME: string;
 export declare const paths: {
     readonly home: string;

package/dist/shared/paths.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{existsSync as n,mkdirSync as i}from"node:fs";import{join as e}from"node:path";import p from"node:os";import g from"node:path";var c=p.platform()==="win32",f=p.platform()==="darwin",x=p.platform()==="linux",r=p.homedir();function m(){return c?process.env.APPDATA||g.join(r,"AppData","Roaming"):r}var d=".octocode",s=448;function v(l){let a=process.env[l];return a&&a.trim().length>0?a:void 0}function A(){return c?e(m(),d):f?e(r,d):e(v("XDG_CONFIG_HOME")??e(r,".config"),d)}var t=A(),o={home:t,config:e(t,".octocoderc"),credentials:e(t,"credentials.json"),key:e(t,".key"),session:e(t,"session.json"),stats:e(t,"stats.json"),tmp:e(t,"tmp"),clone:e(t,"tmp","clone"),tree:e(t,"tmp","tree"),binary:e(t,"tmp","binary"),repos:e(t,"tmp","clone"),unzip:e(t,"tmp","unzip"),cliConfig:e(t,"config.json"),lspConfig:e(t,"lsp-servers.json")};function h(){n(o.home)||i(o.home,{recursive:!0,mode:s})}function z(){D()}function u(){h(),n(o.tmp)||i(o.tmp,{recursive:!0,mode:s})}function D(){u(),n(o.clone)||i(o.clone,{recursive:!0,mode:s})}function N(){u(),n(o.tree)||i(o.tree,{recursive:!0,mode:s})}function T(){u(),n(o.binary)||i(o.binary,{recursive:!0,mode:s})}function _(){u(),n(o.unzip)||i(o.unzip,{recursive:!0,mode:s})}export{t as OCTOCODE_HOME,T as ensureBinary,D as ensureClone,h as ensureHome,z as ensureRepos,u as ensureTmp,N as ensureTree,_ as ensureUnzip,A as getDefaultOctocodeHome,o as paths};
+import{existsSync as r,mkdirSync as i}from"node:fs";import{join as t}from"node:path";import T from"node:fs";import _ from"node:path";import p from"node:os";import n from"node:path";import{existsSync as L,readFileSync as R}from"node:fs";import S from"node:path";function d(c=process.env){let u=c.OCTOCODE_HOME;if(u&&u.trim())return n.resolve(u.trim());let l=p.homedir(),f=p.platform();if(f==="win32"){let h=c.APPDATA??n.join(l,"AppData","Roaming");return n.join(h,".octocode")}if(f==="darwin")return n.join(l,".octocode");let v=c.XDG_CONFIG_HOME??n.join(l,".config");return n.join(v,".octocode")}var s=448;function m(){return d(process.env)}function M(){return e}var e=m(),o={home:e,config:t(e,".octocoderc"),credentials:t(e,"credentials.json"),key:t(e,".key"),session:t(e,"session.json"),stats:t(e,"stats.json"),tmp:t(e,"tmp"),clone:t(e,"tmp","clone"),tree:t(e,"tmp","tree"),binary:t(e,"tmp","binary"),repos:t(e,"tmp","clone"),unzip:t(e,"tmp","unzip"),cliConfig:t(e,"config.json"),lspConfig:t(e,"lsp-servers.json")};function O(){r(o.home)||i(o.home,{recursive:!0,mode:s})}function I(){E()}function a(){O(),r(o.tmp)||i(o.tmp,{recursive:!0,mode:s})}function E(){a(),r(o.clone)||i(o.clone,{recursive:!0,mode:s})}function D(){a(),r(o.tree)||i(o.tree,{recursive:!0,mode:s})}function j(){a(),r(o.binary)||i(o.binary,{recursive:!0,mode:s})}function F(){a(),r(o.unzip)||i(o.unzip,{recursive:!0,mode:s})}export{e as OCTOCODE_HOME,j as ensureBinary,E as ensureClone,O as ensureHome,I as ensureRepos,a as ensureTmp,D as ensureTree,F as ensureUnzip,m as getDefaultOctocodeHome,M as getOctocodeDir,o as paths};

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

package/dist/tools/directToolCatalog.exec.d.ts

@@ -7,5 +7,10 @@
  */
 import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { DirectToolInputError } from './directToolCatalog.meta.js';
+type InitializeFn = () => Promise<void>;
+/** @internal — test use only; not part of the public API. */
+export declare function _overrideInitialize(fn: InitializeFn): void;
+/** @internal — test use only; not part of the public API. */
+export declare function _resetInitialize(): void;
 export declare function executeDirectTool(name: string, input: unknown): Promise<CallToolResult>;
 export { DirectToolInputError };

package/dist/tools/directToolCatalog.meta.d.ts

@@ -52,6 +52,7 @@ export interface DirectToolMetadata {
 }
 export interface PrepareDirectToolInputOptions {
     sourceLabel?: string;
+    rejectUnknownFields?: boolean;
     onUnknownFields?: (unknownFields: string[], queryIndex: number) => void;
 }
 export declare class DirectToolInputError extends Error {

package/dist/tools/github_clone_repo/scheme.d.ts

@@ -82,7 +82,6 @@ export declare const GitHubCloneRepoOutputLocalSchema: import("zod").ZodObject<{
         kind: import("zod").ZodString;
     }, import("zod/v4/core").$loose>]>>>;
     error: import("zod").ZodOptional<import("zod").ZodString>;
-    hints: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
     base: import("zod").ZodOptional<import("zod").ZodString>;
     shared: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber, import("zod").ZodBoolean]>>>;
     responsePagination: import("zod").ZodOptional<import("zod").ZodObject<{

package/dist/tools/github_fetch_content/scheme.d.ts

@@ -50,88 +50,6 @@ export declare const GitHubFetchContentOutputLocalSchema: z.ZodObject<{
     }, z.core.$strip>>;
     results: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
-        owner: z.ZodString;
-        repo: z.ZodString;
-        files: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            path: z.ZodString;
-            content: z.ZodString;
-            localPath: z.ZodOptional<z.ZodString>;
-            repoRoot: z.ZodOptional<z.ZodString>;
-            contentView: z.ZodOptional<z.ZodEnum<{
-                none: "none";
-                standard: "standard";
-                symbols: "symbols";
-            }>>;
-            isSkeleton: z.ZodOptional<z.ZodBoolean>;
-            totalLines: z.ZodOptional<z.ZodNumber>;
-            sourceChars: z.ZodOptional<z.ZodNumber>;
-            sourceBytes: z.ZodOptional<z.ZodNumber>;
-            resolvedBranch: z.ZodOptional<z.ZodString>;
-            pagination: z.ZodOptional<z.ZodObject<{
-                currentPage: z.ZodNumber;
-                totalPages: z.ZodNumber;
-                hasMore: z.ZodBoolean;
-                nextPage: z.ZodOptional<z.ZodNumber>;
-                nextMatchPage: z.ZodOptional<z.ZodNumber>;
-                charOffset: z.ZodOptional<z.ZodNumber>;
-                charLength: z.ZodOptional<z.ZodNumber>;
-                totalChars: z.ZodOptional<z.ZodNumber>;
-                nextCharOffset: z.ZodOptional<z.ZodNumber>;
-                filesPerPage: z.ZodOptional<z.ZodNumber>;
-                totalFiles: z.ZodOptional<z.ZodNumber>;
-                entriesPerPage: z.ZodOptional<z.ZodNumber>;
-                totalEntries: z.ZodOptional<z.ZodNumber>;
-                matchesPerPage: z.ZodOptional<z.ZodNumber>;
-                totalMatches: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>>;
-            isPartial: z.ZodOptional<z.ZodBoolean>;
-            startLine: z.ZodOptional<z.ZodNumber>;
-            endLine: z.ZodOptional<z.ZodNumber>;
-            matchRanges: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                start: z.ZodNumber;
-                end: z.ZodNumber;
-            }, z.core.$strip>>>;
-            lastModified: z.ZodOptional<z.ZodString>;
-            lastModifiedBy: z.ZodOptional<z.ZodString>;
-            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            matchNotFound: z.ZodOptional<z.ZodBoolean>;
-            searchedFor: z.ZodOptional<z.ZodString>;
-            cached: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strip>>>;
-        directories: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            path: z.ZodString;
-            localPath: z.ZodString;
-            repoRoot: z.ZodOptional<z.ZodString>;
-            fileCount: z.ZodNumber;
-            totalSize: z.ZodNumber;
-            complete: z.ZodOptional<z.ZodBoolean>;
-            directoryEntryCount: z.ZodOptional<z.ZodNumber>;
-            eligibleFileCount: z.ZodOptional<z.ZodNumber>;
-            savedFileCount: z.ZodOptional<z.ZodNumber>;
-            skipped: z.ZodOptional<z.ZodObject<{
-                nonFile: z.ZodNumber;
-                missingDownloadUrl: z.ZodNumber;
-                oversized: z.ZodNumber;
-                binary: z.ZodNumber;
-                fileLimit: z.ZodNumber;
-                fetchFailed: z.ZodNumber;
-                totalSizeLimit: z.ZodNumber;
-                pathTraversal: z.ZodNumber;
-            }, z.core.$strip>>;
-            limits: z.ZodOptional<z.ZodObject<{
-                maxDirectoryFiles: z.ZodNumber;
-                maxTotalSize: z.ZodNumber;
-                maxFileSize: z.ZodNumber;
-            }, z.core.$strip>>;
-            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            files: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                path: z.ZodString;
-                size: z.ZodNumber;
-                type: z.ZodString;
-            }, z.core.$strip>>>;
-            cached: z.ZodOptional<z.ZodBoolean>;
-            resolvedBranch: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
         data: z.ZodOptional<z.ZodObject<{
             owner: z.ZodString;
             repo: z.ZodString;
@@ -155,17 +73,16 @@ export declare const GitHubFetchContentOutputLocalSchema: z.ZodObject<{
                     totalPages: z.ZodNumber;
                     hasMore: z.ZodBoolean;
                     nextPage: z.ZodOptional<z.ZodNumber>;
-                    nextMatchPage: z.ZodOptional<z.ZodNumber>;
                     charOffset: z.ZodOptional<z.ZodNumber>;
                     charLength: z.ZodOptional<z.ZodNumber>;
                     totalChars: z.ZodOptional<z.ZodNumber>;
                     nextCharOffset: z.ZodOptional<z.ZodNumber>;
-                    filesPerPage: z.ZodOptional<z.ZodNumber>;
-                    totalFiles: z.ZodOptional<z.ZodNumber>;
-                    entriesPerPage: z.ZodOptional<z.ZodNumber>;
-                    totalEntries: z.ZodOptional<z.ZodNumber>;
-                    matchesPerPage: z.ZodOptional<z.ZodNumber>;
-                    totalMatches: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                next: z.ZodOptional<z.ZodObject<{
+                    continueChars: z.ZodOptional<z.ZodObject<{
+                        tool: z.ZodLiteral<"ghGetFileContent">;
+                        query: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                    }, z.core.$strip>>;
                 }, z.core.$strip>>;
                 isPartial: z.ZodOptional<z.ZodBoolean>;
                 startLine: z.ZodOptional<z.ZodNumber>;

package/dist/tools/github_search_code/scheme.d.ts

@@ -58,18 +58,16 @@ export declare const GitHubCodeSearchOutputLocalSchema: z.ZodObject<{
             pagination: z.ZodOptional<z.ZodObject<{
                 currentPage: z.ZodNumber;
                 totalPages: z.ZodNumber;
-                perPage: z.ZodNumber;
-                totalMatches: z.ZodNumber;
-                reportedTotalMatches: z.ZodOptional<z.ZodNumber>;
-                reachableTotalMatches: z.ZodOptional<z.ZodNumber>;
+                hasMore: z.ZodBoolean;
+                nextPage: z.ZodOptional<z.ZodNumber>;
+                pageSize: z.ZodOptional<z.ZodNumber>;
+                totalItems: z.ZodOptional<z.ZodNumber>;
                 totalMatchesKind: z.ZodOptional<z.ZodEnum<{
                     exact: "exact";
                     reported: "reported";
                     lowerBound: "lowerBound";
                 }>>;
                 totalMatchesCapped: z.ZodOptional<z.ZodBoolean>;
-                hasMore: z.ZodBoolean;
-                nextPage: z.ZodOptional<z.ZodNumber>;
                 uniqueFileCount: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
         }, z.core.$strip>;

package/dist/tools/github_search_pull_requests/scheme.d.ts

@@ -206,7 +206,6 @@ export declare const GitHubSearchPullRequestsOutputLocalSchema: z.ZodObject<{
         kind: z.ZodString;
     }, z.core.$loose>]>>>;
     error: z.ZodOptional<z.ZodString>;
-    hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
     base: z.ZodOptional<z.ZodString>;
     shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
     responsePagination: z.ZodOptional<z.ZodObject<{

package/dist/tools/github_search_repos/execution.d.ts

@@ -13,5 +13,63 @@ type RepositorySearchExtraFields = {
 };
 type PartialReposSearchQuery = WithOptionalMeta<GitHubReposSearchSingleQuery> & RepositorySearchExtraFields;
 export declare function formatRepoLine(repo: GitHubRepositoryOutput): string;
+import type { RepoSearchResult as ProviderRepoSearchResult } from '../../providers/types.js';
+import { type ProviderOperationResult } from '../providerExecution.js';
+type RepoSearchVariantLabel = 'combined' | 'topics' | 'keywords';
+interface RepoSearchVariant {
+    label: RepoSearchVariantLabel;
+    query: PartialReposSearchQuery;
+}
+interface RepoSearchVariantExecution {
+    label: RepoSearchVariantLabel;
+    query: PartialReposSearchQuery;
+    response: ProviderOperationResult<RepoSearchVariant, ProviderRepoSearchResult>['response'];
+}
+type SuccessfulRepoSearchVariant = RepoSearchVariantExecution & {
+    response: Extract<ProviderOperationResult<RepoSearchVariant, ProviderRepoSearchResult>, {
+        response: {
+            data: ProviderRepoSearchResult;
+        };
+    }>['response'] & {
+        data: ProviderRepoSearchResult;
+    };
+};
+export declare function buildResultPagination(pagination: {
+    currentPage: number;
+    totalPages: number;
+    hasMore: boolean;
+    entriesPerPage?: number;
+    totalMatches?: number;
+    reportedTotalMatches?: number;
+    reachableTotalMatches?: number;
+    totalMatchesKind?: 'exact' | 'reported' | 'lowerBound';
+    totalMatchesCapped?: boolean;
+}): {
+    nextPage?: number;
+    hasMore: boolean;
+    totalMatchesCapped?: boolean;
+    totalMatchesKind?: "exact" | "reported" | "lowerBound";
+    reachableTotalMatches?: number;
+    reportedTotalMatches?: number;
+    totalMatches?: number;
+    currentPage: number;
+    totalPages: number;
+    perPage: number;
+};
+type EffectivePagination = {
+    currentPage: number;
+    totalPages: number;
+    hasMore: boolean;
+    entriesPerPage?: number;
+    totalMatches?: number;
+    reportedTotalMatches?: number;
+    reachableTotalMatches?: number;
+    totalMatchesKind?: 'exact' | 'reported' | 'lowerBound';
+    totalMatchesCapped?: boolean;
+};
+export declare function buildPartialFailureWarnings(failedVariants: readonly {
+    label: RepoSearchVariantLabel;
+}[]): string[] | undefined;
+export declare function buildMergedPagination(variants: SuccessfulRepoSearchVariant[], dedupedCount: number): EffectivePagination | undefined;
 export declare function searchMultipleGitHubRepos(args: ToolExecutionArgs<PartialReposSearchQuery>): Promise<CallToolResult>;
 export {};

package/dist/tools/github_search_repos/scheme.d.ts

@@ -68,21 +68,18 @@ export declare const GitHubSearchRepositoriesOutputLocalSchema: z.ZodObject<{
                 currentPage: z.ZodNumber;
                 totalPages: z.ZodNumber;
                 hasMore: z.ZodBoolean;
-                perPage: z.ZodOptional<z.ZodNumber>;
-                totalMatches: z.ZodOptional<z.ZodNumber>;
-                reportedTotalMatches: z.ZodOptional<z.ZodNumber>;
-                reachableTotalMatches: z.ZodOptional<z.ZodNumber>;
+                nextPage: z.ZodOptional<z.ZodNumber>;
+                pageSize: z.ZodOptional<z.ZodNumber>;
+                totalItems: z.ZodOptional<z.ZodNumber>;
                 totalMatchesKind: z.ZodOptional<z.ZodEnum<{
                     exact: "exact";
                     reported: "reported";
                     lowerBound: "lowerBound";
                 }>>;
                 totalMatchesCapped: z.ZodOptional<z.ZodBoolean>;
-                nextPage: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
         }, z.core.$loose>>;
     }, z.core.$loose>>>;
-    hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
     base: z.ZodOptional<z.ZodString>;
     shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
     responsePagination: z.ZodOptional<z.ZodObject<{

package/dist/tools/github_view_repo_structure/scheme.d.ts

@@ -70,7 +70,6 @@ export declare const GitHubViewRepoStructureOutputLocalSchema: import("zod").Zod
         kind: import("zod").ZodString;
     }, import("zod/v4/core").$loose>]>>>;
     error: import("zod").ZodOptional<import("zod").ZodString>;
-    hints: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
     base: import("zod").ZodOptional<import("zod").ZodString>;
     shared: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber, import("zod").ZodBoolean]>>>;
     responsePagination: import("zod").ZodOptional<import("zod").ZodObject<{

package/dist/tools/local_binary_inspect/binaryInspector.d.ts

@@ -37,7 +37,6 @@ export declare function inspectBinary(query: BinaryInspectQuery): Promise<import
         totalPages: number;
         hasMore: boolean;
         entriesPerPage: number;
-        totalEntries: number;
     };
     status: "success";
     mode: "list";
@@ -54,7 +53,6 @@ export declare function inspectBinary(query: BinaryInspectQuery): Promise<import
     backend: string;
     localPath: string;
     content: string;
-    contentLength: number;
     isPartial: boolean;
 } | {
     pagination?: ContentCharPagination;
@@ -65,13 +63,11 @@ export declare function inspectBinary(query: BinaryInspectQuery): Promise<import
     backend: string;
     localPath: string;
     content: string;
-    contentLength: number;
     isPartial: boolean;
 } | {
     nextScanOffset?: number;
     scanOffset: number;
     pagination?: ContentCharPagination;
-    contentLength: number;
     totalFound: number;
     isPartial: boolean;
     localPath?: string;

package/dist/tools/local_binary_inspect/scheme.d.ts

@@ -45,3 +45,100 @@ export declare const LocalBinaryInspectBulkQuerySchema: z.ZodObject<{
     responseCharLength: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
     queries: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strip>;
+export declare const LocalBinaryInspectOutputSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<{
+            empty: "empty";
+            error: "error";
+            success: "success";
+        }>>;
+        data: z.ZodUnion<readonly [z.ZodObject<{
+            path: z.ZodString;
+            mode: z.ZodLiteral<"inspect">;
+            format: z.ZodOptional<z.ZodString>;
+            size: z.ZodOptional<z.ZodNumber>;
+            isText: z.ZodOptional<z.ZodBoolean>;
+            encoding: z.ZodOptional<z.ZodString>;
+            symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            imports: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            exports: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            path: z.ZodString;
+            mode: z.ZodLiteral<"list">;
+            entries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                size: z.ZodOptional<z.ZodNumber>;
+                compressedSize: z.ZodOptional<z.ZodNumber>;
+                isDir: z.ZodOptional<z.ZodBoolean>;
+                modified: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            pagination: z.ZodOptional<z.ZodObject<{
+                currentPage: z.ZodNumber;
+                totalPages: z.ZodNumber;
+                hasMore: z.ZodBoolean;
+                nextPage: z.ZodOptional<z.ZodNumber>;
+                pageSize: z.ZodOptional<z.ZodNumber>;
+                totalItems: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            path: z.ZodString;
+            mode: z.ZodEnum<{
+                extract: "extract";
+                decompress: "decompress";
+            }>;
+            archiveFile: z.ZodOptional<z.ZodString>;
+            content: z.ZodOptional<z.ZodString>;
+            isPartial: z.ZodOptional<z.ZodBoolean>;
+            pagination: z.ZodOptional<z.ZodObject<{
+                charOffset: z.ZodNumber;
+                charLength: z.ZodNumber;
+                totalChars: z.ZodNumber;
+                hasMore: z.ZodBoolean;
+                nextCharOffset: z.ZodOptional<z.ZodNumber>;
+                currentPage: z.ZodOptional<z.ZodNumber>;
+                totalPages: z.ZodOptional<z.ZodNumber>;
+                chunkMode: z.ZodOptional<z.ZodEnum<{
+                    semantic: "semantic";
+                    "char-limit": "char-limit";
+                }>>;
+            }, z.core.$strip>>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            path: z.ZodString;
+            mode: z.ZodLiteral<"strings">;
+            strings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                offset: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            content: z.ZodOptional<z.ZodString>;
+            totalStrings: z.ZodOptional<z.ZodNumber>;
+            scanOffset: z.ZodOptional<z.ZodNumber>;
+            nextScanOffset: z.ZodOptional<z.ZodNumber>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            path: z.ZodString;
+            mode: z.ZodLiteral<"unpack">;
+            localPath: z.ZodOptional<z.ZodString>;
+            fileCount: z.ZodOptional<z.ZodNumber>;
+            totalSize: z.ZodOptional<z.ZodNumber>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>]>;
+    }, z.core.$strip>>;
+    base: z.ZodOptional<z.ZodString>;
+    shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    responsePagination: z.ZodOptional<z.ZodObject<{
+        currentPage: z.ZodNumber;
+        totalPages: z.ZodNumber;
+        hasMore: z.ZodBoolean;
+        charOffset: z.ZodNumber;
+        charLength: z.ZodNumber;
+        totalChars: z.ZodNumber;
+        nextCharOffset: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LocalBinaryInspectOutput = z.infer<typeof LocalBinaryInspectOutputSchema>;

package/dist/tools/local_fetch_content/scheme.d.ts

@@ -29,3 +29,69 @@ export declare const LocalFetchContentBulkQuerySchema: z.ZodObject<{
     responseCharLength: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
     queries: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strip>;
+export declare const LocalGetFileContentOutputSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<{
+            empty: "empty";
+            error: "error";
+        }>>;
+        data: z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            content: z.ZodOptional<z.ZodString>;
+            contentView: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                standard: "standard";
+                symbols: "symbols";
+            }>>;
+            isSkeleton: z.ZodOptional<z.ZodBoolean>;
+            totalLines: z.ZodOptional<z.ZodNumber>;
+            sourceChars: z.ZodOptional<z.ZodNumber>;
+            startLine: z.ZodOptional<z.ZodNumber>;
+            endLine: z.ZodOptional<z.ZodNumber>;
+            isPartial: z.ZodOptional<z.ZodBoolean>;
+            matchRanges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strip>>>;
+            pagination: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+                charOffset: z.ZodNumber;
+                charLength: z.ZodNumber;
+                totalChars: z.ZodNumber;
+                hasMore: z.ZodBoolean;
+                nextCharOffset: z.ZodOptional<z.ZodNumber>;
+                currentPage: z.ZodOptional<z.ZodNumber>;
+                totalPages: z.ZodOptional<z.ZodNumber>;
+                chunkMode: z.ZodOptional<z.ZodEnum<{
+                    semantic: "semantic";
+                    "char-limit": "char-limit";
+                }>>;
+            }, z.core.$strip>, z.ZodObject<{
+                currentPage: z.ZodNumber;
+                totalPages: z.ZodNumber;
+                hasMore: z.ZodBoolean;
+                nextPage: z.ZodOptional<z.ZodNumber>;
+                pageSize: z.ZodOptional<z.ZodNumber>;
+                totalItems: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>]>>;
+            modified: z.ZodOptional<z.ZodString>;
+            lastModified: z.ZodOptional<z.ZodString>;
+            lastModifiedBy: z.ZodOptional<z.ZodString>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            matchNotFound: z.ZodOptional<z.ZodBoolean>;
+            searchedFor: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    base: z.ZodOptional<z.ZodString>;
+    shared: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    responsePagination: z.ZodOptional<z.ZodObject<{
+        currentPage: z.ZodNumber;
+        totalPages: z.ZodNumber;
+        hasMore: z.ZodBoolean;
+        charOffset: z.ZodNumber;
+        charLength: z.ZodNumber;
+        totalChars: z.ZodNumber;
+        nextCharOffset: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LocalGetFileContentOutput = z.infer<typeof LocalGetFileContentOutputSchema>;