@octocodeai/octocode-tools-core 16.2.0 → 16.5.1

package/dist/providers/providerQueries.d.ts

@@ -31,6 +31,7 @@ export interface FileContentQuery extends BaseProviderQuery {
     charOffset?: number;
     charLength?: number;
     fullContent?: boolean;
+    forceRefresh?: boolean;
     minify: 'none' | 'standard' | 'symbols';
 }
 export interface RepoSearchQuery extends BaseProviderQuery {
@@ -84,6 +85,14 @@ export interface PullRequestQuery extends BaseProviderQuery {
     interactions?: number | string;
     draft?: boolean;
     match?: Array<'title' | 'body' | 'comments'>;
+    milestone?: string;
+    language?: string;
+    checks?: 'pending' | 'success' | 'failure';
+    review?: 'none' | 'required' | 'approved' | 'changes_requested';
+    locked?: boolean;
+    visibility?: 'public' | 'private';
+    teamMentions?: string;
+    project?: string;
     archived?: boolean;
     content?: unknown;
     reviewMode?: 'summary' | 'full';

package/dist/providers/providerResults.d.ts

@@ -42,6 +42,8 @@ export interface CodeSearchResult {
         branch?: string;
     };
     nonExistentScope?: boolean;
+    /** Provider's search index did not fully complete (GitHub incomplete_results) — empty/partial results may be a false negative. */
+    incompleteResults?: boolean;
 }
 export interface FileContentResult {
     path: string;

package/dist/scheme/coreSchemas.d.ts

@@ -1,10 +1,10 @@
 import { z } from 'zod';
 type AnyZodObject = z.ZodObject<z.ZodRawShape>;
 export type QueryShape = Record<string, z.ZodTypeAny>;
-export declare function describeQuerySchema<T extends AnyZodObject>(coreSchema: T, overrides?: QueryShape, options?: {
+type QuerySchemaOptions = {
     strict?: boolean;
-}): T;
-export declare function createQueryShapeSchema<T extends AnyZodObject>(coreSchema: T, overrides?: QueryShape, options?: {
-    strict?: boolean;
-}): AnyZodObject;
+    omit?: readonly string[];
+};
+export declare function describeQuerySchema<T extends AnyZodObject>(coreSchema: T, overrides?: QueryShape, options?: QuerySchemaOptions): T;
+export declare function createQueryShapeSchema<T extends AnyZodObject>(coreSchema: T, overrides?: QueryShape, options?: QuerySchemaOptions): AnyZodObject;
 export {};

package/dist/scheme/fields.d.ts

@@ -1,13 +1,13 @@
 import { z } from 'zod';
-export declare function clampedInt(min: number, max: number): z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>;
+export declare function clampedInt(min: number, max: number): z.ZodPreprocess<z.ZodNumber>;
 export type MinifyMode = 'none' | 'standard' | 'symbols';
-export declare const relaxedPageNumberField: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>>;
-export declare const contextLinesField: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
-export declare const lineNumberField: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+export declare const relaxedPageNumberField: z.ZodDefault<z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>>;
+export declare const contextLinesField: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
+export declare const lineNumberField: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
 export declare function createRelaxedBulkQuerySchema(querySchema: z.ZodTypeAny, options?: {
     maxQueries?: number;
 }): z.ZodObject<{
-    responseCharOffset: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
-    responseCharLength: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    responseCharOffset: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
+    responseCharLength: z.ZodOptional<z.ZodPreprocess<z.ZodNumber>>;
     queries: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
 }, z.core.$strip>;

package/dist/serverConfig.d.ts

@@ -1,5 +1,5 @@
 import type { ProviderType } from './providers/types.js';
-import { resolveTokenFull } from 'octocode-shared';
+import { resolveTokenFull } from './shared/index.js';
 import type { ServerConfig, TokenSourceType } from './types/server.js';
 type ResolveTokenFullFn = typeof resolveTokenFull;
 export declare function _setTokenResolvers(resolvers: {

package/dist/session.d.ts

@@ -1,4 +1,4 @@
-import { type PersistedSession } from 'octocode-shared';
+import { type PersistedSession } from './shared/index.js';
 import type { RateLimitData } from './types/session.js';
 declare class SessionManager {
     private session;

package/dist/shared/config/defaults.d.ts

@@ -0,0 +1,15 @@
+import type { RequiredGitHubConfig, RequiredLocalConfig, RequiredToolsConfig, RequiredNetworkConfig, RequiredTelemetryConfig, RequiredLspConfig, RequiredOutputConfig, ResolvedConfig } from './types.js';
+export declare const DEFAULT_GITHUB_CONFIG: RequiredGitHubConfig;
+export declare const DEFAULT_LOCAL_CONFIG: RequiredLocalConfig;
+export declare const DEFAULT_TOOLS_CONFIG: RequiredToolsConfig;
+export declare const DEFAULT_NETWORK_CONFIG: RequiredNetworkConfig;
+export declare const DEFAULT_TELEMETRY_CONFIG: RequiredTelemetryConfig;
+export declare const DEFAULT_LSP_CONFIG: RequiredLspConfig;
+export declare const DEFAULT_OUTPUT_CONFIG: RequiredOutputConfig;
+export declare const DEFAULT_CONFIG: Omit<ResolvedConfig, 'source' | 'configPath'>;
+export declare const MIN_TIMEOUT = 5000;
+export declare const MAX_TIMEOUT = 300000;
+export declare const MIN_RETRIES = 0;
+export declare const MAX_RETRIES = 10;
+export declare const MIN_OUTPUT_DEFAULT_CHAR_LENGTH = 1000;
+export declare const MAX_OUTPUT_DEFAULT_CHAR_LENGTH = 50000;

package/dist/shared/config/index.d.ts

@@ -0,0 +1,10 @@
+export type { OctocodeConfig, ResolvedConfig, ValidationResult, LoadConfigResult, GitHubConfigOptions, LocalConfigOptions, ToolsConfigOptions, NetworkConfigOptions, TelemetryConfigOptions, LspConfigOptions, OutputConfigOptions, OutputPaginationConfigOptions, RequiredGitHubConfig, RequiredLocalConfig, RequiredToolsConfig, RequiredNetworkConfig, RequiredTelemetryConfig, RequiredLspConfig, RequiredOutputConfig, RequiredOutputPaginationConfig, MinifyMode, } from './types.js';
+export { CONFIG_SCHEMA_VERSION, CONFIG_FILE_NAME } from './types.js';
+export { DEFAULT_CONFIG, DEFAULT_GITHUB_CONFIG, DEFAULT_LOCAL_CONFIG, DEFAULT_TOOLS_CONFIG, DEFAULT_NETWORK_CONFIG, DEFAULT_TELEMETRY_CONFIG, DEFAULT_LSP_CONFIG, DEFAULT_OUTPUT_CONFIG, MIN_TIMEOUT, MAX_TIMEOUT, MIN_RETRIES, MAX_RETRIES, MIN_OUTPUT_DEFAULT_CHAR_LENGTH, MAX_OUTPUT_DEFAULT_CHAR_LENGTH, } from './defaults.js';
+export { CONFIG_FILE_PATH } from './loader.js';
+export { loadConfig, loadConfigSync, configExists, getConfigPath, getOctocodeDir, } from './loader.js';
+export { validateConfig } from './validator.js';
+export { getConfig, getConfigSync, reloadConfig, resolveConfig, resolveConfigSync, invalidateConfigCache, getConfigValue, _resetConfigCache, _getCacheState, } from './resolver.js';
+export { parseLoggingEnv } from './resolverSections.js';
+export { setRuntimeSurface, getRuntimeSurface, _resetRuntimeSurface, type RuntimeSurface, } from './runtimeSurface.js';
+export { OctocodeConfigSchema } from './schemas.js';

package/dist/shared/config/index.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { createRequire as __createRequire } from 'module';
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __dirname_fn } from 'path';
+const require = __createRequire(import.meta.url);
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __dirname_fn(__filename);
+var b=1,Ce=".octocoderc";var v={apiUrl:"https://api.github.com"},f={enabled:!1,enableClone:!1,allowedPaths:[],workspaceRoot:void 0},d={enabled:null,enableAdditional:null,disabled:null},C={timeout:3e4,maxRetries:3},A={logging:!0},w={configPath:void 0},g={format:"yaml",pagination:{defaultCharLength:2e4}},M={version:1,github:v,local:f,tools:d,network:C,telemetry:A,lsp:w,output:g},m=5e3,O=3e5,R=0,T=10,h=1e3,L=5e4;import{existsSync as Z,readFileSync as he}from"node:fs";import{existsSync as Ze,mkdirSync as en}from"node:fs";import{join as u}from"node:path";import y from"node:os";import me from"node:path";var x=y.platform()==="win32",P=y.platform()==="darwin",Oe=y.platform()==="linux",p=y.homedir();function F(){return x?process.env.APPDATA||me.join(p,"AppData","Roaming"):p}var D=".octocode";function Re(e){let n=process.env[e];return n&&n.trim().length>0?n:void 0}function Te(){return x?u(F(),D):P?u(p,D):u(Re("XDG_CONFIG_HOME")??u(p,".config"),D)}var a=Te(),H={home:a,config:u(a,".octocoderc"),credentials:u(a,"credentials.json"),key:u(a,".key"),session:u(a,"session.json"),stats:u(a,"stats.json"),tmp:u(a,"tmp"),clone:u(a,"tmp","clone"),tree:u(a,"tmp","tree"),binary:u(a,"tmp","binary"),repos:u(a,"tmp","clone"),logs:u(a,"logs"),unzip:u(a,"tmp","unzip"),cliConfig:u(a,"config.json"),lspConfig:u(a,"lsp-servers.json")};import{z as s}from"zod";var G=s.looseObject({$schema:s.string().optional(),version:s.number().int().optional(),github:s.record(s.string(),s.unknown()).optional(),local:s.record(s.string(),s.unknown()).optional(),tools:s.record(s.string(),s.unknown()).optional(),network:s.record(s.string(),s.unknown()).optional(),telemetry:s.record(s.string(),s.unknown()).optional(),lsp:s.record(s.string(),s.unknown()).optional(),output:s.record(s.string(),s.unknown()).optional()});var U=H.config;function Le(e){let n="",o=0,t=!1,r="";for(;o<e.length;){let i=e[o],l=e[o+1];if(!t&&(i==='"'||i==="'")){t=!0,r=i,n+=i,o++;continue}if(t){if(n+=i,i==="\\"&&o+1<e.length){n+=e[o+1],o+=2;continue}i===r&&(t=!1),o++;continue}if(i==="/"&&l==="/"){for(;o<e.length&&e[o]!==`
+`;)o++;continue}if(i==="/"&&l==="*"){for(o+=2;o<e.length-1;){if(e[o]==="*"&&e[o+1]==="/"){o+=2;break}o++}continue}n+=i,o++}return n=n.replace(/,(\s*[}\]])/g,"$1"),n}function Ee(e){let n=Le(e);return JSON.parse(n)}function q(){return Z(U)}async function _e(){return N()}function N(){let e=U;if(!Z(e))return{success:!1,error:"Config file does not exist",path:e};try{let n=he(e,"utf-8");if(!n.trim())return{success:!0,config:{},path:e};let o=Ee(n),t=G.safeParse(o);return t.success?{success:!0,config:t.data,path:e}:{success:!1,error:`Config file has invalid structure: ${t.error.issues[0]?.message??"unknown error"}`,path:e}}catch(n){return{success:!1,error:`Failed to parse config file: ${n instanceof Error?n.message:"Unknown error"}`,path:e}}}function be(){return U}function ve(){return H.home}function Ae(e,n){if(e==null)return null;if(typeof e!="string")return`${n}: Must be a string`;try{let o=new URL(e);return["http:","https:"].includes(o.protocol)?null:`${n}: Only http/https URLs allowed`}catch{return`${n}: Invalid URL format`}}function $(e,n,o,t){return e==null?null:typeof e!="number"||isNaN(e)?`${n}: Must be a number`:e<o||e>t?`${n}: Must be between ${o} and ${t}`:null}function W(e,n){return e==null?null:typeof e!="boolean"?`${n}: Must be a boolean`:null}function ee(e,n){if(e==null)return null;if(!Array.isArray(e))return`${n}: Must be an array`;for(let o=0;o<e.length;o++)if(typeof e[o]!="string")return`${n}[${o}]: Must be a string`;return null}function we(e){let n=[];for(let o=0;o<e.length;o++){let t=e[o];typeof t=="string"&&(t.trim()===""?n.push(`local.allowedPaths[${o}]: empty or whitespace-only path`):!t.startsWith("/")&&!t.startsWith("~")?n.push(`local.allowedPaths[${o}]: must be absolute path or start with ~ (got "${t}")`):t.includes("..")&&n.push(`local.allowedPaths[${o}]: path traversal (..) not allowed (got "${t}")`))}return n}function j(e,n){return e===void 0||e===null?null:ee(e,n)}function ne(e,n){return e==null?null:typeof e!="string"?`${n}: Must be a string`:null}function ye(e,n){if(e==null)return;if(typeof e!="object"||Array.isArray(e)){n.push("github: Must be an object");return}let t=Ae(e.apiUrl,"github.apiUrl");t&&n.push(t)}function xe(e,n){if(e==null)return;if(typeof e!="object"||Array.isArray(e)){n.push("local: Must be an object");return}let o=e,t=W(o.enabled,"local.enabled");t&&n.push(t);let r=W(o.enableClone,"local.enableClone");r&&n.push(r);let i=ee(o.allowedPaths,"local.allowedPaths");if(i)n.push(i);else if(Array.isArray(o.allowedPaths)){let l=we(o.allowedPaths);n.push(...l)}if(o.workspaceRoot!==void 0&&o.workspaceRoot!==null){let l=ne(o.workspaceRoot,"local.workspaceRoot");l?n.push(l):typeof o.workspaceRoot=="string"&&!o.workspaceRoot.startsWith("/")&&!o.workspaceRoot.startsWith("~")?n.push('local.workspaceRoot: must be an absolute path or start with ~ (got "'+o.workspaceRoot+'")'):typeof o.workspaceRoot=="string"&&o.workspaceRoot.includes("..")&&n.push('local.workspaceRoot: path traversal (..) not allowed (got "'+o.workspaceRoot+'")')}}function Ue(e,n){if(e==null)return;if(typeof e!="object"||Array.isArray(e)){n.push("tools: Must be an object");return}let o=e,t=j(o.enabled,"tools.enabled");t&&n.push(t);let r=j(o.enableAdditional,"tools.enableAdditional");r&&n.push(r);let i=j(o.disabled,"tools.disabled");i&&n.push(i)}function Ne(e,n){if(e==null)return;if(typeof e!="object"||Array.isArray(e)){n.push("network: Must be an object");return}let o=e,t=$(o.timeout,"network.timeout",m,O);t&&n.push(t);let r=$(o.maxRetries,"network.maxRetries",R,T);r&&n.push(r)}function ke(e,n){if(e==null)return;if(typeof e!="object"||Array.isArray(e)){n.push("telemetry: Must be an object");return}let t=W(e.logging,"telemetry.logging");t&&n.push(t)}function Se(e,n){if(e==null)return;if(typeof e!="object"||Array.isArray(e)){n.push("lsp: Must be an object");return}let t=ne(e.configPath,"lsp.configPath");t&&n.push(t)}function Ie(e,n){if(e==null)return;if(typeof e!="object"||Array.isArray(e)){n.push("output: Must be an object");return}let o=e;if(o.format!==void 0&&(typeof o.format!="string"?n.push("output.format: Must be a string"):["yaml","json"].includes(o.format)||n.push("output.format: Must be one of: yaml, json")),o.pagination!==void 0&&o.pagination!==null)if(typeof o.pagination!="object"||Array.isArray(o.pagination))n.push("output.pagination: Must be an object");else{let t=o.pagination,r=$(t.defaultCharLength,"output.pagination.defaultCharLength",h,L);r&&n.push(r)}}function B(e){let n=[],o=[];if(typeof e!="object"||e===null||Array.isArray(e))return{valid:!1,errors:["Configuration must be a JSON object"],warnings:[]};let t=e;t.version!==void 0&&(typeof t.version!="number"||!Number.isInteger(t.version)?n.push("version: Must be an integer"):t.version>1&&o.push(`version: Config version ${t.version} is newer than supported version ${1}`)),ye(t.github,n),xe(t.local,n),Ue(t.tools,n),Ne(t.network,n),ke(t.telemetry,n),Se(t.lsp,n),Ie(t.output,n);let r=new Set(["$schema","version","github","local","tools","network","telemetry","lsp","output"]);for(let i of Object.keys(t))r.has(i)||o.push(`Unknown configuration key: ${i}`);return{valid:n.length===0,errors:n,warnings:o,config:n.length===0?e:void 0}}var Me=null;function Pe(e){let n=`[${e.module}]`,o=e.data&&Object.keys(e.data).length>0?` ${JSON.stringify(e.data)}`:"";process.stderr.write(`${n} ${e.level}: ${e.message}${o}
+`)}function X(e){function n(o,t,r){let i={level:o,module:e,message:t,...r&&{data:r}};(Me??Pe)(i)}return{debug:(o,t)=>n("debug",o,t),info:(o,t)=>n("info",o,t),warn:(o,t)=>n("warn",o,t),error:(o,t)=>n("error",o,t)}}var V="__octocodeRuntimeSurface__";function Fe(e){globalThis[V]=e}function K(){return globalThis[V]??"mcp"}function De(){delete globalThis[V]}function oe(e){if(e==null)return;let n=e.trim().toLowerCase();if(n!==""){if(n==="true"||n==="1")return!0;if(n==="false"||n==="0")return!1}}function z(e){if(e==null)return;let n=e.trim();if(n==="")return;let o=parseInt(n,10);if(!isNaN(o))return o}function k(e){if(e==null)return;let n=e.trim();if(n!=="")return n.split(",").map(o=>o.trim()).filter(o=>o.length>0)}function te(e){if(e==null)return;let n=e.trim().toLowerCase();if(n!=="")return!(n==="false"||n==="0")}function re(e){return{apiUrl:process.env.GITHUB_API_URL?.trim()||e?.apiUrl||v.apiUrl}}function ie(e){let n=K()==="cli",o=oe(process.env.ENABLE_LOCAL),t=oe(process.env.ENABLE_CLONE),r=k(process.env.ALLOWED_PATHS),i=process.env.WORKSPACE_ROOT?.trim()||void 0;return{enabled:o??e?.enabled??(n?!0:f.enabled),enableClone:t??e?.enableClone??(n?!0:f.enableClone),allowedPaths:r??e?.allowedPaths??f.allowedPaths,workspaceRoot:i??e?.workspaceRoot??f.workspaceRoot}}function se(e){let n=k(process.env.TOOLS_TO_RUN),o=k(process.env.ENABLE_TOOLS),t=k(process.env.DISABLE_TOOLS);return{enabled:n??e?.enabled??d.enabled,enableAdditional:o??e?.enableAdditional??d.enableAdditional,disabled:t??e?.disabled??d.disabled}}function ue(e){let n=z(process.env.REQUEST_TIMEOUT),o=z(process.env.MAX_RETRIES),t=n??e?.timeout??C.timeout;t=Math.max(m,Math.min(O,t));let r=o??e?.maxRetries??C.maxRetries;return r=Math.max(R,Math.min(T,r)),{timeout:t,maxRetries:r}}function ae(e){return{logging:te(process.env.LOG)??e?.logging??A.logging}}function le(e){return{configPath:(process.env.OCTOCODE_LSP_CONFIG?.trim()||void 0)??e?.configPath??w.configPath}}var He=new Set(["yaml","json"]);function fe(e){let n=process.env.OCTOCODE_OUTPUT_FORMAT?.trim().toLowerCase(),o=z(process.env.OCTOCODE_OUTPUT_DEFAULT_CHAR_LENGTH),t=n||e?.format||g.format,r=o??e?.pagination?.defaultCharLength??g.pagination.defaultCharLength,i=Math.max(h,Math.min(L,r));return{format:He.has(t)?t:g.format,pagination:{defaultCharLength:i}}}var S=X("octocode-config");function J(e,n){let o=e!==void 0,t=process.env.GITHUB_API_URL!==void 0||process.env.ENABLE_LOCAL!==void 0||process.env.ENABLE_CLONE!==void 0||process.env.ALLOWED_PATHS!==void 0||process.env.WORKSPACE_ROOT!==void 0||process.env.TOOLS_TO_RUN!==void 0||process.env.ENABLE_TOOLS!==void 0||process.env.DISABLE_TOOLS!==void 0||process.env.REQUEST_TIMEOUT!==void 0||process.env.MAX_RETRIES!==void 0||process.env.LOG!==void 0||process.env.OCTOCODE_LSP_CONFIG!==void 0||process.env.OCTOCODE_OUTPUT_FORMAT!==void 0||process.env.OCTOCODE_OUTPUT_DEFAULT_CHAR_LENGTH!==void 0,r;return o&&t?r="mixed":o?r="file":r="defaults",{version:e?.version??M.version,github:re(e?.github),local:ie(e?.local),tools:se(e?.tools),network:ue(e?.network),telemetry:ae(e?.telemetry),lsp:le(e?.lsp),output:fe(e?.output),source:r,configPath:o?n:void 0}}function I(){let e=N();if(e.success&&e.config){let n=B(e.config);if(n.warnings.length>0)for(let o of n.warnings)S.warn(`Warning: ${o}`);if(!n.valid){for(let o of n.errors)S.warn(`Validation error: ${o}`);return S.warn("Config file has validation errors \u2014 falling back to defaults with env overrides"),J(void 0)}return J(e.config,e.path)}return e.error&&q()&&S.warn(e.error),J(void 0)}async function ce(){return I()}var c=null,E=0,Ge=6e4;function _(){let e=Date.now();return c&&e-E<Ge||(c=I(),E=e),c}async function Y(){return _()}async function de(){return Q(),Y()}function Q(){c=null,E=0}function ge(){c=null,E=0}function pe(){return{cached:c!==null,timestamp:E}}function qe(e){let n=_(),o=e.split("."),t=n;for(let r of o){if(t==null||typeof t!="object")return;t=t[r]}return t}export{Ce as CONFIG_FILE_NAME,U as CONFIG_FILE_PATH,b as CONFIG_SCHEMA_VERSION,M as DEFAULT_CONFIG,v as DEFAULT_GITHUB_CONFIG,f as DEFAULT_LOCAL_CONFIG,w as DEFAULT_LSP_CONFIG,C as DEFAULT_NETWORK_CONFIG,g as DEFAULT_OUTPUT_CONFIG,A as DEFAULT_TELEMETRY_CONFIG,d as DEFAULT_TOOLS_CONFIG,L as MAX_OUTPUT_DEFAULT_CHAR_LENGTH,T as MAX_RETRIES,O as MAX_TIMEOUT,h as MIN_OUTPUT_DEFAULT_CHAR_LENGTH,R as MIN_RETRIES,m as MIN_TIMEOUT,G as OctocodeConfigSchema,pe as _getCacheState,ge as _resetConfigCache,De as _resetRuntimeSurface,q as configExists,Y as getConfig,be as getConfigPath,_ as getConfigSync,qe as getConfigValue,ve as getOctocodeDir,K as getRuntimeSurface,Q as invalidateConfigCache,_e as loadConfig,N as loadConfigSync,te as parseLoggingEnv,de as reloadConfig,ce as resolveConfig,I as resolveConfigSync,Fe as setRuntimeSurface,B as validateConfig};

package/dist/shared/config/loader.d.ts

@@ -0,0 +1,7 @@
+import type { LoadConfigResult } from './types.js';
+export declare const CONFIG_FILE_PATH: string;
+export declare function configExists(): boolean;
+export declare function loadConfig(): Promise<LoadConfigResult>;
+export declare function loadConfigSync(): LoadConfigResult;
+export declare function getConfigPath(): string;
+export declare function getOctocodeDir(): string;

package/dist/shared/config/resolver.d.ts

@@ -0,0 +1,2 @@
+export { resolveConfigSync, resolveConfig, getConfig, getConfigSync, reloadConfig, invalidateConfigCache, _resetConfigCache, _getCacheState, } from './resolverCache.js';
+export declare function getConfigValue<T = unknown>(path: string): T | undefined;

package/dist/shared/config/resolverCache.d.ts

@@ -0,0 +1,12 @@
+import type { ResolvedConfig } from './types.js';
+export declare function resolveConfigSync(): ResolvedConfig;
+export declare function resolveConfig(): Promise<ResolvedConfig>;
+export declare function getConfigSync(): ResolvedConfig;
+export declare function getConfig(): Promise<ResolvedConfig>;
+export declare function reloadConfig(): Promise<ResolvedConfig>;
+export declare function invalidateConfigCache(): void;
+export declare function _resetConfigCache(): void;
+export declare function _getCacheState(): {
+    cached: boolean;
+    timestamp: number;
+};

package/dist/shared/config/resolverSections.d.ts

@@ -0,0 +1,12 @@
+import type { OctocodeConfig, RequiredGitHubConfig, RequiredLocalConfig, RequiredToolsConfig, RequiredNetworkConfig, RequiredTelemetryConfig, RequiredLspConfig, RequiredOutputConfig } from './types.js';
+export declare function parseBooleanEnv(value: string | undefined): boolean | undefined;
+export declare function parseIntEnv(value: string | undefined): number | undefined;
+export declare function parseStringArrayEnv(value: string | undefined): string[] | undefined;
+export declare function parseLoggingEnv(value: string | undefined): boolean | undefined;
+export declare function resolveGitHub(fileConfig?: OctocodeConfig['github']): RequiredGitHubConfig;
+export declare function resolveLocal(fileConfig?: OctocodeConfig['local']): RequiredLocalConfig;
+export declare function resolveTools(fileConfig?: OctocodeConfig['tools']): RequiredToolsConfig;
+export declare function resolveNetwork(fileConfig?: OctocodeConfig['network']): RequiredNetworkConfig;
+export declare function resolveTelemetry(fileConfig?: OctocodeConfig['telemetry']): RequiredTelemetryConfig;
+export declare function resolveLsp(fileConfig?: OctocodeConfig['lsp']): RequiredLspConfig;
+export declare function resolveOutput(fileConfig?: OctocodeConfig['output']): RequiredOutputConfig;

package/dist/shared/config/runtimeSurface.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Which interface is driving the shared tool core right now.
+ *
+ * Some config defaults differ by surface (see `resolveLocal`):
+ *   - `cli`: `ENABLE_LOCAL` is honored and defaults to ENABLED; clone defaults
+ *     to ENABLED.
+ *   - `mcp`: `ENABLE_LOCAL` is honored and defaults to DISABLED; clone defaults
+ *     to DISABLED.
+ *
+ * Defaults to `mcp`, the primary consumer. The CLI binary calls
+ * `setRuntimeSurface('cli')` at startup before any tool runs.
+ *
+ * State lives on `globalThis` (not a module-level variable) so a single shared
+ * value is seen even when bundlers (esbuild) inline this module more than once
+ * across different package subpath entry points (`/config`, `/direct`, …).
+ */
+export type RuntimeSurface = 'cli' | 'mcp';
+export declare function setRuntimeSurface(surface: RuntimeSurface): void;
+export declare function getRuntimeSurface(): RuntimeSurface;
+/** Test helper: restore the default surface. */
+export declare function _resetRuntimeSurface(): void;

package/dist/shared/config/schemas.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export declare const OctocodeConfigSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodNumber>;
+    github: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    local: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    network: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    telemetry: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    lsp: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    output: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;

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

@@ -0,0 +1,100 @@
+export declare const CONFIG_SCHEMA_VERSION = 1;
+export declare const CONFIG_FILE_NAME = ".octocoderc";
+export interface GitHubConfigOptions {
+    apiUrl?: string;
+}
+export interface LocalConfigOptions {
+    enabled?: boolean;
+    enableClone?: boolean;
+    allowedPaths?: string[];
+    workspaceRoot?: string;
+}
+export interface ToolsConfigOptions {
+    enabled?: string[] | null;
+    enableAdditional?: string[] | null;
+    disabled?: string[] | null;
+}
+export interface NetworkConfigOptions {
+    timeout?: number;
+    maxRetries?: number;
+}
+export interface TelemetryConfigOptions {
+    logging?: boolean;
+}
+export interface LspConfigOptions {
+    configPath?: string;
+}
+export interface OutputPaginationConfigOptions {
+    defaultCharLength?: number;
+}
+export type MinifyMode = 'none' | 'standard' | 'symbols';
+export interface OutputConfigOptions {
+    format?: 'yaml' | 'json';
+    pagination?: OutputPaginationConfigOptions;
+}
+export interface OctocodeConfig {
+    $schema?: string;
+    version?: number;
+    github?: GitHubConfigOptions;
+    local?: LocalConfigOptions;
+    tools?: ToolsConfigOptions;
+    network?: NetworkConfigOptions;
+    telemetry?: TelemetryConfigOptions;
+    lsp?: LspConfigOptions;
+    output?: OutputConfigOptions;
+}
+export interface RequiredGitHubConfig {
+    apiUrl: string;
+}
+export interface RequiredLocalConfig {
+    enabled: boolean;
+    enableClone: boolean;
+    allowedPaths: string[];
+    workspaceRoot: string | undefined;
+}
+export interface RequiredToolsConfig {
+    enabled: string[] | null;
+    enableAdditional: string[] | null;
+    disabled: string[] | null;
+}
+export interface RequiredNetworkConfig {
+    timeout: number;
+    maxRetries: number;
+}
+export interface RequiredTelemetryConfig {
+    logging: boolean;
+}
+export interface RequiredLspConfig {
+    configPath: string | undefined;
+}
+export interface RequiredOutputPaginationConfig {
+    defaultCharLength: number;
+}
+export interface RequiredOutputConfig {
+    format: 'yaml' | 'json';
+    pagination: RequiredOutputPaginationConfig;
+}
+export interface ResolvedConfig {
+    version: number;
+    github: RequiredGitHubConfig;
+    local: RequiredLocalConfig;
+    tools: RequiredToolsConfig;
+    network: RequiredNetworkConfig;
+    telemetry: RequiredTelemetryConfig;
+    lsp: RequiredLspConfig;
+    output: RequiredOutputConfig;
+    source: 'file' | 'defaults' | 'mixed';
+    configPath?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    config?: OctocodeConfig;
+}
+export interface LoadConfigResult {
+    success: boolean;
+    config?: OctocodeConfig;
+    error?: string;
+    path: string;
+}

package/dist/shared/config/validator.d.ts

@@ -0,0 +1,2 @@
+import type { ValidationResult } from './types.js';
+export declare function validateConfig(config: unknown): ValidationResult;

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

@@ -0,0 +1,2 @@
+export declare const OCTOCODE_GITHUB_APP_CLIENT_ID = "178c6fc778ccc68e1d6a";
+export declare const DEFAULT_HOSTNAME = "github.com";

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

@@ -0,0 +1,13 @@
+import type { StoredCredentials } from './types.js';
+export declare function invalidateCredentialsCache(hostname?: string): void;
+export declare function _getCacheStats(): {
+    size: number;
+    entries: Array<{
+        hostname: string;
+        age: number;
+        valid: boolean;
+    }>;
+};
+export declare function _resetCredentialsCache(): void;
+export declare function getCachedCredentials(hostname: string): StoredCredentials | null | undefined;
+export declare function setCachedCredentials(hostname: string, credentials: StoredCredentials | null): void;

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

@@ -0,0 +1,10 @@
+import type { CredentialsStore } from './types.js';
+export declare const OCTOCODE_DIR: string;
+export declare const CREDENTIALS_FILE: string;
+export declare const KEY_FILE: string;
+export declare function ensureOctocodeDir(): void;
+export declare function encrypt(data: string): string;
+export declare function decrypt(encryptedData: string): string;
+export declare function readCredentialsStore(): CredentialsStore;
+export declare function writeCredentialsStore(store: CredentialsStore): void;
+export declare function cleanupKeyFile(): void;

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

@@ -0,0 +1,4 @@
+import type { StoredCredentials } from './types.js';
+export declare function normalizeHostname(hostname: string): string;
+export declare function isTokenExpired(credentials: StoredCredentials): boolean;
+export declare function isRefreshTokenExpired(credentials: StoredCredentials): boolean;

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

@@ -0,0 +1,9 @@
+import type { TokenSource } from './types.js';
+export declare const ENV_TOKEN_VARS: readonly ["OCTOCODE_TOKEN", "GH_TOKEN", "GITHUB_TOKEN"];
+export declare function getTokenFromEnv(): string | null;
+export declare function getEnvTokenSource(): TokenSource;
+export declare function hasEnvToken(): boolean;
+export declare function resolveEnvToken(): {
+    token: string;
+    source: NonNullable<TokenSource>;
+} | null;

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

@@ -0,0 +1 @@
+export declare function getGhCliToken(hostname?: string): Promise<string | null>;

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

@@ -0,0 +1,3 @@
+export type { OAuthToken, StoredCredentials, StoreResult, DeleteResult, CredentialsStore, TokenSource, } from './types.js';
+export { storeCredentials, getCredentials, type GetCredentialsOptions, getCredentialsSync, deleteCredentials, updateToken, invalidateCredentialsCache, getToken, getTokenSync, resolveToken, type ResolvedToken, getTokenWithRefresh, type TokenWithRefreshResult, resolveTokenWithRefresh, type ResolvedTokenWithRefresh, refreshAuthToken, type RefreshResult, resolveTokenFull, type FullTokenResolution, type GhCliTokenGetter, resetTokenResolution, listStoredHosts, listStoredHostsSync, hasCredentials, hasCredentialsSync, isTokenExpired, isRefreshTokenExpired, getCredentialsFilePath, readCredentialsStore, encrypt, decrypt, ensureOctocodeDir, OCTOCODE_DIR, CREDENTIALS_FILE, KEY_FILE, ENV_TOKEN_VARS, getTokenFromEnv, getEnvTokenSource, hasEnvToken, } from './storage.js';
+export { getGhCliToken } from './ghCli.js';

package/dist/shared/credentials/index.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { createRequire as __createRequire } from 'module';
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __dirname_fn } from 'path';
+const require = __createRequire(import.meta.url);
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __dirname_fn(__filename);
+var pe=null;function ge(e){let t=`[${e.module}]`,r=e.data&&Object.keys(e.data).length>0?` ${JSON.stringify(e.data)}`:"";process.stderr.write(`${t} ${e.level}: ${e.message}${r}
+`)}function R(e){function t(r,n,o){let s={level:r,module:e,message:n,...o&&{data:o}};(pe??ge)(s)}return{debug:(r,n)=>t("debug",r,n),info:(r,n)=>t("info",r,n),warn:(r,n)=>t("warn",r,n),error:(r,n)=>t("error",r,n)}}function c(e){return e.toLowerCase().replace(/^https?:\/\//,"").replace(/\/$/,"")}function d(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 A(e){if(!e.token.refreshTokenExpiresAt)return!1;let t=new Date(e.token.refreshTokenExpiresAt);return isNaN(t.getTime())?!0:new Date>=t}var S=new Map,he=300*1e3;function me(e){let t=c(e),r=S.get(t);return!r||Date.now()-r.cachedAt>=he?!1:r.credentials?!d(r.credentials):!0}function b(e){e?S.delete(c(e)):S.clear()}function $(e){let t=c(e);if(me(t))return S.get(t).credentials}function U(e,t){let r=c(e);S.set(r,{credentials:t,cachedAt:Date.now()})}import{existsSync as _,readFileSync as Y,writeFileSync as q,unlinkSync as Z,statSync as Ae,chmodSync as be}from"node:fs";import{createCipheriv as Oe,createDecipheriv as we,randomBytes as X}from"node:crypto";import{existsSync as xe,mkdirSync as Ce}from"node:fs";import{join as i}from"node:path";import O from"node:os";import ke from"node:path";var w=O.platform()==="win32",P=O.platform()==="darwin",Te=O.platform()==="linux",k=O.homedir();function H(){return w?process.env.APPDATA||ke.join(k,"AppData","Roaming"):k}var F=".octocode",ye=448;function Re(e){let t=process.env[e];return t&&t.trim().length>0?t:void 0}function Se(){return w?i(H(),F):P?i(k,F):i(Re("XDG_CONFIG_HOME")??i(k,".config"),F)}var l=Se(),T={home:l,config:i(l,".octocoderc"),credentials:i(l,"credentials.json"),key:i(l,".key"),session:i(l,"session.json"),stats:i(l,"stats.json"),tmp:i(l,"tmp"),clone:i(l,"tmp","clone"),tree:i(l,"tmp","tree"),binary:i(l,"tmp","binary"),repos:i(l,"tmp","clone"),logs:i(l,"logs"),unzip:i(l,"tmp","unzip"),cliConfig:i(l,"config.json"),lspConfig:i(l,"lsp-servers.json")};function B(){xe(T.home)||Ce(T.home,{recursive:!0,mode:ye})}import{z as a}from"zod";var ve=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()}),Ee=a.object({hostname:a.string(),username:a.string(),token:ve,gitProtocol:a.enum(["ssh","https"]),createdAt:a.string(),updatedAt:a.string()}),V=a.object({version:a.number(),credentials:a.record(a.string(),Ee)});var J=R("token-storage");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***")}var Q=T.home,u=T.credentials,f=T.key,ee="aes-256-gcm",De=16;function v(){B()}function te(){if(v(),_(f))return Ae(f).mode&511&63&&be(f,384),Buffer.from(Y(f,"utf8"),"hex");let e=X(32);return q(f,e.toString("hex"),{mode:384}),e}function N(e){let t=te(),r=X(De),n=Oe(ee,t,r),o=n.update(e,"utf8","hex");o+=n.final("hex");let s=n.getAuthTag();return`${r.toString("hex")}:${s.toString("hex")}:${o}`}function G(e){let t=te(),[r,n,o]=e.split(":");if(!r||!n||!o)throw new Error("Invalid encrypted data format");let s=Buffer.from(r,"hex"),m=Buffer.from(n,"hex"),h=we(ee,t,s);h.setAuthTag(m);let y=h.update(o,"hex","utf8");return y+=h.final("utf8"),y}function p(){if(v(),!_(u))return{version:1,credentials:{}};try{let e=Y(u,"utf8"),t=G(e),r=JSON.parse(t),n=V.safeParse(r);return n.success?n.data:(J.warn("Credentials file has invalid format \u2014 starting fresh",{file:u}),{version:1,credentials:{}})}catch(e){let t=e instanceof Error&&e.message?_e(e.message):void 0;return J.warn("Could not read credentials file \u2014 you may need to login again",{file:u,...t&&{reason:t}}),{version:1,credentials:{}}}}function I(e){v();let t=N(JSON.stringify(e,null,2));q(u,t,{mode:384})}function re(){try{_(u)&&Z(u),_(f)&&Z(f)}catch{}}import{refreshToken as Le}from"@octokit/oauth-methods";import{request as Pe}from"@octokit/request";var x="178c6fc778ccc68e1d6a",g="github.com";function He(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 Fe(e){return e==="github.com"||e===g?"https://api.github.com":`https://${e}/api/v3`}async function M(e,t=g,r=x){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(A(n))return{success:!1,error:"Refresh token has expired. Please login again."};try{let o=await Le({clientType:"github-app",clientId:r,clientSecret:"",refreshToken:n.token.refreshToken,request:Pe.defaults({baseUrl:Fe(t)})}),s={token:o.authentication.token,tokenType:"oauth",refreshToken:o.authentication.refreshToken,expiresAt:o.authentication.expiresAt,refreshTokenExpiresAt:o.authentication.refreshTokenExpiresAt};return await e.updateToken(t,s),{success:!0,username:n.username,hostname:t}}catch(o){return{success:!1,error:o instanceof Error?He(o.message):"Token refresh failed"}}}async function ne(e,t=g,r=x){let n=await e.getCredentials(t);if(!n||!n.token)return{token:null,source:"none"};if(!d(n))return{token:n.token.token,source:"stored",username:n.username};if(n.token.refreshToken){let o=await M(e,t,r);if(o.success){let s=await e.getCredentials(t);if(s?.token.token)return{token:s.token.token,source:"refreshed",username:s.username}}return{token:null,source:"none",refreshError:o.error}}return{token:null,source:"none",refreshError:"Token expired and no refresh token available"}}var E=["OCTOCODE_TOKEN","GH_TOKEN","GITHUB_TOKEN"];function W(){for(let e of E){let t=process.env[e];if(t&&t.trim())return t.trim()}return null}function oe(){for(let e of E){let t=process.env[e];if(t&&t.trim())return`env:${e}`}return null}function se(){return W()!==null}function ie(){for(let e of E){let t=process.env[e];if(t?.trim())return{token:t.trim(),source:`env:${e}`}}return null}import{execFile as Ne}from"child_process";var Ge=["/opt/homebrew/bin","/usr/local/bin","/home/linuxbrew/.linuxbrew/bin"];function j(e){return new Promise(t=>{let r=["auth","token"];e&&r.push("--hostname",e);let n=process.env.PATH??"",o=new Set(n.split(":")),s=Ge.filter(h=>!o.has(h)),m=s.length?`${s.join(":")}:${n}`:n;Ne("gh",r,{encoding:"utf8",timeout:5e3,env:{...process.env,PATH:m}},(h,y)=>{if(h||!y){t(null);return}t(y.trim()||null)})})}var D=null;function ae(e){D=e}function le(){D=null}function Ie(){if(!D)throw new Error("Token resolution not initialized. Call initTokenResolution() first.");return D}async function L(e){let t=e?.hostname??g,r=e?.clientId??x,n=e?.getGhCliToken??j,o=ie();if(o)return{token:o.token,source:o.source,wasRefreshed:!1};let s=await Ie().getTokenWithRefresh(t,r);if(s.token)return{token:s.token,source:"octocode-storage",wasRefreshed:s.source==="refreshed",username:s.username};try{let m=await Promise.resolve(n(t));if(m?.trim())return{token:m.trim(),source:"gh-cli",wasRefreshed:!1}}catch{}return null}async function ce(e=g){let t=await L({hostname:e,getGhCliToken:()=>null});return t?{token:t.token,source:t.source}:null}async function ue(e=g,t=x){let r=await L({hostname:e,clientId:t,getGhCliToken:()=>null});return r?{token:r.token,source:r.source,wasRefreshed:r.wasRefreshed,username:r.username}:null}var Me=R("token-storage");async function fe(e){let t=c(e.hostname),r={...e,hostname:t,updatedAt:new Date().toISOString()};try{let n=p();return n.credentials[t]=r,I(n),b(t),{success:!0}}catch(n){let o=n instanceof Error?n.message:String(n);throw Me.error("CRITICAL: Storage failed",{error:o.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***")}),new Error("Failed to store credentials")}}async function C(e="github.com",t){let r=c(e);if(!t?.bypassCache){let s=$(r);if(s!==void 0)return s}let o=p().credentials[r]||null;return U(r,o),o}function z(e="github.com"){let t=c(e);return p().credentials[t]||null}async function We(e="github.com"){let t=c(e),r=!1,n=p();return n.credentials[t]&&(delete n.credentials[t],Object.keys(n.credentials).length===0?re():I(n),r=!0),b(t),{success:r,deletedFromFile:r}}async function je(){let e=p();return Object.keys(e.credentials)}function ze(){let e=p();return Object.keys(e.credentials)}async function Ke(e="github.com"){return await C(e)!==null}function $e(e="github.com"){return z(e)!==null}async function K(e,t){let r=await C(e);return r?(r.token=t,r.updatedAt=new Date().toISOString(),await fe(r),!0):!1}function Ue(){return u}async function Be(e="github.com"){let t=await C(e);return!t||!t.token||d(t)?null:t.token.token}function Ve(e="github.com"){let t=z(e);return!t||!t.token||d(t)?null:t.token.token}async function Ze(e,t){return M({getCredentials:C,updateToken:K},e,t)}async function de(e,t){return ne({getCredentials:C,updateToken:K},e,t)}ae({getTokenWithRefresh:de});export{u as CREDENTIALS_FILE,E as ENV_TOKEN_VARS,f as KEY_FILE,Q as OCTOCODE_DIR,G as decrypt,We as deleteCredentials,N as encrypt,v as ensureOctocodeDir,C as getCredentials,Ue as getCredentialsFilePath,z as getCredentialsSync,oe as getEnvTokenSource,j as getGhCliToken,Be as getToken,W as getTokenFromEnv,Ve as getTokenSync,de as getTokenWithRefresh,Ke as hasCredentials,$e as hasCredentialsSync,se as hasEnvToken,b as invalidateCredentialsCache,A as isRefreshTokenExpired,d as isTokenExpired,je as listStoredHosts,ze as listStoredHostsSync,p as readCredentialsStore,Ze as refreshAuthToken,le as resetTokenResolution,ce as resolveToken,L as resolveTokenFull,ue as resolveTokenWithRefresh,fe as storeCredentials,K as updateToken};

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

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const CredentialsStoreSchema: z.ZodObject<{
+    version: z.ZodNumber;
+    credentials: z.ZodRecord<z.ZodString, z.ZodObject<{
+        hostname: z.ZodString;
+        username: z.ZodString;
+        token: z.ZodObject<{
+            token: z.ZodString;
+            tokenType: z.ZodLiteral<"oauth">;
+            scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            refreshToken: z.ZodOptional<z.ZodString>;
+            expiresAt: z.ZodOptional<z.ZodString>;
+            refreshTokenExpiresAt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        gitProtocol: z.ZodEnum<{
+            ssh: "ssh";
+            https: "https";
+        }>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;

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

@@ -0,0 +1,30 @@
+import type { StoredCredentials, StoreResult, DeleteResult } from './types.js';
+import { invalidateCredentialsCache, _getCacheStats, _resetCredentialsCache } from './credentialCache.js';
+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;
+}
+export declare function getCredentials(hostname?: string, options?: GetCredentialsOptions): Promise<StoredCredentials | null>;
+export declare function getCredentialsSync(hostname?: string): StoredCredentials | null;
+export declare function deleteCredentials(hostname?: string): Promise<DeleteResult>;
+export declare function listStoredHosts(): Promise<string[]>;
+export declare function listStoredHostsSync(): string[];
+export declare function hasCredentials(hostname?: string): Promise<boolean>;
+export declare function hasCredentialsSync(hostname?: string): boolean;
+export declare function updateToken(hostname: string, token: StoredCredentials['token']): Promise<boolean>;
+export declare function getCredentialsFilePath(): string;
+export declare function getToken(hostname?: string): Promise<string | null>;
+export declare function getTokenSync(hostname?: string): string | null;
+export { invalidateCredentialsCache, _getCacheStats, _resetCredentialsCache };
+export { encrypt, decrypt, ensureOctocodeDir, readCredentialsStore, writeCredentialsStore, OCTOCODE_DIR, CREDENTIALS_FILE, KEY_FILE, };
+export declare function refreshAuthToken(hostname?: string, clientId?: string): Promise<RefreshResult>;
+export declare function getTokenWithRefresh(hostname?: string, clientId?: string): Promise<TokenWithRefreshResult>;
+export type { RefreshResult, TokenWithRefreshResult };
+export { resolveToken, resolveTokenWithRefresh, resolveTokenFull, resetTokenResolution, type ResolvedToken, type ResolvedTokenWithRefresh, type FullTokenResolution, type GhCliTokenGetter, };
+export { isTokenExpired, isRefreshTokenExpired };

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

@@ -0,0 +1,2 @@
+export { _getCacheStats, _resetCredentialsCache } from './credentialCache.js';
+export { resetTokenResolution } from './tokenResolution.js';

package/dist/shared/credentials/testing.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { createRequire as __createRequire } from 'module';
+import { fileURLToPath as __fileURLToPath } from 'url';
+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};

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

@@ -0,0 +1,24 @@
+import type { OAuthToken, StoredCredentials } from './types.js';
+export interface RefreshResult {
+    success: boolean;
+    username?: string;
+    hostname?: string;
+    error?: string;
+}
+type GetCredentialsFn = (hostname?: string) => Promise<StoredCredentials | null>;
+type UpdateTokenFn = (hostname: string, token: OAuthToken) => Promise<boolean>;
+export declare function refreshAuthToken(deps: {
+    getCredentials: GetCredentialsFn;
+    updateToken: UpdateTokenFn;
+}, hostname?: string, clientId?: string): Promise<RefreshResult>;
+export interface TokenWithRefreshResult {
+    token: string | null;
+    source: 'stored' | 'refreshed' | 'none';
+    username?: string;
+    refreshError?: string;
+}
+export declare function getTokenWithRefresh(deps: {
+    getCredentials: GetCredentialsFn;
+    updateToken: UpdateTokenFn;
+}, hostname?: string, clientId?: string): Promise<TokenWithRefreshResult>;
+export {};

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

@@ -0,0 +1,30 @@
+import type { TokenSource } from './types.js';
+import type { TokenWithRefreshResult } from './tokenRefresh.js';
+interface StorageDeps {
+    getTokenWithRefresh: (hostname?: string, clientId?: string) => Promise<TokenWithRefreshResult>;
+}
+export declare function initTokenResolution(deps: StorageDeps): void;
+export declare function resetTokenResolution(): void;
+export interface FullTokenResolution {
+    token: string;
+    source: TokenSource | 'gh-cli';
+    wasRefreshed?: boolean;
+    username?: string;
+}
+export type GhCliTokenGetter = (hostname?: string) => string | null | Promise<string | null>;
+export declare function resolveTokenFull(options?: {
+    hostname?: string;
+    clientId?: string;
+    getGhCliToken?: GhCliTokenGetter;
+}): Promise<FullTokenResolution | null>;
+export interface ResolvedToken {
+    token: string;
+    source: TokenSource;
+}
+export declare function resolveToken(hostname?: string): Promise<ResolvedToken | null>;
+export interface ResolvedTokenWithRefresh extends ResolvedToken {
+    wasRefreshed?: boolean;
+    username?: string;
+}
+export declare function resolveTokenWithRefresh(hostname?: string, clientId?: string): Promise<ResolvedTokenWithRefresh | null>;
+export {};

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

@@ -0,0 +1,28 @@
+export interface OAuthToken {
+    token: string;
+    tokenType: 'oauth';
+    scopes?: string[];
+    refreshToken?: string;
+    expiresAt?: string;
+    refreshTokenExpiresAt?: string;
+}
+export interface StoredCredentials {
+    hostname: string;
+    username: string;
+    token: OAuthToken;
+    gitProtocol: 'ssh' | 'https';
+    createdAt: string;
+    updatedAt: string;
+}
+export interface StoreResult {
+    success: boolean;
+}
+export interface DeleteResult {
+    success: boolean;
+    deletedFromFile: boolean;
+}
+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;

package/dist/shared/fs-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function getDirectorySizeBytes(targetPath: string): number;
+export declare function formatBytes(bytes: number): string;

package/dist/shared/fs-utils.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { createRequire as __createRequire } from 'module';
+import { fileURLToPath as __fileURLToPath } from 'url';
+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 f,readdirSync as u,lstatSync as l}from"node:fs";import{join as m}from"node:path";function a(n){if(!f(n))return 0;let r=0,t=[n];for(;t.length>0;){let e=t.pop(),o;try{o=u(e)}catch{continue}for(let s of o){let c=m(e,s);try{let i=l(c);if(i.isSymbolicLink())continue;i.isDirectory()?t.push(c):i.isFile()&&(r+=i.size)}catch{}}}return r}function d(n){if(n<1024)return`${n} B`;let r=n/1024;if(r<1024)return`${r.toFixed(1)} KB`;let t=r/1024;return t<1024?`${t.toFixed(1)} MB`:`${(t/1024).toFixed(2)} GB`}export{d as formatBytes,a as getDirectorySizeBytes};

package/dist/shared/index.d.ts

@@ -0,0 +1,7 @@
+export * from './credentials/index.js';
+export * from './platform/index.js';
+export * from './session/index.js';
+export * from './config/index.js';
+export * from './logger/index.js';
+export * from './paths.js';
+export * from './fs-utils.js';

package/dist/shared/logger/index.d.ts

@@ -0,0 +1,2 @@
+export { createLogger, setLogHandler, _getLogHandler } from './logger.js';
+export type { LogLevel, LogEntry } from './logger.js';