@octocodeai/octocode-tools-core 16.6.3 → 17.0.2

package/dist/shared/paths.d.ts

@@ -21,9 +21,7 @@ export declare const paths: {
     readonly tmp: string;
     readonly clone: string;
     readonly tree: string;
-    readonly binary: string;
     readonly repos: string;
-    readonly unzip: string;
     readonly cliConfig: string;
     readonly lspConfig: string;
 };
@@ -32,5 +30,3 @@ export declare function ensureRepos(): void;
 export declare function ensureTmp(): void;
 export declare function ensureClone(): void;
 export declare function ensureTree(): void;
-export declare function ensureBinary(): void;
-export declare function ensureUnzip(): void;

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 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};
+import{existsSync as r,mkdirSync as n}from"node:fs";import{join as o}from"node:path";import{getOctocodeHome as c}from"@octocodeai/config";var s=448;function p(){return c(process.env)}function v(){return e}var e=p(),t={home:e,config:o(e,".octocoderc"),credentials:o(e,"credentials.json"),key:o(e,".key"),session:o(e,"session.json"),stats:o(e,"stats.json"),tmp:o(e,"tmp"),clone:o(e,"tmp","clone"),tree:o(e,"tmp","tree"),repos:o(e,"tmp","clone"),cliConfig:o(e,"config.json"),lspConfig:o(e,"lsp-servers.json")};function m(){r(t.home)||n(t.home,{recursive:!0,mode:s})}function x(){u()}function i(){m(),r(t.tmp)||n(t.tmp,{recursive:!0,mode:s})}function u(){i(),r(t.clone)||n(t.clone,{recursive:!0,mode:s})}function g(){i(),r(t.tree)||n(t.tree,{recursive:!0,mode:s})}export{e as OCTOCODE_HOME,u as ensureClone,m as ensureHome,x as ensureRepos,i as ensureTmp,g as ensureTree,p as getDefaultOctocodeHome,v as getOctocodeDir,t 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 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};
+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};

package/dist/shared/session/statsDefaults.d.ts

@@ -1,4 +1,3 @@
-import type { SessionStats, SessionTotalUsageStats } from './types.js';
-export declare function calculateTotalUsageStats(stats: SessionStats): SessionTotalUsageStats;
+import type { SessionStats } from './types.js';
 export declare function withDerivedUsageTotals(stats: SessionStats): SessionStats;
 export declare function createDefaultStats(): SessionStats;

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

@@ -0,0 +1,68 @@
+/**
+ * Engine-free direct-tool catalog: registry of tool definitions (name +
+ * display/bulk zod schemas) plus category/sort/output-field helpers. Split out
+ * of `directToolCatalog.meta.ts` (still the public barrel) — see that file's
+ * header comment for the full P3 engine-free rationale.
+ */
+import { z } from 'zod';
+export type DirectToolInput = Record<string, unknown> & {
+    queries: unknown[];
+};
+export interface DirectToolDefinition {
+    name: string;
+    schema: z.ZodType;
+    inputSchema: z.ZodType;
+}
+export type DirectToolCategory = 'GitHub' | 'Local Code' | 'Package' | 'Other';
+export declare const DIRECT_TOOL_CATEGORIES: readonly DirectToolCategory[];
+export interface DirectToolDisplayField {
+    name: string;
+    required: boolean;
+    type: string;
+    /** Numeric bounds and default, e.g. "1-100, default 30" — surfaced inline so
+     * agents see the full constraint without fetching the raw JSON schema. */
+    constraints?: string;
+    description?: string;
+}
+export interface DirectToolCommandPattern {
+    label: string;
+    query: Record<string, unknown>;
+    command: string;
+}
+export interface DirectToolOutputField {
+    name: string;
+    type: string;
+    optional?: boolean;
+}
+export interface DirectToolMetadata {
+    tools?: Record<string, {
+        description?: string;
+        schema?: Record<string, string>;
+    }>;
+}
+export type DirectToolAutoFilledField = 'id' | 'mainResearchGoal' | 'researchGoal' | 'reasoning';
+export interface PrepareDirectToolInputOptions {
+    sourceLabel?: string;
+    rejectUnknownFields?: boolean;
+    onUnknownFields?: (unknownFields: string[], queryIndex: number) => void;
+}
+export declare class DirectToolInputError extends Error {
+    readonly details: string[];
+    constructor(message: string, details?: string[]);
+}
+export declare const DIRECT_TOOL_AUTO_FILLED_FIELDS: ReadonlySet<string>;
+/**
+ * Engine-free tool definitions (name + display/bulk schema). Order mirrors
+ * `ALL_TOOLS` in `toolConfig.ts`; each schema is the SAME object that
+ * `toolConfig` attaches an executionFn to. Kept in lockstep by a drift test.
+ */
+export declare const DIRECT_TOOL_DEFINITIONS: DirectToolDefinition[];
+export declare function findDirectToolDefinition(name: string): DirectToolDefinition | undefined;
+export declare function getDirectToolCategory(toolName: string): DirectToolCategory;
+export declare function sortDirectToolNames(toolNames: string[]): string[];
+export declare function formatDirectToolSchemaText(toolName: string): string;
+export declare function formatDirectToolMetadataSchemaText(schema: Record<string, string> | undefined): string;
+export declare function getDirectToolAutoFilledFields(toolName: string): string[];
+export declare function getDirectToolOutputFields(): DirectToolOutputField[];
+export declare function formatDirectToolOutputSchemaText(): string;
+export declare function getDirectToolDescription(toolName: string, metadata?: DirectToolMetadata | null): string;

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

@@ -0,0 +1,4 @@
+export declare function buildKnownDirectToolCommandPatternQueries(toolName: string): Array<{
+    label: string;
+    query: Record<string, unknown>;
+}>;

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

@@ -0,0 +1,4 @@
+import { type DirectToolCommandPattern } from './toolCatalogDefinitions.js';
+export declare function formatDirectToolCommandPattern(toolName: string, query: Record<string, unknown>): string;
+export declare function buildDirectToolCommandPatterns(toolName: string): DirectToolCommandPattern[];
+export declare function buildDirectToolExampleQuery(toolName: string): Record<string, unknown>;

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

@@ -0,0 +1,12 @@
+/**
+ * Input preparation/normalization for the engine-free direct-tool catalog:
+ * JSON parsing, envelope handling, default-field filling, field-name alias
+ * folding, and unknown-field detection (with did-you-mean suggestions). Split
+ * out of `directToolCatalog.meta.ts` (still the public barrel) — see that
+ * file's header comment for the full P3 rationale.
+ */
+import { z } from 'zod';
+import { type DirectToolInput, type PrepareDirectToolInputOptions } from './toolCatalogDefinitions.js';
+export declare function prepareDirectToolInputFromJsonText(toolName: string, inputText: string | undefined, options?: PrepareDirectToolInputOptions): DirectToolInput | null;
+export declare function prepareDirectToolInput(toolName: string, rawPayload: unknown, options?: PrepareDirectToolInputOptions): DirectToolInput;
+export declare function formatDirectToolValidationIssues(error: z.ZodError): string[];

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

@@ -0,0 +1,19 @@
+import { type DirectToolDisplayField } from './toolCatalogDefinitions.js';
+interface JsonSchemaObject extends Record<string, unknown> {
+    type?: string | string[];
+    description?: string;
+    enum?: unknown[];
+    required?: string[];
+    properties?: Record<string, unknown>;
+    items?: unknown;
+}
+export declare function getDirectToolDisplayFields(toolName: string): DirectToolDisplayField[];
+export declare function describeSchemaConstraints(schema: JsonSchemaObject): string | undefined;
+export declare function describeSchemaType(schema: JsonSchemaObject): string;
+export declare function collectDisplayFields(properties: Record<string, unknown>, requiredFields: ReadonlySet<string>, prefix?: string): DirectToolDisplayField[];
+export declare function buildExampleValue(name: string, type: string): unknown;
+export declare function buildScalarExampleValue(name: string, type: string): unknown;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function isJsonSchemaObject(value: unknown): value is JsonSchemaObject;
+export declare function hasSchemaDefault(value: unknown): boolean;
+export {};

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

@@ -13,71 +13,14 @@
  * which DOES import the engine; it is only reached when a tool actually runs.
  * The `@octocodeai/octocode-tools-core/schema` subpath re-exports only this
  * module so engine-less runtimes (e.g. Codex.app Node) can read schemas.
+ *
+ * This file is a thin barrel — the implementation is split across sibling
+ * modules under `./directToolCatalog/` (registry/helpers, schema
+ * introspection, command-pattern construction, and input preparation) purely
+ * to keep each file under the repo's max-lines lint budget. No consumer
+ * should need to import those sibling modules directly; import from here.
  */
-import { z } from 'zod';
-export type DirectToolInput = Record<string, unknown> & {
-    queries: unknown[];
-};
-export interface DirectToolDefinition {
-    name: string;
-    schema: z.ZodType;
-    inputSchema: z.ZodType;
-}
-export type DirectToolCategory = 'GitHub' | 'Local Code' | 'Package' | 'Other';
-export declare const DIRECT_TOOL_CATEGORIES: readonly DirectToolCategory[];
-export interface DirectToolDisplayField {
-    name: string;
-    required: boolean;
-    type: string;
-    /** Numeric bounds and default, e.g. "1-100, default 30" — surfaced inline so
-     * agents see the full constraint without fetching the raw JSON schema. */
-    constraints?: string;
-    description?: string;
-}
-export interface DirectToolCommandPattern {
-    label: string;
-    query: Record<string, unknown>;
-    command: string;
-}
-export interface DirectToolOutputField {
-    name: string;
-    type: string;
-    optional?: boolean;
-}
-export interface DirectToolMetadata {
-    tools?: Record<string, {
-        description?: string;
-        schema?: Record<string, string>;
-    }>;
-}
-export interface PrepareDirectToolInputOptions {
-    sourceLabel?: string;
-    rejectUnknownFields?: boolean;
-    onUnknownFields?: (unknownFields: string[], queryIndex: number) => void;
-}
-export declare class DirectToolInputError extends Error {
-    readonly details: string[];
-    constructor(message: string, details?: string[]);
-}
-/**
- * Engine-free tool definitions (name + display/bulk schema). Order mirrors
- * `ALL_TOOLS` in `toolConfig.ts`; each schema is the SAME object that
- * `toolConfig` attaches an executionFn to. Kept in lockstep by a drift test.
- */
-export declare const DIRECT_TOOL_DEFINITIONS: DirectToolDefinition[];
-export declare function findDirectToolDefinition(name: string): DirectToolDefinition | undefined;
-export declare function getDirectToolCategory(toolName: string): DirectToolCategory;
-export declare function sortDirectToolNames(toolNames: string[]): string[];
-export declare function formatDirectToolSchemaText(toolName: string): string;
-export declare function formatDirectToolMetadataSchemaText(schema: Record<string, string> | undefined): string;
-export declare function getDirectToolAutoFilledFields(toolName: string): string[];
-export declare function getDirectToolOutputFields(): DirectToolOutputField[];
-export declare function formatDirectToolOutputSchemaText(): string;
-export declare function getDirectToolDescription(toolName: string, metadata?: DirectToolMetadata | null): string;
-export declare function getDirectToolDisplayFields(toolName: string): DirectToolDisplayField[];
-export declare function formatDirectToolCommandPattern(toolName: string, query: Record<string, unknown>): string;
-export declare function buildDirectToolCommandPatterns(toolName: string): DirectToolCommandPattern[];
-export declare function buildDirectToolExampleQuery(toolName: string): Record<string, unknown>;
-export declare function prepareDirectToolInputFromJsonText(toolName: string, inputText: string | undefined, options?: PrepareDirectToolInputOptions): DirectToolInput | null;
-export declare function prepareDirectToolInput(toolName: string, rawPayload: unknown, options?: PrepareDirectToolInputOptions): DirectToolInput;
-export declare function formatDirectToolValidationIssues(error: z.ZodError): string[];
+export * from './directToolCatalog/toolCatalogDefinitions.js';
+export * from './directToolCatalog/toolSchemaIntrospection.js';
+export * from './directToolCatalog/toolCommandPatterns.js';
+export * from './directToolCatalog/toolInputPreparation.js';

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

@@ -1,9 +1,5 @@
 import type { CloneCacheMeta, CacheSource } from './types.js';
-export declare function getReposBaseDir(octocodeDir: string): string;
-export declare function getCloneBaseDir(octocodeDir: string): string;
-export declare function getTreeBaseDir(octocodeDir: string): string;
-export declare function getCloneDir(octocodeDir: string, owner: string, repo: string, branch: string, sparsePath?: string): string;
-export declare function getTreeDir(octocodeDir: string, owner: string, repo: string, branch: string): string;
+export { getReposBaseDir, getCloneBaseDir, getTreeBaseDir, getCloneDir, getTreeDir, } from './cachePaths.js';
 export declare function readCacheMeta(cloneDir: string): CloneCacheMeta | null;
 export declare function writeCacheMeta(cloneDir: string, meta: CloneCacheMeta): void;
 export declare function isCacheValid(meta: CloneCacheMeta): boolean;

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

@@ -0,0 +1,5 @@
+export declare function getReposBaseDir(octocodeDir: string): string;
+export declare function getCloneBaseDir(octocodeDir: string): string;
+export declare function getTreeBaseDir(octocodeDir: string): string;
+export declare function getCloneDir(octocodeDir: string, owner: string, repo: string, branch: string, sparsePath?: string): string;
+export declare function getTreeDir(octocodeDir: string, owner: string, repo: string, branch: string): string;

package/dist/tools/github_fetch_content/finalizer/entryParsers.d.ts

@@ -0,0 +1,9 @@
+import type { PaginationInfo } from '../../../types/toolResults.js';
+import type { DirectoryEntry, FileEntry, PartialFileContentQuery } from './types.js';
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function readString(value: unknown): string | undefined;
+export declare function readNumber(value: unknown): number | undefined;
+export declare function readStringArray(value: unknown): string[] | undefined;
+export declare function readPagination(value: unknown): PaginationInfo | undefined;
+export declare function readFileEntry(data: Record<string, unknown>, query: PartialFileContentQuery): FileEntry;
+export declare function readDirectoryEntry(data: Record<string, unknown>, query: PartialFileContentQuery): DirectoryEntry;

package/dist/tools/github_fetch_content/finalizer/types.d.ts

@@ -0,0 +1,101 @@
+import type { z } from 'zod';
+import type { FileContentQuerySchema } from '@octocodeai/octocode-core/schemas';
+type FileContentQuery = z.infer<typeof FileContentQuerySchema>;
+import type { PaginationInfo } from '../../../types/toolResults.js';
+import type { QueryWithPagination } from '../../../utils/response/groupedFinalizer.js';
+import type { GitHubFetchContentOutputLocal } from '../scheme.js';
+import type { WithOptionalMeta } from '../../../types/execution.js';
+export type PartialFileContentQuery = WithOptionalMeta<FileContentQuery> & QueryWithPagination;
+export type FileEntry = {
+    path: string;
+    content: string;
+    localPath?: string;
+    repoRoot?: string;
+    fileSize?: number;
+    contentView?: 'none' | 'standard' | 'symbols';
+    totalLines?: number;
+    sourceChars?: number;
+    sourceBytes?: number;
+    resolvedBranch?: string;
+    pagination?: PaginationInfo;
+    isPartial?: boolean;
+    startLine?: number;
+    endLine?: number;
+    matchRanges?: Array<{
+        start: number;
+        end: number;
+    }>;
+    lastModified?: string;
+    lastModifiedBy?: string;
+    warnings?: string[];
+    matchNotFound?: boolean;
+    searchedFor?: string;
+    cached?: boolean;
+    next?: FileContentNextMap;
+};
+export type FileContentNextMap = {
+    continueChars?: {
+        tool: 'ghGetFileContent';
+        query: Record<string, unknown>;
+    };
+    cloneForSemantics?: {
+        tool: 'ghCloneRepo';
+        query: Record<string, unknown>;
+        why: string;
+        confidence: 'exact';
+    };
+};
+export type DirectoryEntry = {
+    path: string;
+    localPath: string;
+    repoRoot?: string;
+    fileCount: number;
+    totalSize: number;
+    complete?: boolean;
+    verified?: boolean;
+    commitSha?: string;
+    hasSubdirectories?: boolean;
+    skippedSummary?: Record<string, number>;
+    directoryEntryCount?: number;
+    eligibleFileCount?: number;
+    savedFileCount?: number;
+    skipped?: {
+        nonFile: number;
+        missingDownloadUrl: number;
+        oversized: number;
+        binary: number;
+        fileLimit: number;
+        fetchFailed: number;
+        totalSizeLimit: number;
+        pathTraversal: number;
+    };
+    limits?: {
+        maxDirectoryFiles: number;
+        maxTotalSize: number;
+        maxFileSize: number;
+    };
+    warnings?: string[];
+    files?: Array<{
+        path: string;
+        size: number;
+        type: string;
+    }>;
+    cached?: boolean;
+    resolvedBranch?: string;
+};
+export type RepoGroup = {
+    id: string;
+    owner: string;
+    repo: string;
+    files?: FileEntry[];
+    directories?: DirectoryEntry[];
+    data?: RepoGroupData;
+};
+export type RepoGroupData = {
+    owner: string;
+    repo: string;
+    files?: FileEntry[];
+    directories?: DirectoryEntry[];
+};
+export type FileContentResponse = GitHubFetchContentOutputLocal;
+export {};

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

@@ -1,10 +1,4 @@
-import type { z } from 'zod';
-import type { FileContentQuerySchema } from '@octocodeai/octocode-core/schemas';
-type FileContentQuery = z.infer<typeof FileContentQuerySchema>;
 import type { BulkFinalizer } from '../../types/bulk.js';
-import { type QueryWithPagination } from '../../utils/response/groupedFinalizer.js';
 import type { GitHubFetchContentOutputLocal } from './scheme.js';
-import type { WithOptionalMeta } from '../../types/execution.js';
-type PartialFileContentQuery = WithOptionalMeta<FileContentQuery> & QueryWithPagination;
+import type { PartialFileContentQuery } from './finalizer/types.js';
 export declare function buildGithubFetchContentFinalizer<TQuery extends PartialFileContentQuery>(): BulkFinalizer<TQuery, GitHubFetchContentOutputLocal>;
-export {};

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

@@ -63,27 +63,60 @@ export declare const GitHubFetchContentOutputLocalSchema: z.ZodObject<{
                     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<{
+                modified: z.ZodOptional<z.ZodString>;
+                fileSize: z.ZodOptional<z.ZodNumber>;
+                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";
+                    }>>;
+                    nextPage: z.ZodOptional<z.ZodNumber>;
+                }, 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>;
+                    perPage: z.ZodOptional<z.ZodNumber>;
+                    totalFound: z.ZodOptional<z.ZodNumber>;
+                    returned: z.ZodOptional<z.ZodNumber>;
+                    totalMatches: z.ZodOptional<z.ZodNumber>;
+                    reportedTotalMatches: z.ZodOptional<z.ZodNumber>;
+                    reachableTotalMatches: z.ZodOptional<z.ZodNumber>;
+                    totalMatchesKind: z.ZodOptional<z.ZodEnum<{
+                        exact: "exact";
+                        reported: "reported";
+                        lowerBound: "lowerBound";
+                    }>>;
+                    totalMatchesCapped: z.ZodOptional<z.ZodBoolean>;
+                    totalResults: z.ZodOptional<z.ZodNumber>;
+                    itemsPerPage: z.ZodOptional<z.ZodNumber>;
                     charOffset: z.ZodOptional<z.ZodNumber>;
                     charLength: z.ZodOptional<z.ZodNumber>;
                     totalChars: z.ZodOptional<z.ZodNumber>;
                     nextCharOffset: 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>>;
+                }, z.core.$strip>]>>;
+                next: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    tool: z.ZodString;
+                    query: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                    why: z.ZodOptional<z.ZodString>;
+                    confidence: z.ZodOptional<z.ZodEnum<{
+                        exact: "exact";
+                        heuristic: "heuristic";
+                    }>>;
+                }, z.core.$strip>>>;
                 isPartial: z.ZodOptional<z.ZodBoolean>;
                 startLine: z.ZodOptional<z.ZodNumber>;
                 endLine: z.ZodOptional<z.ZodNumber>;

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

@@ -2,7 +2,7 @@ import type { z } from 'zod';
 import type { FileContentQuerySchema } from '@octocodeai/octocode-core/schemas';
 import type { MinifyMode } from '../../scheme/fields.js';
 type FileContentQuery = z.infer<typeof FileContentQuerySchema>;
-import type { PaginationInfo } from '../../utils/core/types.js';
+import type { PaginationInfo } from '../../types/toolResults.js';
 export type FileContentExecutionQuery = FileContentQuery & {
     noTimestamp?: boolean;
     minify: MinifyMode;
@@ -18,7 +18,6 @@ export interface GitHubFileContentApiData {
     path?: string;
     content?: string;
     contentView?: 'none' | 'standard' | 'symbols';
-    isSkeleton?: boolean;
     branch?: string;
     resolvedBranch?: string;
     startLine?: number;

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

@@ -4,5 +4,14 @@ import type { GitHubCodeSearchQuerySchema } from '@octocodeai/octocode-core/sche
 type GitHubCodeSearchQuery = z.infer<typeof GitHubCodeSearchQuerySchema>;
 import type { ToolExecutionArgs, WithOptionalMeta } from '../../types/execution.js';
 type PartialCodeSearchQuery = WithOptionalMeta<GitHubCodeSearchQuery>;
+export declare function hasValidCodeSearchParams(query: PartialCodeSearchQuery): boolean;
+export type RepoState = {
+    kind: 'notFound';
+} | {
+    kind: 'archived';
+} | {
+    kind: 'renamed';
+    fullName: string;
+};
 export declare function searchMultipleGitHubCode(args: ToolExecutionArgs<PartialCodeSearchQuery>): Promise<CallToolResult>;
 export {};

package/dist/tools/github_search_code/finalizer/build.d.ts

@@ -0,0 +1,4 @@
+import type { BulkFinalizer } from '../../../types/bulk.js';
+import { type QueryWithPagination } from '../../../utils/response/groupedFinalizer.js';
+import type { GitHubCodeSearchOutputLocal } from '../scheme.js';
+export declare function buildGhSearchCodeFinalizer<TQuery extends QueryWithPagination>(): BulkFinalizer<TQuery, GitHubCodeSearchOutputLocal>;

package/dist/tools/github_search_code/finalizer/groups.d.ts

@@ -0,0 +1,23 @@
+import { type QueryWithPagination } from '../../../utils/response/groupedFinalizer.js';
+import type { ToolContinuation } from '../../../scheme/pagination.js';
+import { type CodeSearchGroupedMatch, type CodeSearchGroupedResult, type CodeSearchPagination } from '../../providerMappers.js';
+export type PerQueryGroups = {
+    id: string;
+    groups: CodeSearchGroupedResult[];
+};
+export type CodeSearchFileResult = {
+    owner: string;
+    repo: string;
+    path: string;
+    matches: Array<Omit<CodeSearchGroupedMatch, 'path'>>;
+};
+export type CodeSearchResultRecord = {
+    id: string;
+    data: {
+        files: CodeSearchFileResult[];
+        pagination?: CodeSearchPagination;
+    };
+};
+export declare function mergeGroups(perQuery: readonly PerQueryGroups[]): CodeSearchGroupedResult[];
+export declare function buildResultRecords(queries: readonly QueryWithPagination[], groups: readonly CodeSearchGroupedResult[], paginationByQuery: ReadonlyMap<string, CodeSearchPagination>): CodeSearchResultRecord[];
+export declare function buildNextMap(resultRecords: readonly CodeSearchResultRecord[], queries: readonly QueryWithPagination[], allKeywords: readonly string[]): Record<string, ToolContinuation> | undefined;

package/dist/tools/github_search_code/finalizer/ranking.d.ts

@@ -0,0 +1,12 @@
+import type { FlatQueryResult } from '../../../types/toolResults.js';
+import { type QueryWithPagination } from '../../../utils/response/groupedFinalizer.js';
+import type { RepoState } from '../execution.js';
+import { type CodeSearchFlatResult, type CodeSearchGroupedResult } from '../../providerMappers.js';
+export declare function queryById(queries: readonly QueryWithPagination[]): ReadonlyMap<string, QueryWithPagination>;
+export declare function hasScopedGitHubQuery(emptyQueries: readonly {
+    id: string;
+}[], queries: readonly QueryWithPagination[]): boolean;
+export declare function readPerQueryFlat(result: FlatQueryResult): CodeSearchFlatResult & {
+    repoState?: RepoState;
+};
+export declare function applyExactMatchRanking(groups: readonly CodeSearchGroupedResult[], keywords: readonly string[]): CodeSearchGroupedResult[];

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

@@ -1,6 +1,2 @@
-import type { BulkFinalizer } from '../../types/bulk.js';
-import { type QueryWithPagination } from '../../utils/response/groupedFinalizer.js';
-import type { GitHubCodeSearchOutputLocal } from './scheme.js';
-import { type CodeSearchGroupedResult } from '../providerMappers.js';
-export declare function applyExactMatchRanking(groups: readonly CodeSearchGroupedResult[], keywords: readonly string[]): CodeSearchGroupedResult[];
-export declare function buildGhSearchCodeFinalizer<TQuery extends QueryWithPagination>(): BulkFinalizer<TQuery, GitHubCodeSearchOutputLocal>;
+export { applyExactMatchRanking } from './finalizer/ranking.js';
+export { buildGhSearchCodeFinalizer } from './finalizer/build.js';