@kodax-ai/kodax 0.7.50 → 0.7.52

package/dist/sdk-repl.js

@@ -1,3 +1,3 @@
 // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{$ as en,$a as ro,A as Q,Aa as An,Ab as Oo,B as T,Ba as On,Bb as Ro,C as U,Ca as Rn,Cb as So,D as V,Da as Sn,Db as vo,E as Y,Ea as vn,Eb as Io,F as Z,Fa as In,Fb as Lo,G as tt,Ga as Ln,Gb as Wo,H as nt,Ha as Wn,Hb as Fo,I as ot,Ia as Fn,Ib as $o,J as et,Ja as $n,Jb as qo,K as rt,Ka as qn,Kb as zo,L as at,La as zn,Lb as Bo,M as mt,Ma as Bn,Mb as Eo,N as it,Na as En,Nb as Go,O as st,Oa as Gn,Ob as Ho,P as ct,Pa as Hn,Pb as Jo,Q as dt,Qa as Jn,Qb as Qo,R as pt,Ra as Qn,Rb as To,S as lt,Sa as Tn,Sb as Uo,T as ut,Ta as Un,Tb as Vo,U as ft,Ua as Vn,Ub as Yo,V as Vt,Va as Yn,Vb as Zo,W as Yt,Wa as Zn,Wb as te,X as Zt,Xa as to,Y as tn,Ya as no,Z as nn,Za as oo,_ as on,_a as eo,a as D,aa as rn,ab as ao,b as P,ba as an,bb as mo,c as M,ca as mn,cb as io,d as w,da as sn,db as so,e as N,ea as cn,eb as co,f as _,fa as dn,fb as po,g as b,ga as pn,gb as lo,h as j,ha as ln,hb as uo,i as k,ia as un,ib as fo,j as A,ja as fn,jb as go,k as O,ka as gn,kb as Co,l as R,la as Cn,lb as xo,m as S,ma as xn,mb as yo,n as v,na as yn,nb as Ko,o as I,oa as Kn,ob as Xo,p as L,pa as Xn,pb as ho,q as W,qa as hn,qb as Do,r as F,ra as Dn,rb as Po,s as $,sa as Pn,sb as Mo,t as q,ta as Mn,tb as wo,u as z,ua as wn,ub as No,v as B,va as Nn,vb as _o,w as E,wa as _n,wb as bo,x as G,xa as bn,xb as jo,y as H,ya as jn,yb as ko,z as J,za as kn,zb as Ao}from"./chunks/chunk-YJLRBIEW.js";import{C as Gt,H as Ht,I as Jt,a as gt,c as Ct,f as xt,fa as Qt,g as yt,ga as Tt,h as Kt,ha as Ut,i as It,k as Lt,l as Wt,m as Ft,n as $t,p as qt,q as zt,r as Bt,s as Et}from"./chunks/chunk-UB5IAZHF.js";import{D as vt,b as Xt,c as ht,d as Dt,e as Pt,f as Mt,h as wt,i as Nt,j as _t,k as bt,u as jt,v as kt,w as At,x as Ot,y as Rt,z as St}from"./chunks/chunk-HR64F32V.js";import"./chunks/chunk-SK4HOYT2.js";import"./chunks/chunk-EVIDQWMF.js";import"./chunks/chunk-MFOMFMSK.js";import"./chunks/chunk-XZY4CIDV.js";import"./chunks/chunk-5UJQ2GKJ.js";import{a}from"./chunks/chunk-V4WSBIXB.js";import l from"fs/promises";import c from"path";import x from"os";var u=c.join(x.homedir(),".kodax","commands");function y(){return u}a(y,"getDefaultCommandDir");async function K(e){let n=new Map,o=e??u;try{await l.mkdir(o,{recursive:!0});let r=await l.readdir(o);for(let t of r){let m=c.extname(t),f=t.replace(m,"");if(m===".md"){try{let d=await l.readFile(c.join(o,t),"utf-8"),i=(d.split(`
-`)[0]?.replace(/^#\s*/,"").trim()??"").slice(0,60)||"(prompt command)";n.set(f,{name:f,description:i,content:d,type:"prompt"})}catch{}continue}if(m===".js"||m===".ts")try{let g=await import(c.join(o,t));for(let[i,p]of Object.entries(g))if(i.startsWith("command_")&&typeof p=="function"){let s=i.replace("command_",""),C=p.description??s;n.set(s,{name:s,description:String(C).slice(0,60),content:`[Programmable command: ${s}]`,type:"programmable",execute:p})}}catch{}}}catch{}return n}a(K,"loadCommands");async function X(e,n,o,r){let t=o.get(e);return t?t.type==="prompt"?n?t.content.replace(/{args}/g,n):t.content:t.type==="programmable"&&t.execute?t.execute({args:n,runAgent:r}):null:null}a(X,"processCommandCall");function h(e){if(!e.startsWith("/"))return null;let n=e.slice(1).split(/\s+/,2);if(n.length===0)return null;let[o,r]=n;return o?[o,r]:null}a(h,"parseCommandCall");export{Cn as App,Vt as AutocompleteContextProvider,Qt as BUILTIN_COMMANDS,qn as BackgroundTaskBar,Bn as ChildActivitySurface,bo as ConsoleCapturer,dt as DEFAULT_UI_STATE,In as DialogSurface,mn as DotsIndicator,zo as FileSessionStorage,yn as FullscreenTranscriptLayout,pn as HistoryItemRenderer,en as InputPrompt,u as KODAX_COMMANDS_DIR,Dt as KODAX_CONFIG_FILE,Xt as KODAX_DIR,ht as KODAX_SESSIONS_DIR,_t as KODAX_VERSION,ft as KeyMatchers,ct as KeypressHandlerPriority,ot as KeypressParser,lt as KeypressProvider,L as LRUCache,dn as LoadingIndicator,eo as MemorySessionStorage,Kn as MessageActions,ln as MessageList,Xn as MessageSelector,Wn as NotificationsSurface,gt as PERMISSION_MODES,Pt as PREVIEW_MAX_LENGTH,Xo as PendingInputsIndicator,sn as ProgressIndicator,Dn as PromptComposer,wn as PromptFooter,Pn as PromptFooterLeftSide,Mn as PromptFooterRightSide,Nn as PromptHelpMenu,vn as PromptSuggestionsSurface,Ln as QueuedCommandsSurface,xn as SimpleApp,rn as SimpleInputPrompt,un as SimpleMessageDisplay,gn as SimpleStatusBar,tt as SingleLineTextInput,an as Spinner,$n as StashNotice,fn as StatusBar,Fn as StatusNoticesSurface,Gn as StreamingProvider,mt as StreamingState,Sn as SuggestionsDisplay,st as TOOL_STATUS_ICONS,nn as TextBuffer,Z as TextInput,cn as ThinkingIndicator,yo as ToolCallDisplay,it as ToolCallStatus,Ko as ToolGroup,xo as ToolProgressBar,Co as ToolStatusBadge,hn as TranscriptViewport,kn as UIStateProvider,Zn as _resetQueuedPromptsCacheForTests,Vo as archiveSession,oo as bootstrapAutoMode,J as calculateVisualCursorFromLayout,H as calculateVisualLayout,zt as collectBashWriteTargets,xt as computeConfirmTools,fo as createCliEvents,bn as createHistoryItem,to as createInteractiveContext,go as createJsonEvents,Un as createKeyMatcher,pt as createKeypressManager,ro as createMemorySessionStorage,po as createRecoveryHistoryItem,so as createRetryHistoryItem,te as createSessionManager,En as createStreamingManager,jn as createToolCall,Q as darkTheme,Uo as deleteSession,_o as detectTerminalCapabilities,j as detectTerminalHostProfile,b as detectTerminalRenderHost,lo as emitRecoveryHistoryItem,co as emitRetryHistoryItem,Ut as executeCommand,ao as executeShellCommand,Gt as extractTextContent,Ht as extractTitle,Ho as forkSession,Jt as formatMessagePreview,_n as generateId,Ft as generateSavePattern,Bt as getBashOutsideProjectWriteRisk,q as getCharAtCodePoint,W as getCodePointLength,So as getCustomProviderConfig,y as getDefaultCommandDir,St as getGitRoot,at as getKeyDisplayName,Wo as getMcpServerConfig,Et as getPlanModeBlockReason,jt as getProviderList,bt as getProviderModel,S as getTerminalHostCapabilities,wo as getTerminalWidth,V as getTheme,Y as getThemeNames,Nt as getVersion,$ as getVisualWidth,G as getVisualWidthCached,P as hasCursorUpViewportYankRisk,w as hasMainScreenRenderScrollRisk,Mt as hydrateProcessEnvFromShell,$t as isAlwaysConfirmPath,It as isBashReadCommand,Lt as isBashWriteCommand,I as isClassicReplForced,et as isFunctionKey,v as isOwnedRendererPreferred,qt as isPathInsideProject,yt as isPermissionMode,rt as isPrintable,kt as isProviderConfigured,M as isRemoteConptyHost,No as isScreenReader,mo as isShellCommand,io as isShellCommandSuccess,N as isTmuxControlMode,Wt as isToolCallAllowed,D as isVsCodeTerminalHostEnv,F as isWideChar,Ro as listCustomProviders,Lo as listMcpServers,To as listRunningSessions,Bo as listSessions,K as loadCommands,At as loadConfig,Go as loadFullTranscript,Eo as loadSession,zn as measureChildActivitySurfaceRows,T as minimalTheme,Kt as normalizePermissionMode,Tt as parseCommand,h as parseCommandCall,nt as parseKeypress,Ct as permissionModeDisplayName,Ot as prepareRuntimeConfig,X as processCommandCall,Oo as processSpecialSyntax,vt as rateLimitedCall,wt as registerConfiguredCustomProviders,Io as removeCustomProvider,$o as removeMcpServer,_ as resetTmuxControlModeProbeForTesting,k as resolveConfiguredTuiRendererMode,A as resolveEffectiveTuiRendererMode,R as resolveFullscreenPolicy,O as resolveInteractiveSurfacePreference,Jo as rewindSession,uo as runInkInteractiveMode,Ao as runInteractiveMode,Rt as saveConfig,Qo as setActiveEntry,z as splitByCodePoints,Do as supports256Colors,Mo as supportsEmoji,ho as supportsTrueColor,Po as supportsUnicode,U as themes,no as touchContext,B as truncateByVisualWidth,Yo as unarchiveSession,vo as upsertCustomProvider,Fo as upsertMcpServer,Zt as useAutocomplete,Yt as useAutocompleteContext,tn as useInputHistory,Tn as useKeypress,ut as useKeypressManager,Yn as useQueuedPromptContents,Vn as useQueuedPrompts,Qn as useStreaming,Jn as useStreamingActions,Hn as useStreamingState,on as useTextBuffer,Rn as useUI,On as useUIActions,An as useUIState,qo as validateMcpServerConfig,E as visualWidthCache,Zo as watchSessions,jo as withCapture,ko as withCaptureSync};
+import{$ as un,$a as fo,A as Q,Aa as $n,Ab as qo,B as T,Ba as qn,Bb as zo,C as U,Ca as zn,Cb as Bo,D as V,Da as Bn,Db as Eo,E as Y,Ea as En,Eb as Go,F as Z,Fa as Gn,Fb as Ho,G as tt,Ga as Hn,Gb as Jo,H as nt,Ha as Jn,Hb as Qo,I as ot,Ia as Qn,Ib as To,J as et,Ja as Tn,Jb as Uo,K as rt,Ka as Un,Kb as Vo,L as at,La as Vn,Lb as Yo,M as pt,Ma as Yn,Mb as Zo,N as lt,Na as Zn,Nb as te,O as ut,Oa as to,Ob as ne,P as ft,Pa as no,Pb as oe,Q as nn,Qa as oo,Qb as ee,R as on,Ra as eo,Rb as re,S as en,Sa as ro,Sb as ae,T as rn,Ta as ao,Tb as me,U as an,Ua as mo,V as mn,Va as io,W as sn,Wa as so,X as cn,Xa as co,Y as dn,Ya as po,Z as pn,Za as lo,_ as ln,_a as uo,a as D,aa as fn,ab as go,b as P,ba as gn,bb as Co,c as M,ca as Cn,cb as xo,d as w,da as xn,db as yo,e as N,ea as yn,eb as Ko,f as _,fa as Kn,fb as Xo,g as b,ga as Xn,gb as ho,h as j,ha as hn,hb as Do,i as k,ia as Dn,ib as Po,j as A,ja as Pn,jb as Mo,k as O,ka as Mn,kb as wo,l as R,la as wn,lb as No,m as S,ma as Nn,mb as _o,n as v,na as _n,nb as bo,o as I,oa as bn,ob as jo,p as L,pa as jn,pb as ko,q as W,qa as kn,qb as Ao,r as F,ra as An,rb as Oo,s as $,sa as On,sb as Ro,t as q,ta as Rn,tb as So,u as z,ua as Sn,ub as vo,v as B,va as vn,vb as Io,w as E,wa as In,wb as Lo,x as G,xa as Ln,xb as Wo,y as H,ya as Wn,yb as Fo,z as J,za as Fn,zb as $o}from"./chunks/chunk-MFPYZT52.js";import{I as Gt,J as Ht,K as Jt,L as Qt,M as Tt,R as Ut,S as Vt,a as mt,b as it,c as st,d as ct,e as dt,f as gt,h as Ct,k as xt,l as yt,m as Kt,n as It,p as Lt,pa as Yt,q as Wt,qa as Zt,r as Ft,ra as tn,s as $t,u as qt,v as zt,w as Bt,x as Et}from"./chunks/chunk-7X7SOVER.js";import{D as vt,b as Xt,c as ht,d as Dt,e as Pt,f as Mt,h as wt,i as Nt,j as _t,k as bt,u as jt,v as kt,w as At,x as Ot,y as Rt,z as St}from"./chunks/chunk-BFXFSEHK.js";import"./chunks/chunk-JJTUBNQX.js";import"./chunks/chunk-EVIDQWMF.js";import"./chunks/chunk-4RVSFOUT.js";import"./chunks/chunk-5USNUSTL.js";import"./chunks/chunk-LE6STNVN.js";import"./chunks/chunk-HMATTIU6.js";import{a}from"./chunks/chunk-V4WSBIXB.js";import l from"fs/promises";import c from"path";import x from"os";var u=c.join(x.homedir(),".kodax","commands");function y(){return u}a(y,"getDefaultCommandDir");async function K(e){let n=new Map,o=e??u;try{await l.mkdir(o,{recursive:!0});let r=await l.readdir(o);for(let t of r){let m=c.extname(t),f=t.replace(m,"");if(m===".md"){try{let d=await l.readFile(c.join(o,t),"utf-8"),i=(d.split(`
+`)[0]?.replace(/^#\s*/,"").trim()??"").slice(0,60)||"(prompt command)";n.set(f,{name:f,description:i,content:d,type:"prompt"})}catch{}continue}if(m===".js"||m===".ts")try{let g=await import(c.join(o,t));for(let[i,p]of Object.entries(g))if(i.startsWith("command_")&&typeof p=="function"){let s=i.replace("command_",""),C=p.description??s;n.set(s,{name:s,description:String(C).slice(0,60),content:`[Programmable command: ${s}]`,type:"programmable",execute:p})}}catch{}}}catch{}return n}a(K,"loadCommands");async function X(e,n,o,r){let t=o.get(e);return t?t.type==="prompt"?n?t.content.replace(/{args}/g,n):t.content:t.type==="programmable"&&t.execute?t.execute({args:n,runAgent:r}):null:null}a(X,"processCommandCall");function h(e){if(!e.startsWith("/"))return null;let n=e.slice(1).split(/\s+/,2);if(n.length===0)return null;let[o,r]=n;return o?[o,r]:null}a(h,"parseCommandCall");export{Xn as App,nn as AutocompleteContextProvider,Yt as BUILTIN_COMMANDS,Gn as BackgroundTaskBar,Jn as ChildActivitySurface,So as ConsoleCapturer,dt as DEFAULT_UI_STATE,$n as DialogSurface,pn as DotsIndicator,Qo as FileSessionStorage,Dn as FullscreenTranscriptLayout,gn as HistoryItemRenderer,sn as InputPrompt,u as KODAX_COMMANDS_DIR,Dt as KODAX_CONFIG_FILE,Xt as KODAX_DIR,ht as KODAX_SESSIONS_DIR,_t as KODAX_VERSION,ft as KeyMatchers,ct as KeypressHandlerPriority,ot as KeypressParser,lt as KeypressProvider,L as LRUCache,fn as LoadingIndicator,io as MemorySessionStorage,Pn as MessageActions,Cn as MessageList,Mn as MessageSelector,zn as NotificationsSurface,gt as PERMISSION_MODES,Pt as PREVIEW_MAX_LENGTH,No as PendingInputsIndicator,ln as ProgressIndicator,Nn as PromptComposer,jn as PromptFooter,_n as PromptFooterLeftSide,bn as PromptFooterRightSide,kn as PromptHelpMenu,Fn as PromptSuggestionsSurface,qn as QueuedCommandsSurface,hn as SimpleApp,cn as SimpleInputPrompt,xn as SimpleMessageDisplay,Kn as SimpleStatusBar,tt as SingleLineTextInput,dn as Spinner,En as StashNotice,yn as StatusBar,Bn as StatusNoticesSurface,Tn as StreamingProvider,mt as StreamingState,Wn as SuggestionsDisplay,st as TOOL_STATUS_ICONS,an as TextBuffer,Z as TextInput,un as ThinkingIndicator,Mo as ToolCallDisplay,it as ToolCallStatus,wo as ToolGroup,Po as ToolProgressBar,Do as ToolStatusBadge,wn as TranscriptViewport,Sn as UIStateProvider,eo as _resetQueuedPromptsCacheForTests,ee as archiveSession,mo as bootstrapAutoMode,J as calculateVisualCursorFromLayout,H as calculateVisualLayout,zt as collectBashWriteTargets,xt as computeConfirmTools,Xo as createCliEvents,On as createHistoryItem,ro as createInteractiveContext,ho as createJsonEvents,to as createKeyMatcher,pt as createKeypressManager,so as createMemorySessionStorage,xo as createRecoveryHistoryItem,go as createRetryHistoryItem,me as createSessionManager,Qn as createStreamingManager,Rn as createToolCall,Q as darkTheme,oe as deleteSession,Ro as detectTerminalCapabilities,j as detectTerminalHostProfile,b as detectTerminalRenderHost,yo as emitRecoveryHistoryItem,Co as emitRetryHistoryItem,tn as executeCommand,co as executeShellCommand,Jt as extractHistorySeedsFromMessage,Qt as extractHistorySeedsFromMessages,Tt as extractTextContent,Ut as extractTitle,Yo as forkSession,Vt as formatMessagePreview,An as generateId,Ft as generateSavePattern,Bt as getBashOutsideProjectWriteRisk,q as getCharAtCodePoint,W as getCodePointLength,$o as getCustomProviderConfig,y as getDefaultCommandDir,St as getGitRoot,at as getKeyDisplayName,Eo as getMcpServerConfig,Et as getPlanModeBlockReason,jt as getProviderList,bt as getProviderModel,S as getTerminalHostCapabilities,Ao as getTerminalWidth,V as getTheme,Y as getThemeNames,Nt as getVersion,$ as getVisualWidth,G as getVisualWidthCached,P as hasCursorUpViewportYankRisk,w as hasMainScreenRenderScrollRisk,Mt as hydrateProcessEnvFromShell,$t as isAlwaysConfirmPath,It as isBashReadCommand,Lt as isBashWriteCommand,I as isClassicReplForced,et as isFunctionKey,v as isOwnedRendererPreferred,qt as isPathInsideProject,yt as isPermissionMode,rt as isPrintable,kt as isProviderConfigured,M as isRemoteConptyHost,Oo as isScreenReader,po as isShellCommand,lo as isShellCommandSuccess,N as isTmuxControlMode,Wt as isToolCallAllowed,D as isVsCodeTerminalHostEnv,F as isWideChar,Fo as listCustomProviders,Bo as listMcpServers,ne as listRunningSessions,To as listSessions,K as loadCommands,At as loadConfig,Vo as loadFullTranscript,Uo as loadSession,Hn as measureChildActivitySurfaceRows,T as minimalTheme,Kt as normalizePermissionMode,Zt as parseCommand,h as parseCommandCall,nt as parseKeypress,Ct as permissionModeDisplayName,Ot as prepareRuntimeConfig,X as processCommandCall,Wo as processSpecialSyntax,vt as rateLimitedCall,wt as registerConfiguredCustomProviders,zo as removeCustomProvider,Ho as removeMcpServer,_ as resetTmuxControlModeProbeForTesting,k as resolveConfiguredTuiRendererMode,A as resolveEffectiveTuiRendererMode,R as resolveFullscreenPolicy,O as resolveInteractiveSurfacePreference,fo as restoreHistoryItemsFromSession,Zo as rewindSession,Ko as runInkInteractiveMode,Lo as runInteractiveMode,Rt as saveConfig,Gt as seedToHistoryItem,te as setActiveEntry,z as splitByCodePoints,bo as supports256Colors,ko as supportsEmoji,_o as supportsTrueColor,jo as supportsUnicode,U as themes,Ht as toolCallSeedToHistoryToolCall,ao as touchContext,uo as trimPersistedUiHistorySnapshot,B as truncateByVisualWidth,re as unarchiveSession,qo as upsertCustomProvider,Go as upsertMcpServer,en as useAutocomplete,on as useAutocompleteContext,rn as useInputHistory,Zn as useKeypress,ut as useKeypressManager,oo as useQueuedPromptContents,no as useQueuedPrompts,Yn as useStreaming,Vn as useStreamingActions,Un as useStreamingState,mn as useTextBuffer,Ln as useUI,In as useUIActions,vn as useUIState,Jo as validateMcpServerConfig,E as visualWidthCache,ae as watchSessions,vo as withCapture,Io as withCaptureSync};

package/dist/sdk-session.d.ts

@@ -1,224 +1,8 @@
-import { n as KodaXMessage } from './types-chunks/types.d-rPRl2LSB.js';
-import { S as SessionData, F as FileSessionStorage } from './types-chunks/storage.d-J2GqOgaX.js';
-import './types-chunks/types.d-BnjX2Gn4.js';
-
-/**
- * FEATURE_173 Part B (v0.7.42) — Session Management Public SDK.
- *
- * Thin facades over FileSessionStorage + discoverInstances. All methods
- * NEVER throw — missing sessions return null, blocked operations return
- * an error envelope, missing directories return empty arrays / no-op
- * watchers.
- *
- * The `@kodax-ai/kodax/session` SDK subpath re-exports this module.
- */
-
-interface SessionSummary {
-    readonly id: string;
-    readonly title: string;
-    readonly msgCount: number;
-    readonly tag?: string;
-    readonly createdAt?: string;
-    readonly runtimeInfo?: {
-        workspaceRoot?: string;
-        gitRoot?: string;
-    };
-    /**
-     * FEATURE_219 (v0.7.46) — the per-project directory key this session lives
-     * under (ADR-038 §7). A backward-compatible hint: consumers may pass it back
-     * for precise disambiguation, but `loadSession(id)` works without it.
-     */
-    readonly projectKey?: string;
-    /** FEATURE_219 — true when the session is whole-session archived (only ever
-     * surfaced when `includeArchived` is set). */
-    readonly archived?: boolean;
-}
-type SessionTranscriptEntryType = 'message' | 'compaction' | 'branch_summary';
-interface SessionTranscriptEntry {
-    readonly entryId: string;
-    readonly parentId: string | null;
-    readonly timestamp: string;
-    readonly type: SessionTranscriptEntryType;
-    readonly message: KodaXMessage;
-    readonly active: boolean;
-    readonly summary?: string;
-}
-interface FullTranscriptSessionData extends Omit<SessionData, 'messages'> {
-    readonly messages: KodaXMessage[];
-    readonly activeMessages: KodaXMessage[];
-    readonly transcriptEntries: SessionTranscriptEntry[];
-}
-interface ListSessionsOptions {
-    /**
-     * Alias for gitRoot; backwards-compat with KodaX Space terminology.
-     * When provided, list() is scoped to sessions from this project root.
-     */
-    readonly projectRoot?: string;
-    /**
-     * Which session scopes to include.
-     * - 'user' (default): only user-initiated sessions.
-     * - 'managed-task-worker': only managed-task worker sessions.
-     * - 'all': no scope filter.
-     */
-    readonly scope?: 'user' | 'managed-task-worker' | 'all';
-    /**
-     * Whether to include whole-session-archived sessions. FEATURE_219 (v0.7.46):
-     * archived sessions live in `<projectKey>/archived/` (see `archiveSession`);
-     * also still hides the legacy `archived-` filename prefix. Default false.
-     */
-    readonly includeArchived?: boolean;
-    /** Maximum number of sessions to return. Default 50. */
-    readonly limit?: number;
-    /**
-     * ISO date string — return only sessions whose createdAt is before this
-     * timestamp. Applied after list + scope filtering.
-     */
-    readonly before?: string;
-    /** Exact match. Omitted means no tag filter. */
-    readonly tag?: string;
-}
-type WatchSessionsCallback = (event: {
-    kind: 'change' | 'add' | 'remove';
-    sessionId: string;
-}) => void;
-interface SessionManager {
-    listSessions: typeof listSessions;
-    loadSession: typeof loadSession;
-    loadFullTranscript: typeof loadFullTranscript;
-    forkSession: typeof forkSession;
-    rewindSession: typeof rewindSession;
-    setActiveEntry: typeof setActiveEntry;
-    deleteSession: typeof deleteSession;
-    archiveSession: typeof archiveSession;
-    unarchiveSession: typeof unarchiveSession;
-    listRunningSessions: typeof listRunningSessions;
-    watchSessions: typeof watchSessions;
-    /**
-     * v0.7.43 — the raw write-side storage instance. SDK embedders pass
-     * this into `runKodaX({ session: { id, scope, storage } })` so the
-     * SA / AMA loops write per-turn JSONL snapshots to disk. Without an
-     * injected storage, `saveSessionSnapshot` is a silent no-op and the
-     * sessions directory stays empty regardless of `session.id`.
-     *
-     * See {@link FileSessionStorage} for the concrete implementation and
-     * `docs/SDK_EMBEDDER_GUIDE.md` §6 for the end-to-end recipe.
-     */
-    storage: FileSessionStorage;
-}
-/**
- * List sessions, optionally filtered by scope, limit, and date.
- * NEVER throws. Returns [] when the sessions directory is empty or missing.
- */
-declare function listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;
-/**
- * Load full session data by ID.
- * Returns null for a missing session. NEVER throws.
- */
-declare function loadSession(id: string): Promise<SessionData | null>;
-/**
- * Load append-order transcript data by ID.
- *
- * `loadSession` remains the active model-context API. This helper is for UI
- * scrollback: it returns every persisted transcript-bearing lineage entry in
- * append order and keeps the active branch in `activeMessages`.
- */
-declare function loadFullTranscript(id: string): Promise<FullTranscriptSessionData | null>;
-/**
- * Fork a session at an optional selector.
- * Returns null for a missing session. NEVER throws.
- */
-declare function forkSession(id: string, opts?: {
-    selector?: string;
-    sessionId?: string;
-    title?: string;
-}): Promise<{
-    sessionId: string;
-    data: SessionData;
-} | null>;
-/**
- * Rewind a session to a previous user entry.
- * Returns null for a missing session. NEVER throws.
- */
-declare function rewindSession(id: string, opts?: {
-    selector?: string;
-}): Promise<SessionData | null>;
-/**
- * Set the active lineage entry by selector.
- * Returns null for a missing session. NEVER throws.
- */
-declare function setActiveEntry(id: string, selector: string): Promise<SessionData | null>;
-interface RunningSessionInfo {
-    readonly pid: number;
-    readonly startedAt: number;
-    readonly cwd: string;
-    /**
-     * v0.7.43 — populated from `PersistedSessionState.sessionId`, published
-     * by the REPL after `createInteractiveContext`. Remains `undefined` for
-     * a brief window during a peer's bootstrap (before the first sessionId
-     * is generated) and for peers running pre-v0.7.43 binaries; consumers
-     * MUST handle `undefined`.
-     */
-    readonly sessionId: string | undefined;
-}
-/**
- * Returns live KodaX sibling instances (excluding this process).
- * Uses discoverInstances() from @kodax-ai/agent (FEATURE_125 Team Mode).
- * NEVER throws. Returns [] when no instances directory exists.
- */
-declare function listRunningSessions(): Promise<RunningSessionInfo[]>;
-type DeleteSessionResult = {
-    ok: true;
-} | {
-    error: {
-        code: 'session_running';
-        runningProcess: {
-            pid: number;
-            startedAt: number;
-        };
-    };
-};
-/**
- * Delete a session by ID.
- * Returns { ok: true } on success (including when the session doesn't exist).
- * Returns an error envelope when the session is currently running.
- * NEVER throws.
- */
-declare function deleteSession(id: string): Promise<DeleteSessionResult>;
-/**
- * FEATURE_219 (v0.7.46) — whole-session archive. Moves the session (and its
- * island sidecar) into `<projectKey>/archived/`. Returns false for a missing
- * session. NEVER throws. Archived sessions are hidden from the default listing
- * and resurface only with `listSessions({ includeArchived: true })`.
- */
-declare function archiveSession(id: string): Promise<boolean>;
-/** Restore an archived session back into its project directory. NEVER throws. */
-declare function unarchiveSession(id: string): Promise<boolean>;
-/**
- * Watch the sessions directory for changes.
- * Returns { close() } that stops the watcher / poll interval.
- *
- * Platform branches:
- * - POSIX: fs.watch() with 100ms debounce.
- * - Windows: readdir poll every 1000ms, diffed against a snapshot.
- *
- * NEVER throws — if the directory doesn't exist the watcher is a no-op
- * until the directory is created.
- */
-declare function watchSessions(cb: WatchSessionsCallback): {
-    close: () => void;
-};
-/**
- * Factory that returns an object with all session management methods bound.
- *
- * v0.7.43 (FEATURE_173 Part B follow-up) — the `sessionsDir` override is
- * now honored. When provided, all read/write/watch operations go through
- * that directory instead of the module-load-frozen `KODAX_SESSIONS_DIR`.
- * `listRunningSessions` still consults the agent-config-home instances
- * directory (sibling-process awareness is not scoped per sessions dir).
- */
-declare function createSessionManager(opts?: {
-    sessionsDir?: string;
-}): SessionManager;
-
-export { archiveSession, createSessionManager, deleteSession, forkSession, listRunningSessions, listSessions, loadFullTranscript, loadSession, rewindSession, setActiveEntry, unarchiveSession, watchSessions };
-export type { DeleteSessionResult, FullTranscriptSessionData, ListSessionsOptions, RunningSessionInfo, SessionManager, SessionSummary, SessionTranscriptEntry, SessionTranscriptEntryType, WatchSessionsCallback };
+export { c as CreatableHistoryItem, e as DeleteSessionResult, F as FullTranscriptSessionData, r as HistorySeedSourceMessage, v as ListSessionsOptions, R as RestoreHistoryItemsFromSessionInput, y as RestoredHistorySeed, z as RunningSessionInfo, S as SessionManager, B as SessionSummary, E as SessionTranscriptEntry, G as SessionTranscriptEntryType, a3 as WatchSessionsCallback, a4 as archiveSession, a5 as createSessionManager, a6 as deleteSession, a7 as extractHistorySeedsFromMessage, a8 as extractHistorySeedsFromMessages, ab as forkSession, ad as listRunningSessions, ae as listSessions, af as loadFullTranscript, ag as loadSession, ah as restoreHistoryItemsFromSession, ai as rewindSession, ak as setActiveEntry, an as unarchiveSession, ao as watchSessions } from './types-chunks/sdk-session-D4tqRl0_.js';
+export { ac as KodaXSessionUiHistoryItem, ad as KodaXSessionUiHistoryItemType, ae as KodaXSessionUiTextHistoryItem, af as KodaXSessionUiTextHistoryItemType, ag as KodaXSessionUiToolCall, ah as KodaXSessionUiToolCallStatus, ai as KodaXSessionUiToolGroupHistoryItem } from './types-chunks/process.d-Bj82oJhD.js';
+import './types-chunks/storage.d-CabW10Nt.js';
+import './types-chunks/bash-prefix-extractor.d-DBFZEwop.js';
+import './types-chunks/base.d-BBNUF9nz.js';
+import 'vscode-languageserver-protocol';
+import './types-chunks/capability.d-3C62G8Eq.js';
+import './types-chunks/cost-tracker.d-wRtyEW9d.js';

package/dist/sdk-session.js

@@ -1,2 +1,2 @@
 // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{Lb as s,Mb as e,Nb as n,Ob as i,Pb as o,Qb as r,Rb as t,Sb as a,Tb as S,Ub as l,Vb as c,Wb as p}from"./chunks/chunk-YJLRBIEW.js";import"./chunks/chunk-UB5IAZHF.js";import"./chunks/chunk-HR64F32V.js";import"./chunks/chunk-SK4HOYT2.js";import"./chunks/chunk-EVIDQWMF.js";import"./chunks/chunk-MFOMFMSK.js";import"./chunks/chunk-XZY4CIDV.js";import"./chunks/chunk-5UJQ2GKJ.js";import"./chunks/chunk-V4WSBIXB.js";export{S as archiveSession,p as createSessionManager,a as deleteSession,i as forkSession,t as listRunningSessions,s as listSessions,n as loadFullTranscript,e as loadSession,o as rewindSession,r as setActiveEntry,l as unarchiveSession,c as watchSessions};
+import{$a as o,Ib as i,Jb as t,Kb as r,Lb as n,Mb as a,Nb as S,Ob as l,Pb as y,Qb as d,Rb as m,Sb as p,Tb as c}from"./chunks/chunk-MFPYZT52.js";import{K as s,L as e}from"./chunks/chunk-7X7SOVER.js";import"./chunks/chunk-BFXFSEHK.js";import"./chunks/chunk-JJTUBNQX.js";import"./chunks/chunk-EVIDQWMF.js";import"./chunks/chunk-4RVSFOUT.js";import"./chunks/chunk-5USNUSTL.js";import"./chunks/chunk-LE6STNVN.js";import"./chunks/chunk-HMATTIU6.js";import"./chunks/chunk-V4WSBIXB.js";export{d as archiveSession,c as createSessionManager,y as deleteSession,s as extractHistorySeedsFromMessage,e as extractHistorySeedsFromMessages,n as forkSession,l as listRunningSessions,i as listSessions,r as loadFullTranscript,t as loadSession,o as restoreHistoryItemsFromSession,a as rewindSession,S as setActiveEntry,m as unarchiveSession,p as watchSessions};

package/dist/sdk-skills.js

@@ -1,2 +1,2 @@
 // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{$b as t,Yb as l,Zb as e,_b as i,ac as a,bc as o,fc as k,gc as r,hc as S,ic as s,jc as n,kc as g,lc as u,mc as c,nc as x,oc as d,pc as P,qc as R,rc as h,sc as p,tc as v,uc as y,vc as M,wc as f,xc as m,yc as E}from"./chunks/chunk-5UJQ2GKJ.js";import"./chunks/chunk-V4WSBIXB.js";export{y as SkillExecutor,R as SkillRegistry,x as VariableResolver,t as clearPluginSkillPaths,M as createExecutor,d as createResolver,n as discoverSkills,u as discoverSkillsWithMonorepo,f as executeSkill,m as expandSkillForLLM,E as formatSkillActivationMessage,a as getDefaultSkillPaths,g as getNestedSkillPaths,o as getSkillPathsFlat,h as getSkillRegistry,p as initializeSkillRegistry,i as listPluginSkillPaths,S as loadFullSkill,s as loadSkillFileContent,r as loadSkillMetadata,c as parseArguments,k as parseSkillMarkdown,l as registerPluginSkillPath,v as resetSkillRegistry,P as resolveSkillContent,e as unregisterPluginSkillPath};
+import{$b as t,Yb as l,Zb as e,_b as i,ac as a,bc as o,fc as k,gc as r,hc as S,ic as s,jc as n,kc as g,lc as u,mc as c,nc as x,oc as d,pc as P,qc as R,rc as h,sc as p,tc as v,uc as y,vc as M,wc as f,xc as m,yc as E}from"./chunks/chunk-HMATTIU6.js";import"./chunks/chunk-V4WSBIXB.js";export{y as SkillExecutor,R as SkillRegistry,x as VariableResolver,t as clearPluginSkillPaths,M as createExecutor,d as createResolver,n as discoverSkills,u as discoverSkillsWithMonorepo,f as executeSkill,m as expandSkillForLLM,E as formatSkillActivationMessage,a as getDefaultSkillPaths,g as getNestedSkillPaths,o as getSkillPathsFlat,h as getSkillRegistry,p as initializeSkillRegistry,i as listPluginSkillPaths,S as loadFullSkill,s as loadSkillFileContent,r as loadSkillMetadata,c as parseArguments,k as parseSkillMarkdown,l as registerPluginSkillPath,v as resetSkillRegistry,P as resolveSkillContent,e as unregisterPluginSkillPath};

package/dist/types-chunks/{types.d-rPRl2LSB.d.ts → base.d-BBNUF9nz.d.ts}

@@ -119,7 +119,7 @@ interface KodaXToolDefinition {
         required?: string[];
     };
 }
-type KodaXReasoningCapability = 'native-effort' | 'native-budget' | 'native-toggle' | 'none' | 'prompt-only' | 'unknown';
+type KodaXReasoningCapability = 'native-effort' | 'native-budget' | 'native-toggle' | 'native-adaptive' | 'none' | 'prompt-only' | 'unknown';
 type KodaXProviderTransport = 'native-api' | 'cli-bridge';
 type KodaXProviderConversationSemantics = 'full-history' | 'last-user-message';
 type KodaXProviderMcpSupport = 'native' | 'none';
@@ -140,7 +140,7 @@ interface KodaXProviderCapabilityProfile {
     multimodalSupport?: KodaXProviderMultimodalSupport;
     evidenceSupport?: KodaXProviderEvidenceSupport;
 }
-type KodaXReasoningOverride = 'budget' | 'effort' | 'toggle' | 'none';
+type KodaXReasoningOverride = 'budget' | 'effort' | 'toggle' | 'adaptive' | 'none';
 type KodaXReasoningMode = 'off' | 'auto' | 'quick' | 'balanced' | 'deep';
 type KodaXThinkingDepth = 'off' | 'low' | 'medium' | 'high';
 type KodaXTaskType = 'conversation' | 'lookup' | 'review' | 'bugfix' | 'edit' | 'refactor' | 'plan' | 'qa' | 'unknown';
@@ -482,4 +482,272 @@ interface KodaXProviderStreamOptions {
     signal?: AbortSignal;
 }
 
-export type { KodaXToolResultImageItem as $, KodaXProviderStreamOptions as A, KodaXProviderToolCallingFidelity as B, KodaXProviderTransport as C, KodaXReasoningCapability as D, KodaXReasoningMode as E, KodaXReasoningOverride as F, KodaXReasoningRequest as G, KodaXRedactedThinkingBlock as H, KodaXReviewScale as I, KodaXRiskLevel as J, KodaXAmaControllerDecision as K, KodaXStreamResult as L, KodaXTaskActionability as M, KodaXTaskBudgetOverrides as N, KodaXTaskComplexity as O, KodaXTaskFamily as P, KodaXTaskRoutingDecision as Q, KodaXTaskType as R, KodaXTaskWorkIntent as S, KodaXTextBlock as T, KodaXThinkingBlock as U, KodaXThinkingBudgetMap as V, KodaXThinkingDepth as W, KodaXTokenUsage as X, KodaXToolDefinition as Y, KodaXToolResultBlock as Z, KodaXToolResultContentItem as _, KodaXAmaFanoutClass as a, KodaXToolResultTextItem as a0, KodaXToolUseBlock as a1, KodaXVerifyCredentialResult as a2, KodaXVerifyStrategy as a3, KodaXAmaFanoutPolicy as b, KodaXAmaProfile as c, KodaXAmaTactic as d, KodaXAssuranceIntent as e, KodaXCacheBoundary as f, KodaXContentBlock as g, KodaXCustomProviderConfig as h, KodaXExecutionMode as i, KodaXExecutionPattern as j, KodaXHarnessProfile as k, KodaXImageBlock as l, KodaXListModelsResult as m, KodaXMessage as n, KodaXModelDescriptor as o, KodaXMutationSurface as p, KodaXProtocolFamily as q, KodaXProviderCapabilityProfile as r, KodaXProviderConfig as s, KodaXProviderContextFidelity as t, KodaXProviderConversationSemantics as u, KodaXProviderEvidenceSupport as v, KodaXProviderLongRunningSupport as w, KodaXProviderMcpSupport as x, KodaXProviderMultimodalSupport as y, KodaXProviderSessionSupport as z };
+/**
+ * Retry-After header parsing — FEATURE_130 (v0.7.36).
+ *
+ * Handles the four forms KodaX's 12 provider adapters encounter when a
+ * model returns 429 (rate limit) or 503/529 (overloaded):
+ *
+ *   1. `Retry-After: 120`               — integer seconds (HTTP 7231 standard)
+ *   2. `Retry-After: <HTTP-date>`       — RFC 7231 IMF-fixdate
+ *      e.g. "Wed, 21 Oct 2026 07:28:00 GMT"
+ *   3. `retry-after-ms: 45000`          — Anthropic millisecond extension
+ *   4. (no Retry-After header present)  — falls back to exponential backoff
+ *      capped at `maxBackoffMs`, with optional jitter for the
+ *      "thundering herd" protection.
+ *
+ * All return values are normalized to whole milliseconds and clamped to
+ * a sensible upper bound — never block the user for more than 120s, and
+ * never honor a header advertising a wait longer than `maxHeaderWaitMs`
+ * (default 120s). Beyond that limit we still extract the header but cap
+ * it; the calling provider can check `cappedFromHeader` to decide
+ * whether to surface a "rate limit exceeded — please wait" error to the
+ * user instead of silently sleeping for two minutes.
+ *
+ * Pattern-B (FEATURE_119) interaction: the helper is referentially
+ * transparent and stateless — it can be invoked concurrently by N
+ * parallel children without coordination. The retry loop in each
+ * provider holds its own attempt counter; this helper only translates
+ * headers/attempts into wait durations.
+ *
+ * Reference: opencode session/retry.ts:14-123 (4-form coverage).
+ */
+type RetryAfterSource = 'retry-after-seconds' | 'retry-after-date' | 'retry-after-ms' | 'exponential-backoff';
+type RetryAfterResult = {
+    readonly type: 'header';
+    readonly waitMs: number;
+    readonly source: 'retry-after-seconds' | 'retry-after-date' | 'retry-after-ms';
+    /** True when the header value exceeded `maxHeaderWaitMs` and was clamped. */
+    readonly cappedFromHeader: boolean;
+} | {
+    readonly type: 'backoff';
+    readonly waitMs: number;
+    readonly source: 'exponential-backoff';
+    readonly attempt: number;
+};
+interface ParseRetryAfterOptions {
+    /** Zero-based attempt index used by the backoff branch (0 = first retry). */
+    readonly attempt: number;
+    /** Base delay for exponential backoff. Default 1000ms. */
+    readonly baseBackoffMs?: number;
+    /** Maximum exponential backoff cap. Default 30000ms. */
+    readonly maxBackoffMs?: number;
+    /** Maximum wait honored from a header. Default 120000ms. */
+    readonly maxHeaderWaitMs?: number;
+    /**
+     * Override the "now" reference used by the HTTP-date branch.
+     * Test-only escape hatch — production code should leave this undefined.
+     */
+    readonly now?: () => number;
+    /**
+     * Whether the backoff branch adds 0-25% jitter on top of the base
+     * exponential. Default true (matches the legacy `withRateLimit`
+     * jitter contract). Tests can pass `false` for deterministic output.
+     */
+    readonly withJitter?: boolean;
+}
+type HeadersLike = Headers | Record<string, string | string[] | undefined> | undefined;
+/**
+ * Parse rate-limit/overload retry-after headers (4 forms) and decide
+ * how long the caller should sleep before retrying. Returns either:
+ *
+ *  - `{type: 'header', ...}` when one of the supported headers was found
+ *    and converted into a wait duration; OR
+ *  - `{type: 'backoff', ...}` falling back to exponential backoff for
+ *    the given `attempt` index when no header is present.
+ */
+declare function parseRetryAfter(headers: HeadersLike, options: ParseRetryAfterOptions): RetryAfterResult;
+/**
+ * Pull headers off a thrown error in the various shapes produced across
+ * provider SDKs (Anthropic, OpenAI, fetch-based custom providers).
+ * Returns `undefined` when no headers can be located — the helper then
+ * falls through to exponential backoff.
+ */
+declare function extractHeadersFromError(error: unknown): HeadersLike;
+
+/**
+ * KodaX Base Provider
+ *
+ * Provider 抽象基类 - 所有 Provider 的公共基础
+ */
+
+/**
+ * FEATURE_130 (v0.7.36): structured payload fired through
+ * `KodaXEvents.onRetryAfter` whenever a provider's `withRateLimit`
+ * loop catches a 429 / 503 / 529 response and decides to wait. The
+ * `source` field carries which retry-after header form (or fallback)
+ * produced the wait duration so UI surfaces can show "provider asked
+ * us to wait 45s" vs "no header, exp-backoff guess of 4s".
+ */
+interface KodaXRetryAfterEvent {
+    readonly provider: string;
+    readonly waitMs: number;
+    readonly reason: 'rate-limit' | 'overloaded';
+    readonly source: RetryAfterSource;
+    readonly attempt: number;
+    readonly maxAttempts: number;
+}
+type KodaXOnRetryAfterCallback = (event: KodaXRetryAfterEvent) => void;
+declare abstract class KodaXBaseProvider {
+    abstract readonly name: string;
+    abstract readonly supportsThinking: boolean;
+    protected abstract readonly config: KodaXProviderConfig;
+    /**
+     * Per-request override for `max_tokens` in the next provider call. Consumed
+     * once and cleared in `withRateLimit` after the next successful response.
+     * Two callers set this:
+     *   1. Context-overflow recovery inside `withRateLimit` (reduces budget
+     *      when the model reports "prompt too long").
+     *   2. The agent loop's max_tokens escalation path, which flips this to
+     *      `KODAX_ESCALATED_MAX_OUTPUT_TOKENS` when a capped-budget turn
+     *      returns `stop_reason: max_tokens`. See `coding/src/agent.ts`.
+     */
+    protected maxOutputTokensOverride?: number;
+    /**
+     * Public setter for the one-shot override above. Callers outside the
+     * provider package (notably the agent loop's escalation branch) use this
+     * to stage a larger budget for the next stream call in the same logical
+     * turn. Pass `undefined` to clear a stale override explicitly.
+     */
+    setMaxOutputTokensOverride(value: number | undefined): void;
+    /**
+     * Returns the max_tokens value the provider will currently use on its
+     * next request. Precedence (highest to lowest):
+     *   1. One-shot override (agent escalation, context-overflow recovery)
+     *   2. User env var `KODAX_MAX_OUTPUT_TOKENS` (explicit user intent)
+     *   3. Active model descriptor's `maxOutputTokens` (FEATURE_098)
+     *   4. Provider config default
+     *   5. Global `KODAX_MAX_TOKENS` fallback
+     * Used by provider stream() paths and by the agent loop to decide
+     * whether escalation is applicable (see `coding/src/agent.ts`).
+     */
+    getEffectiveMaxOutputTokens(model?: string): number;
+    /**
+     * Hard cap on a single streaming request's wall-clock duration (ms).
+     * Returns undefined when no cap is configured. Consumed by the
+     * resilience layer to abort a doomed stream before the server-side
+     * kill window fires; routed through `non_streaming_fallback`.
+     *
+     * Cascade (highest to lowest):
+     *   1. Active model descriptor's `streamMaxDurationMs`
+     *   2. Provider config default
+     *   3. undefined (watchdog disabled)
+     */
+    getStreamMaxDurationMs(model?: string): number | undefined;
+    /**
+     * Resolves whether OpenAI-compat `reasoning_content` should echo back
+     * on replayed assistant messages for the given model. Same cascade as
+     * `getStreamMaxDurationMs`. Defaults to false when neither layer sets it.
+     */
+    getEffectiveReplayReasoningContent(model?: string): boolean;
+    /**
+     * Resolves whether Anthropic-style thinking signatures must verify
+     * strictly (Anthropic proper only). Same cascade as
+     * `getStreamMaxDurationMs`. Defaults to false (lenient) when neither
+     * layer sets it — matches third-party Anthropic-compat behavior.
+     */
+    getEffectiveStrictThinkingSignature(model?: string): boolean;
+    abstract stream(messages: KodaXMessage[], tools: KodaXToolDefinition[], system: string, reasoning?: boolean | KodaXReasoningRequest, streamOptions?: KodaXProviderStreamOptions, signal?: AbortSignal): Promise<KodaXStreamResult>;
+    supportsNonStreamingFallback(): boolean;
+    complete(_messages: KodaXMessage[], _tools: KodaXToolDefinition[], _system: string, _reasoning?: boolean | KodaXReasoningRequest, _streamOptions?: KodaXProviderStreamOptions, _signal?: AbortSignal): Promise<KodaXStreamResult>;
+    isConfigured(): boolean;
+    /**
+     * FEATURE_216 v0.7.45 — Lightweight credential verification. Returns
+     * a never-throws envelope with `ok` + categorized `error`. Concrete
+     * compat base classes (`KodaXAnthropicCompatProvider`,
+     * `KodaXOpenAICompatProvider`) override this to dispatch by the
+     * `verifyStrategy` field. The default here returns `unsupported` so
+     * Provider classes that don't extend a compat base — or future ones
+     * yet to be wired — fail safely instead of throwing.
+     *
+     * Distinct from `isConfigured()`: that one is env-only (no network);
+     * this one hits the wire (zero or ~7 tokens depending on strategy)
+     * and verifies the key is actually accepted by the upstream.
+     */
+    verifyCredential(_opts?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<KodaXVerifyCredentialResult>;
+    getModel(): string;
+    getAvailableModels(): string[];
+    getModelDescriptor(modelId?: string): KodaXModelDescriptor | undefined;
+    getBaseUrl(): string | undefined;
+    getApiKeyEnv(): string;
+    getCapabilityProfile(): KodaXProviderCapabilityProfile;
+    getConfiguredReasoningCapability(modelOverride?: string): KodaXReasoningCapability;
+    getReasoningCapability(modelOverride?: string): KodaXReasoningCapability;
+    getReasoningOverride(modelOverride?: string): KodaXReasoningOverride | undefined;
+    getReasoningOverrideKey(modelOverride?: string): string;
+    protected persistReasoningCapabilityOverride(capability: KodaXReasoningCapability, modelOverride?: string): void;
+    protected shouldFallbackForReasoningError(error: unknown, ...terms: string[]): boolean;
+    protected shouldFallbackForSpecificReasoningError(error: unknown, ...terms: string[]): boolean;
+    protected shouldFallbackForForcedToolChoiceError(error: unknown): boolean;
+    protected isServerError(error: unknown): boolean;
+    protected getReasoningFallbackChain(capability: KodaXReasoningCapability): KodaXReasoningCapability[];
+    /**
+     * 获取模型的上下文窗口大小
+     *
+     * Backwards-compatible no-arg form: resolves against the provider's
+     * default model descriptor. New call sites that know the active
+     * model should use `getEffectiveContextWindow(model)` directly.
+     * @returns 上下文窗口大小 (tokens)
+     */
+    getContextWindow(): number;
+    /**
+     * Resolves the context window for a specific model.
+     * Precedence (highest to lowest):
+     *   1. Active model descriptor's `contextWindow` (FEATURE_098)
+     *   2. Provider config default
+     *   3. 200_000 fallback
+     * The user-level `compaction.contextWindow` is layered on top of
+     * this at the call site, so it remains the highest-priority manual
+     * override.
+     */
+    getEffectiveContextWindow(model?: string): number;
+    protected getApiKey(): string;
+    protected shouldLogStreamDiagnostics(): boolean;
+    protected logStreamDiagnostic(...args: unknown[]): void;
+    protected normalizeReasoning(reasoning?: boolean | KodaXReasoningRequest): Required<KodaXReasoningRequest>;
+    /**
+     * Called when ECONNRESET/EPIPE is detected, indicating a stale keep-alive
+     * socket.  Subclasses should override to rebuild their HTTP client with a
+     * fresh connection pool so the next retry uses a new TCP connection.
+     */
+    protected onStaleConnection(): void;
+    protected isRateLimitError(error: unknown): boolean;
+    /**
+     * FEATURE_130: classify a rate-limit error as either a 429-style
+     * "rate-limit" or a 503/529-style "overloaded" condition. The
+     * distinction matters for UI: "rate-limit" usually surfaces a
+     * provider-supplied retry-after window; "overloaded" tends to fall
+     * through to exponential backoff with no header. Both flow through
+     * the same retry path; this only labels the event.
+     */
+    protected classifyRateLimitReason(error: unknown): 'rate-limit' | 'overloaded';
+    /**
+     * Extract Retry-After delay from error headers (429/529 responses).
+     * Returns milliseconds, or undefined when no usable header is present.
+     *
+     * FEATURE_130 (v0.7.36): now delegates to the shared `parseRetryAfter`
+     * helper so all 12 provider adapters get 4-form coverage without each
+     * adapter rolling its own parser. The 4 forms supported are:
+     *   - `Retry-After: <integer-seconds>`
+     *   - `Retry-After: <HTTP-date>`
+     *   - `retry-after-ms: <milliseconds>` (Anthropic extension)
+     *   - exponential-backoff fallback (returned via `withRateLimit`,
+     *     not through this helper — it is `undefined` here when no
+     *     header is present, which the caller then resolves to backoff)
+     */
+    protected extractRetryAfterMs(error: unknown): number | undefined;
+    /**
+     * Detect "prompt too long / context window exceeded" errors and compute
+     * a reduced max_tokens for retry.  Returns undefined if not a context
+     * overflow error.
+     */
+    protected parseContextOverflow(error: unknown): number | undefined;
+    protected isContextOverflowError(error: unknown): boolean;
+    protected withRateLimit<T>(fn: () => Promise<T>, signal?: AbortSignal, retries?: number, onRateLimit?: (attempt: number, maxRetries: number, delayMs: number) => void, onRetryAfter?: KodaXOnRetryAfterCallback): Promise<T>;
+}
+
+export { extractHeadersFromError as aa, parseRetryAfter as ab, KodaXBaseProvider as f };
+export type { KodaXToolDefinition as $, KodaXProviderMultimodalSupport as A, KodaXProviderSessionSupport as B, KodaXProviderStreamOptions as C, KodaXProviderToolCallingFidelity as D, KodaXProviderTransport as E, KodaXReasoningCapability as F, KodaXReasoningMode as G, KodaXReasoningOverride as H, KodaXReasoningRequest as I, KodaXRedactedThinkingBlock as J, KodaXAmaControllerDecision as K, KodaXRetryAfterEvent as L, KodaXReviewScale as M, KodaXRiskLevel as N, KodaXStreamResult as O, KodaXTaskActionability as P, KodaXTaskBudgetOverrides as Q, KodaXTaskComplexity as R, KodaXTaskFamily as S, KodaXTaskRoutingDecision as T, KodaXTaskType as U, KodaXTaskWorkIntent as V, KodaXTextBlock as W, KodaXThinkingBlock as X, KodaXThinkingBudgetMap as Y, KodaXThinkingDepth as Z, KodaXTokenUsage as _, KodaXAmaFanoutClass as a, KodaXToolResultBlock as a0, KodaXToolResultContentItem as a1, KodaXToolResultImageItem as a2, KodaXToolResultTextItem as a3, KodaXToolUseBlock as a4, KodaXVerifyCredentialResult as a5, KodaXVerifyStrategy as a6, ParseRetryAfterOptions as a7, RetryAfterResult as a8, RetryAfterSource as a9, KodaXAmaFanoutPolicy as b, KodaXAmaProfile as c, KodaXAmaTactic as d, KodaXAssuranceIntent as e, KodaXCacheBoundary as g, KodaXContentBlock as h, KodaXCustomProviderConfig as i, KodaXExecutionMode as j, KodaXExecutionPattern as k, KodaXHarnessProfile as l, KodaXImageBlock as m, KodaXListModelsResult as n, KodaXMessage as o, KodaXModelDescriptor as p, KodaXMutationSurface as q, KodaXOnRetryAfterCallback as r, KodaXProtocolFamily as s, KodaXProviderCapabilityProfile as t, KodaXProviderConfig as u, KodaXProviderContextFidelity as v, KodaXProviderConversationSemantics as w, KodaXProviderEvidenceSupport as x, KodaXProviderLongRunningSupport as y, KodaXProviderMcpSupport as z };