@kodax-ai/kodax 0.7.40 → 0.7.42

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/CHANGELOG.md +146 -1
  2. package/README.md +129 -232
  3. package/README_CN.md +128 -253
  4. package/dist/chunks/chunk-3RKBXWZS.js +2 -0
  5. package/dist/chunks/chunk-7JLYVWAF.js +1033 -0
  6. package/dist/chunks/chunk-CD3R5YBH.js +16 -0
  7. package/dist/chunks/chunk-DKXUY5F2.js +209 -0
  8. package/dist/chunks/chunk-HMYEQJGT.js +31 -0
  9. package/dist/chunks/{chunk-FAVPT4P7.js → chunk-IYJ5EPRV.js} +1 -1
  10. package/dist/chunks/chunk-KUX5LRPP.js +2 -0
  11. package/dist/chunks/{chunk-EQ5DGS2W.js → chunk-OWSKU55I.js} +5 -6
  12. package/dist/chunks/chunk-ZZ4KRK2B.js +465 -0
  13. package/dist/chunks/compaction-config-FIFFP4FT.js +2 -0
  14. package/dist/chunks/{construction-bootstrap-OFPUZTXQ.js → construction-bootstrap-J2WOCYEK.js} +1 -1
  15. package/dist/chunks/dist-2ZHWDXMQ.js +2 -0
  16. package/dist/chunks/dist-W4CJWLIH.js +2 -0
  17. package/dist/chunks/utils-A5MWDTWZ.js +2 -0
  18. package/dist/index.d.ts +237 -7
  19. package/dist/index.js +5 -5
  20. package/dist/kodax_cli.js +935 -917
  21. package/dist/sdk-agent.d.ts +1375 -10
  22. package/dist/sdk-agent.js +1 -1
  23. package/dist/sdk-coding.d.ts +4608 -14
  24. package/dist/sdk-coding.js +1 -1
  25. package/dist/sdk-llm.d.ts +210 -10
  26. package/dist/sdk-llm.js +1 -1
  27. package/dist/sdk-mcp.d.ts +17 -0
  28. package/dist/sdk-mcp.js +2 -0
  29. package/dist/sdk-repl.d.ts +3026 -13
  30. package/dist/sdk-repl.js +2 -1
  31. package/dist/sdk-session.d.ts +164 -0
  32. package/dist/sdk-session.js +2 -0
  33. package/dist/sdk-skills.d.ts +553 -9
  34. package/dist/sdk-skills.js +1 -1
  35. package/dist/types-chunks/bash-prefix-extractor.d-CkhaqKkg.d.ts +2571 -0
  36. package/dist/types-chunks/capability.d-3C62G8Eq.d.ts +39 -0
  37. package/dist/types-chunks/config.d-BfJUXxC0.d.ts +41 -0
  38. package/dist/types-chunks/cost-tracker.d-B6vMoLLF.d.ts +360 -0
  39. package/dist/types-chunks/history-cleanup.d-DznrzEiU.d.ts +1475 -0
  40. package/dist/types-chunks/instance-discovery.d-BsKnIwpg.d.ts +990 -0
  41. package/dist/types-chunks/resolver.d-DX9au4NJ.d.ts +263 -0
  42. package/dist/types-chunks/session-storage.d-Cci897iM.d.ts +68 -0
  43. package/dist/types-chunks/storage.d-Bc5DoAwp.d.ts +532 -0
  44. package/dist/types-chunks/transport.d-DuyjG30t.d.ts +180 -0
  45. package/dist/types-chunks/types.d-B1uGoVTE.d.ts +400 -0
  46. package/dist/types-chunks/types.d-C5mHR87z.d.ts +119 -0
  47. package/dist/types-chunks/types.d-mM8vqvhT.d.ts +254 -0
  48. package/package.json +16 -3
  49. package/dist/acp_events.d.ts +0 -109
  50. package/dist/acp_logger.d.ts +0 -20
  51. package/dist/acp_server.d.ts +0 -92
  52. package/dist/chunks/chunk-6QO6HWGU.js +0 -30
  53. package/dist/chunks/chunk-CLS57NPX.js +0 -460
  54. package/dist/chunks/chunk-NDNILSTR.js +0 -2
  55. package/dist/chunks/chunk-QZEDWITG.js +0 -1226
  56. package/dist/chunks/chunk-Z5EBDA6R.js +0 -15
  57. package/dist/chunks/compaction-config-A7XZ6H5Y.js +0 -2
  58. package/dist/chunks/dist-M57GIWR4.js +0 -2
  59. package/dist/chunks/dist-OTUF22DA.js +0 -2
  60. package/dist/chunks/utils-DFMYJUTE.js +0 -2
  61. package/dist/cli_commands.d.ts +0 -17
  62. package/dist/cli_option_helpers.d.ts +0 -49
  63. package/dist/cli_option_helpers.test.d.ts +0 -1
  64. package/dist/constructed_cli.d.ts +0 -82
  65. package/dist/constructed_cli.test.d.ts +0 -1
  66. package/dist/kodax_cli.d.ts +0 -7
  67. package/dist/self_modify_cli.d.ts +0 -81
  68. package/dist/self_modify_cli.test.d.ts +0 -9
  69. package/dist/skill_cli.d.ts +0 -15
  70. package/dist/skill_cli.test.d.ts +0 -1
@@ -1,2 +1,2 @@
1
1
  // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{$ as mr,$a as me,$b as ff,$c as mm,$d as mp,A as Fo,Aa as Fr,Ab as Fe,Ac as Ff,Ad as Fm,B as Go,Ba as Gr,Bb as Ge,Bc as Gf,Bd as Gm,C as Ho,Ca as Hr,Cb as He,Cc as Hf,Cd as Hm,D as Io,Da as Ir,Db as Ie,Dc as If,Dd as Im,E as Jo,Ea as Jr,Eb as Je,Ec as Jf,Ed as Jm,F as Ko,Fa as Kr,Fb as Ke,Fc as Kf,Fd as Km,G as Lo,Ga as Lr,Gb as Le,Gc as Lf,Gd as Lm,H as Mo,Ha as Mr,Hb as Me,Hc as Mf,Hd as Mm,I as No,Ia as Nr,Ib as Ne,Ic as Nf,Id as Nm,J as Oo,Ja as Or,Jb as Oe,Jc as Of,Jd as Om,K as Po,Ka as Pr,Kb as Pe,Kc as Pf,Kd as Pm,L as Qo,La as Qr,Lb as Qe,Lc as Qf,Ld as Qm,M as Ro,Ma as Rr,Mb as Re,Mc as Rf,Md as Rm,N as So,Na as Sr,Nb as Se,Nc as Sf,Nd as Sm,O as To,Oa as Tr,Ob as Te,Oc as Tf,Od as Tm,P as Uo,Pa as Ur,Pb as Ue,Pc as Uf,Pd as Um,Q as Vo,Qa as Vr,Qb as Ve,Qc as Vf,Qd as Vm,R as Wo,Ra as Wr,Rb as We,Rc as Wf,Rd as Wm,S as Xo,Sa as Xr,Sb as Xe,Sc as Xf,Sd as Xm,T as Yo,Ta as Yr,Tb as Ye,Tc as Yf,Td as Ym,U as Zo,Ua as Zr,Ub as Ze,Uc as Zf,Ud as Zm,V as _o,Va as _r,Vb as _e,Vc as _f,Vd as _m,W as $o,Wa as $r,Wb as $e,Wc as $f,Wd as $m,X as or,Xa as oe,Xb as of,Xc as om,Xd as op,Y as rr,Ya as re,Yb as rf,Yc as rm,Yd as rp,Z as er,Za as ee,Zc as em,Zd as ep,_ as fr,_a as fe,_b as ef,_c as fm,_d as fp,a as N,aa as pr,ab as pe,ac as mf,ad as pm,ae as pp,b as O,ba as tr,bb as te,bc as pf,bd as tm,be as tp,c as P,ca as xr,cb as xe,cc as tf,cd as xm,ce as xp,d as Q,da as ar,db as ae,dc as xf,dd as am,de as ap,e as R,ea as br,eb as be,ec as af,ed as bm,ee as bp,f as bo,fa as cr,fb as ce,fc as bf,fd as cm,fe as cp,g as co,ga as dr,gb as de,gc as cf,gd as dm,ge as dp,h as go,ha as gr,hb as ge,hc as df,hd as gm,he as gp,i as ho,ia as hr,ib as he,ic as gf,id as hm,ie as hp,j as io,ja as ir,jb as ie,jc as hf,jd as im,je as ip,k as jo,ka as jr,kb as je,kc as jf,kd as jm,ke as jp,l as ko,la as kr,lb as ke,lc as kf,ld as km,le as kp,m as lo,ma as lr,mb as le,mc as lf,md as lm,me as lp,n as no,na as nr,nb as ne,nc as nf,nd as nm,ne as np,o as qo,oa as qr,ob as qe,oc as qf,od as qm,p as so,pa as sr,pb as se,pc as sf,pd as sm,q as uo,qa as ur,qb as ue,qc as uf,qd as um,r as vo,ra as vr,rb as ve,rc as vf,rd as vm,s as wo,sa as wr,sb as we,sc as wf,sd as wm,t as yo,ta as yr,tb as ye,tc as yf,td as ym,u as zo,ua as zr,ub as ze,uc as zf,ud as zm,v as Ao,va as Ar,vb as Ae,vc as Af,vd as Am,w as Bo,wa as Br,wb as Be,wc as Bf,wd as Bm,x as Co,xa as Cr,xb as Ce,xc as Cf,xd as Cm,y as Do,ya as Dr,yb as De,yc as Df,yd as Dm,z as Eo,za as Er,zb as Ee,zc as Ef,zd as Em}from"./chunks/chunk-QZEDWITG.js";import{Da as xo,Ea as ao,Z as po,a as S,aa as to,b as T,c as U,d as V,e as W,f as X,h as Y,i as Z,j as _,k as $,l as oo,m as ro,n as eo,o as fo,p as mo}from"./chunks/chunk-Z5EBDA6R.js";import"./chunks/chunk-EQ5DGS2W.js";import{$ as A,C as c,I as d,J as g,O as h,P as i,Q as j,R as k,S as l,T as n,U as q,V as s,W as u,X as v,Y as w,Z as y,_ as z,a as o,aa as B,b as r,ba as C,c as e,ca as D,da as E,ea as F,fa as G,ga as H,ha as I,ia as J,j as f,ja as K,ka as L,la as M,t as m,u as p,v as t,w as x,x as a,y as b}from"./chunks/chunk-6QO6HWGU.js";import"./chunks/chunk-V4WSBIXB.js";export{Xm as AUTO_MODE_DENIAL_CONSECUTIVE_THRESHOLD,Ym as AUTO_MODE_DENIAL_CUMULATIVE_THRESHOLD,kp as BASH_POLICY_SPEC,rp as BREAKER_ERROR_THRESHOLD,ep as BREAKER_WINDOW_MS,co as CANCELLED_TOOL_RESULT_MESSAGE,bo as CANCELLED_TOOL_RESULT_PREFIX,Nm as CODING_AGENTS,Im as CODING_AGENT_MARKER,Pf as CODING_INVARIANTS,Ff as CODING_SUMMARY_PROMPT,Gf as CODING_UPDATE_SUMMARY_PROMPT,zr as CapabilityDeniedError,Rf as Client,Ar as ConstructionManifestError,Hf as DEFAULT_CODING_AGENT_NAME,Am as DEFAULT_DANGEROUS_PATTERNS,wr as DEFAULT_HANDLER_TIMEOUT_MS,tf as DEFAULT_RESILIENCE_CONFIG,zm as DEFAULT_SAFE_PATTERNS,Wr as DEFAULT_SELF_MODIFY_BUDGET,gp as DEFAULT_SPECULATIVE_WINDOW_MS,ho as DEFAULT_TOOL_OUTPUT_MAX_BYTES,go as DEFAULT_TOOL_OUTPUT_MAX_LINES,mo as DefaultSummaryCompaction,$f as EMIT_CONTRACT_TOOL_NAME,om as EMIT_HANDOFF_TOOL_NAME,_f as EMIT_SCOUT_VERDICT_TOOL_NAME,rm as EMIT_VERDICT_TOOL_NAME,Er as EVALUATOR_AGENT_NAME,Q as ErrorCategory,Dr as GENERATOR_AGENT_NAME,Z as KODAX_API_MIN_INTERVAL,j as KODAX_DEFAULT_PROVIDER,T as KODAX_DEFAULT_TIMEOUT,U as KODAX_HARD_TIMEOUT,X as KODAX_MAX_INCOMPLETE_RETRIES,V as KODAX_MAX_RETRIES,S as KODAX_MAX_TOKENS,i as KODAX_PROVIDERS,h as KODAX_PROVIDER_SNAPSHOTS,f as KODAX_REASONING_MODE_SEQUENCE,W as KODAX_RETRY_BASE_DELAY,Y as KODAX_STAGGER_DELAY,he as KODAX_TOOLS,d as KodaXAnthropicCompatProvider,c as KodaXBaseProvider,Rf as KodaXClient,o as KodaXError,Bf as KodaXExtensionRuntime,g as KodaXOpenAICompatProvider,r as KodaXProviderError,e as KodaXRateLimitError,O as KodaXSessionError,P as KodaXTerminalError,N as KodaXToolError,Ke as LINEAGE_ENTRY_TYPES,Me as LineageCompaction,Le as LineageExtension,lm as McpCapabilityProvider,km as McpServerRuntime,Cr as PLANNER_AGENT_NAME,_ as PROMISE_PATTERN,Ce as PROMPT_SECTION_REGISTRY,tm as PROTOCOL_EMITTER_TOOLS,df as ProviderRecoveryCoordinator,io as READ_DEFAULT_LIMIT,ko as READ_MAX_LINE_CHARS,jo as READ_PREFLIGHT_SIZE_BYTES,Uo as REPOINTEL_DEFAULT_ENDPOINT,to as Runner,Br as SCOUT_AGENT_NAME,Be as SYSTEM_PROMPT,bf as StableBoundaryTracker,Jr as TASK_ENGINE_ROLE_AGENTS,xm as TOOL_RESULT_TRUNCATION_GUARDRAIL_NAME,re as _resetRuntimeForTesting,me as activate,Lo as analyzeChangedScope,Ur as appendAuditEntry,Ue as appendSessionLineageLabel,Wf as applyFanoutBranchTransition,Ve as applySessionCompaction,br as applyToolResultGuardrail,$e as archiveOldIslands,Xf as assignFanoutBranchWorker,op as autoModeDenialShouldFallback,bp as bashSignalCollector,Kf as boundedRevise,pp as breakerShouldFallback,Lf as budgetCeiling,uf as buildAmaControllerDecision,He as buildCapabilityContextSections,Om as buildClassifierPrompt,qf as buildFallbackRoutingDecision,Tf as buildFanoutSchedulerPlan,Rr as buildLlmReviewPrompt,ff as buildPromptMessageContent,vf as buildPromptOverlay,Ge as buildPromptSnapshot,gf as buildProviderCapabilitySnapshot,sf as buildProviderPolicyHintsForDecision,hf as buildProviderPolicyPromptNotes,t as buildReasoningOverrideKey,Ko as buildRepoIntelligenceContext,Zo as buildRepoIntelligenceIndex,Ho as buildRepoOverview,Ze as buildSessionTree,Je as buildSystemPrompt,Ie as buildSystemPromptSnapshot,ap as checkAbsoluteDeny,ef as checkIncompleteToolCalls,yf as checkPromiseSignal,Qm as classify,Cm as classifyBashCommand,R as classifyError,af as classifyResilienceError,ao as cleanupIncompleteToolCalls,b as clearReasoningOverride,J as clearRuntimeModelProviders,dp as collectAllSignals,Em as computeInputSignature,Rm as computeRulesFingerprint,oe as configureRuntime,hr as convertCapabilityReadResult,gr as convertProviderSearchResults,Vf as countActiveFanoutBranches,_e as countActiveLineageMessages,oo as countTokens,ro as createAgent,Zm as createAutoModeDenialTracker,jp as createAutoModeToolGuardrail,Bm as createBashClassifierConfig,np as createBashPrefixExtractor,ue as createBuiltinToolDefinition,fp as createCircuitBreaker,Nr as createCtxProxy,y as createCustomProvider,If as createDefaultCodingAgent,Dm as createDenialTracker,Cf as createExtensionRuntime,Sf as createFanoutSchedulerInput,eo as createHandoff,fo as createInMemorySession,um as createKodaXTaskRunner,dm as createMcpCapabilityId,jm as createMcpTransport,De as createPromptSection,wf as createReasoningPlan,Pe as createSessionLineage,am as createToolResultTruncationGuardrail,cm as defaultMcpCacheDir,yr as defaultPolicy,$r as disableSelfModify,Mr as drainPendingSwaps,fm as emitContract,mm as emitHandoff,em as emitScoutVerdict,pm as emitVerdict,$ as estimateTokens,jf as evaluateProviderPolicy,Ir as evaluatorAgent,Mm as evaluatorCodingAgent,zf as exec,Ae as executeTool,of as extractArtifactLedger,lp as extractCommandPrefix,pf as extractComparableUserMessageText,dr as extractHtmlTitle,mf as extractPromptComparableText,Oe as extractTitleFromMessages,cp as fileSignalCollector,jr as finalizeRetrievalResult,ce as findByVersion,We as findPreviousUserEntryId,Ye as forkSessionLineage,vr as formatAgentsForPrompt,wm as formatParallelDispatchResult,lo as formatSize,Ne as generateSessionId,Hr as generatorAgent,Lm as generatorCodingAgent,Ef as getActiveExtensionRuntime,M as getAvailableProviderNames,se as getBuiltinRegisteredToolDefinition,qe as getBuiltinToolDefinition,A as getCustomProvider,D as getCustomProviderList,E as getCustomProviderModels,C as getCustomProviderNames,Hm as getDenialContext,Uf as getFanoutBranch,er as getImpactEstimate,sr as getKodaxGlobalDir,im as getMcpCachePaths,$o as getModuleContext,rr as getProcessContext,k as getProvider,s as getProviderConfiguredCapabilityProfile,q as getProviderConfiguredReasoningCapability,u as getProviderList,n as getProviderModel,v as getProviderModels,le as getRegisteredToolDefinition,_o as getRepoIntelligenceIndex,Io as getRepoOverview,fr as getRepoRoutingSignals,we as getRequiredToolParams,G as getRuntimeModelProvider,I as getRuntimeModelProviderNames,Qe as getSessionLineagePath,Re as getSessionMessagesFromLineage,or as getSymbolContext,je as getTool,ke as getToolDefinition,ne as getToolRegistrations,ar as getToolResultPolicy,Lr as hasPendingSwap,Mf as independentReview,nf as inferTaskType,Ao as inspectEditFailure,Xo as inspectRepoIntelligenceRuntime,B as isCustomProviderName,Gm as isDeniedRecently,L as isKnownProvider,vm as isParallelDispatchDirective,l as isProviderConfigured,w as isProviderName,H as isRuntimeModelProviderName,de as listAll,xe as listArtifacts,ve as listBuiltinToolDefinitions,be as listConstructed,ze as listToolDefinitions,ye as listTools,ur as loadAgentsFiles,Vm as loadAutoRules,Or as loadHandler,x as loadReasoningOverride,Zf as markFanoutBranchCancelled,Yf as markFanoutBranchCompleted,rf as mergeArtifactLedger,Ee as orderPromptSections,Um as parseAutoRules,Pm as parseClassifierOutput,zo as parseEditToolError,Sr as parseLlmReviewVerdict,gm as parseMcpCapabilityId,tp as parseModelSpec,uo as persistToolOutput,Gr as plannerAgent,Km as plannerCodingAgent,ae as readArtifact,Vr as readAuditEntries,Xr as readBudget,_r as readDisableState,hp as readSpeculativeWindowFromEnv,Sm as readTrustState,m as reasoningCapabilityToOverride,lf as reasoningModeToDepth,p as reasoningOverrideToCapability,cf as reconstructMessagesWithToolGuard,$m as recordAutoModeAllow,_m as recordAutoModeBlock,mp as recordBreakerError,Fm as recordDenial,Qf as registerCodingInvariants,nm as registerConfiguredMcpCapabilityProvider,z as registerCustomProviders,F as registerModelProvider,qm as registerOfficialSandboxExtension,po as registerPresetDispatcher,ie as registerTool,pe as rehydrateActiveArtifacts,Yr as remainingSelfModifyBudget,Mo as renderChangedScope,To as renderImpactEstimate,Qo as renderModuleContext,So as renderProcessContext,Fe as renderPromptSections,Jo as renderRepoOverview,ir as renderRetrievalResult,Ro as renderSymbolContext,Zr as resetBudget,xp as resolveClassifierModel,Kr as resolveConstructedAgent,K as resolveProvider,kf as resolveReasoningMode,Wo as resolveRepoIntelligenceMode,Vo as resolveRepoIntelligenceRuntimeConfig,xf as resolveResilienceConfig,Se as resolveSessionLineageTarget,Nf as resolveToolCapability,te as revoke,Xe as rewindSessionLineage,ge as rollbackSelfModify,Pr as runAstRules,Jf as runKodaX,Tr as runLlmReview,bm as runManagedTask,sm as runOrchestration,a as saveReasoningOverride,Fr as scoutAgent,Jm as scoutCodingAgent,hm as searchMcpCatalog,Df as setActiveExtensionRuntime,Te as setSessionLineageActiveEntry,ip as speculativeRace,ee as stage,Wm as stripAssistantText,cr as stripHtmlToText,fe as testArtifact,Go as toolAskUserQuestion,Co as toolBash,Po as toolChangedDiff,Oo as toolChangedScope,nr as toolCodeSearch,yo as toolEdit,Do as toolGlob,Eo as toolGrep,xr as toolImpactEstimate,Bo as toolInsertAfterAnchor,mr as toolModuleContext,Of as toolPermission,tr as toolProcessContext,vo as toolRead,No as toolRepoOverview,qr as toolSemanticLookup,pr as toolSymbolContext,Fo as toolUndo,lr as toolWebFetch,kr as toolWebSearch,wo as toolWrite,no as truncateHead,so as truncateLine,qo as truncateTail,Tm as trustProjectRules,xo as validateAndFixToolHistory,ym as validateSubtaskIndependence,Qr as validateToolSchemaForProvider,Yo as warmRepoIntelligenceRuntime,Af as webhook};
2
+ import{$ as br,$a as ae,$b as af,$c as bm,$d as lp,A as Ko,Aa as Kr,Ab as Je,Ac as Kf,Ad as Sm,B as Lo,Ba as Lr,Bb as Ke,Bc as Lf,Bd as Tm,C as Mo,Ca as Mr,Cb as Le,Cc as Mf,Cd as Um,D as No,Da as Nr,Db as Me,Dc as Nf,Dd as Vm,E as Oo,Ea as Or,Eb as Ne,Ec as Of,Ed as Wm,F as Po,Fa as Pr,Fb as Oe,Fc as Pf,Fd as Xm,G as Qo,Ga as Qr,Gb as Pe,Gc as Qf,Gd as Ym,H as Ro,Ha as Rr,Hb as Qe,Hc as Rf,Hd as Zm,I as So,Ia as Sr,Ib as Re,Ic as Sf,Id as _m,J as To,Ja as Tr,Jb as Se,Jc as Tf,Jd as $m,K as Uo,Ka as Ur,Kb as Te,Kc as Uf,Kd as op,L as Vo,La as Vr,Lb as Ue,Lc as Vf,Ld as rp,M as Wo,Ma as Wr,Mb as Ve,Mc as Wf,Md as ep,N as Xo,Na as Xr,Nb as We,Nc as Xf,Nd as fp,O as Yo,Oa as Yr,Ob as Xe,Oc as Yf,Od as mp,P as Zo,Pb as Ye,Pc as Zf,Pd as pp,Q as _o,Qa as Zr,Qb as Ze,Qc as _f,Qd as tp,R as $o,Ra as _r,Rb as _e,Rc as $f,Rd as xp,S as or,Sa as $r,Sb as $e,Sc as om,Sd as ap,T as rr,Ta as oe,Tb as of,Tc as rm,Td as bp,U as er,Ua as re,Ub as rf,Uc as em,Ud as cp,V as fr,Va as ee,Vb as ef,Vc as fm,Vd as dp,W as mr,Wa as fe,Wb as ff,Wc as mm,Wd as gp,X as pr,Xa as me,Xb as mf,Xc as pm,Xd as hp,Y as tr,Ya as pe,Yb as pf,Yc as tm,Yd as ip,Z as xr,Za as te,Zb as tf,Zc as xm,Zd as jp,_ as ar,_a as xe,_b as xf,_c as am,_d as kp,a as O,aa as cr,ab as be,ac as bf,ad as cm,ae as np,b as P,ba as dr,bb as ce,bc as cf,bd as dm,be as qp,c as Q,ca as gr,cb as de,cc as df,cd as gm,ce as sp,d as R,da as hr,db as ge,dc as gf,dd as hm,de as up,e as S,ea as ir,eb as he,ec as hf,ed as im,ee as vp,f as jo,fa as jr,fb as ie,fc as jf,fd as jm,fe as wp,g as ko,ga as kr,gb as je,gc as kf,gd as km,ge as yp,h as lo,ha as lr,hb as ke,hc as lf,hd as lm,he as zp,i as no,ia as nr,ib as le,ic as nf,id as nm,ie as Ap,j as qo,ja as qr,jb as ne,jc as qf,jd as Bm,k as so,ka as sr,kb as qe,kc as sf,kd as Cm,l as uo,la as ur,lb as se,lc as uf,ld as Dm,m as vo,ma as vr,mb as ue,mc as vf,md as Em,n as wo,na as wr,nb as ve,nc as wf,nd as Fm,o as yo,oa as yr,ob as we,oc as yf,od as Gm,p as zo,pa as zr,pb as ye,pc as zf,pd as Hm,q as Ao,qa as Ar,qb as ze,qc as Af,qd as Im,r as Bo,ra as Br,rb as Ae,rc as Bf,rd as Jm,s as Co,sa as Cr,sb as Be,sc as Cf,sd as Km,t as Do,ta as Dr,tb as Ce,tc as Df,td as Lm,u as Eo,ua as Er,ub as De,uc as Ef,ud as Mm,v as Fo,va as Fr,vb as Ee,vc as Ff,vd as Nm,w as Go,wa as Gr,wb as Fe,wc as Gf,wd as Om,x as Ho,xa as Hr,xb as Ge,xc as Hf,xd as Pm,y as Io,ya as Ir,yb as He,yc as If,yd as Qm,z as Jo,za as Jr,zb as Ie,zc as Jf,zd as Rm}from"./chunks/chunk-7JLYVWAF.js";import{La as ho,Ma as io,Z as to,a as T,aa as xo,b as U,c as V,d as W,e as X,f as Y,h as Z,ha as ao,i as _,ia as bo,j as $,ja as co,k as oo,ka as go,l as ro,m as eo,n as fo,o as mo,p as po}from"./chunks/chunk-CD3R5YBH.js";import{$ as A,C as c,I as d,J as g,O as h,P as i,Q as j,R as k,S as l,T as n,U as q,V as s,W as u,X as v,Y as w,Z as y,_ as z,a as o,aa as B,b as r,ba as C,c as e,ca as D,da as E,ea as F,fa as G,ga as H,ha as I,ia as J,j as f,ja as K,ka as L,la as M,ma as N,t as m,u as p,v as t,w as x,x as a,y as b}from"./chunks/chunk-HMYEQJGT.js";import"./chunks/chunk-OWSKU55I.js";import{d as qm,e as sm,f as um,g as vm,h as wm,i as ym,j as zm,k as Am}from"./chunks/chunk-DKXUY5F2.js";import"./chunks/chunk-3RKBXWZS.js";import"./chunks/chunk-V4WSBIXB.js";export{fp as AUTO_MODE_DENIAL_CONSECUTIVE_THRESHOLD,mp as AUTO_MODE_DENIAL_CUMULATIVE_THRESHOLD,yp as BASH_POLICY_SPEC,bp as BREAKER_ERROR_THRESHOLD,cp as BREAKER_WINDOW_MS,ko as CANCELLED_TOOL_RESULT_MESSAGE,jo as CANCELLED_TOOL_RESULT_PREFIX,Vm as CODING_AGENTS,Rm as CODING_AGENT_MARKER,Yf as CODING_INVARIANTS,Nf as CODING_SUMMARY_PROMPT,Of as CODING_UPDATE_SUMMARY_PROMPT,fe as CapabilityDeniedError,_f as Client,me as ConstructionManifestError,Pf as DEFAULT_CODING_AGENT_NAME,Jm as DEFAULT_DANGEROUS_PATTERNS,re as DEFAULT_HANDLER_TIMEOUT_MS,uf as DEFAULT_RESILIENCE_CONFIG,Im as DEFAULT_SAFE_PATTERNS,ye as DEFAULT_SELF_MODIFY_BUDGET,sp as DEFAULT_SPECULATIVE_WINDOW_MS,no as DEFAULT_TOOL_OUTPUT_MAX_BYTES,lo as DEFAULT_TOOL_OUTPUT_MAX_LINES,po as DefaultSummaryCompaction,cm as EMIT_CONTRACT_TOOL_NAME,dm as EMIT_HANDOFF_TOOL_NAME,bm as EMIT_SCOUT_VERDICT_TOOL_NAME,gm as EMIT_VERDICT_TOOL_NAME,R as ErrorCategory,xe as GENERATOR_AGENT_NAME,_ as KODAX_API_MIN_INTERVAL,j as KODAX_DEFAULT_PROVIDER,U as KODAX_DEFAULT_TIMEOUT,V as KODAX_HARD_TIMEOUT,Y as KODAX_MAX_INCOMPLETE_RETRIES,W as KODAX_MAX_RETRIES,T as KODAX_MAX_TOKENS,i as KODAX_PROVIDERS,h as KODAX_PROVIDER_SNAPSHOTS,f as KODAX_REASONING_MODE_SEQUENCE,X as KODAX_RETRY_BASE_DELAY,Z as KODAX_STAGGER_DELAY,Re as KODAX_TOOLS,d as KodaXAnthropicCompatProvider,c as KodaXBaseProvider,_f as KodaXClient,o as KodaXError,Zr as KodaXExtensionRuntime,g as KodaXOpenAICompatProvider,r as KodaXProviderError,e as KodaXRateLimitError,P as KodaXSessionError,Q as KodaXTerminalError,O as KodaXToolError,Fr as LINEAGE_ENTRY_TYPES,Hr as LineageCompaction,Gr as LineageExtension,Am as McpCapabilityProvider,zm as McpServerRuntime,te as PLANNER_AGENT_NAME,$ as PROMISE_PATTERN,af as PROMPT_SECTION_REGISTRY,lm as PROTOCOL_EMITTER_TOOLS,Af as ProviderRecoveryCoordinator,qo as READ_DEFAULT_LIMIT,uo as READ_MAX_LINE_CHARS,so as READ_PREFLIGHT_SIZE_BYTES,Zo as REPOINTEL_DEFAULT_ENDPOINT,xo as Runner,pe as SCOUT_AGENT_NAME,xf as SYSTEM_PROMPT,yf as StableBoundaryTracker,de as TASK_ENGINE_ROLE_AGENTS,xm as TOOL_RESULT_TRUNCATION_GUARDRAIL_NAME,Fe as _resetRuntimeForTesting,Ie as activate,Qo as analyzeChangedScope,ve as appendAuditEntry,Pr as appendSessionLineageLabel,fm as applyFanoutBranchTransition,Qr as applySessionCompaction,jr as applyToolResultGuardrail,Wr as archiveOldIslands,mm as assignFanoutBranchWorker,ap as autoModeDenialShouldFallback,lp as bashSignalCollector,Uf as boundedRevise,hp as breakerShouldFallback,Vf as budgetCeiling,Jf as buildAmaControllerDecision,hf as buildCapabilityContextSections,Wm as buildClassifierPrompt,Hf as buildFallbackRoutingDecision,om as buildFanoutSchedulerPlan,qe as buildLlmReviewPrompt,nf as buildPromptMessageContent,Kf as buildPromptOverlay,gf as buildPromptSnapshot,Bf as buildProviderCapabilitySnapshot,If as buildProviderPolicyHintsForDecision,Cf as buildProviderPolicyPromptNotes,t as buildReasoningOverrideKey,Po as buildRepoIntelligenceContext,er as buildRepoIntelligenceIndex,Mo as buildRepoOverview,Ur as buildSessionTree,kf as buildSystemPrompt,jf as buildSystemPromptSnapshot,kp as checkAbsoluteDeny,lf as checkIncompleteToolCalls,Mf as checkPromiseSignal,Ym as classify,Lm as classifyBashCommand,S as classifyError,wf as classifyResilienceError,io as cleanupIncompleteToolCalls,b as clearReasoningOverride,K as clearRuntimeModelProviders,qp as collectAllSignals,Nm as computeInputSignature,Zm as computeRulesFingerprint,Ee as configureRuntime,qr as convertCapabilityReadResult,nr as convertProviderSearchResults,em as countActiveFanoutBranches,Vr as countActiveLineageMessages,ro as countTokens,eo as createAgent,pp as createAutoModeDenialTracker,wp as createAutoModeToolGuardrail,Km as createBashClassifierConfig,Ap as createBashPrefixExtractor,Ze as createBuiltinToolDefinition,dp as createCircuitBreaker,je as createCtxProxy,z as createCustomProvider,Qf as createDefaultCodingAgent,Mm as createDenialTracker,_r as createExtensionRuntime,$f as createFanoutSchedulerInput,fo as createHandoff,mo as createInMemorySession,Em as createKodaXTaskRunner,sm as createMcpCapabilityId,ym as createMcpTransport,bf as createPromptSection,Lf as createReasoningPlan,Sf as createSessionControl,Kr as createSessionLineage,am as createToolResultTruncationGuardrail,qm as defaultMcpCacheDir,ee as defaultPolicy,De as disableSelfModify,ie as drainPendingSwaps,im as emitContract,jm as emitHandoff,hm as emitScoutVerdict,km as emitVerdict,oo as estimateTokens,Df as evaluateProviderPolicy,Dr as exec,tf as executeTool,Xr as extractArtifactLedger,zp as extractCommandPrefix,sf as extractComparableUserMessageText,lr as extractHtmlTitle,qf as extractPromptComparableText,Jr as extractTitleFromMessages,np as fileSignalCollector,ur as finalizeRetrievalResult,Oe as findByVersion,Rr as findPreviousUserEntryId,Tr as forkSessionLineage,Cr as formatAgentsForPrompt,Gm as formatParallelDispatchResult,vo as formatSize,Ir as generateSessionId,ce as generatorAgent,Um as generatorCodingAgent,oe as getActiveExtensionRuntime,bo as getAgentConfigHome,co as getAgentConfigPath,$e as getAllRegisteredTools,go as getAppDataDir,N as getAvailableProviderNames,Ye as getBuiltinRegisteredToolDefinition,Xe as getBuiltinToolDefinition,B as getCustomProvider,E as getCustomProviderList,F as getCustomProviderModels,D as getCustomProviderNames,Qm as getDenialContext,rm as getFanoutBranch,xr as getImpactEstimate,Ar as getKodaxGlobalDir,wm as getMcpCachePaths,mr as getModuleContext,tr as getProcessContext,k as getProvider,s as getProviderConfiguredCapabilityProfile,q as getProviderConfiguredReasoningCapability,u as getProviderList,n as getProviderModel,v as getProviderModels,Ve as getRegisteredToolDefinition,fr as getRepoIntelligenceIndex,No as getRepoOverview,ar as getRepoRoutingSignals,ff as getRequiredToolParams,H as getRuntimeModelProvider,J as getRuntimeModelProviderNames,Lr as getSessionLineagePath,Mr as getSessionMessagesFromLineage,pr as getSymbolContext,Te as getTool,Ue as getToolDefinition,We as getToolRegistrations,ir as getToolResultPolicy,he as hasPendingSwap,Gf as inferTaskType,Fo as inspectEditFailure,or as inspectRepoIntelligenceRuntime,C as isCustomProviderName,Pm as isDeniedRecently,M as isKnownProvider,Fm as isParallelDispatchDirective,l as isProviderConfigured,w as isProviderName,I as isRuntimeModelProviderName,rf as isToolFileMutation,ef as isToolMutation,of as isToolPlanModeAllowed,Pe as listAll,Le as listArtifacts,_e as listBuiltinToolDefinitions,Ne as listConstructed,pf as listToolDefinitions,mf as listTools,Br as loadAgentsFiles,rp as loadAutoRules,ke as loadHandler,x as loadReasoningOverride,tm as markFanoutBranchCancelled,pm as markFanoutBranchCompleted,Yr as mergeArtifactLedger,cf as orderPromptSections,op as parseAutoRules,Xm as parseClassifierOutput,Eo as parseEditToolError,se as parseLlmReviewVerdict,um as parseMcpCapabilityId,ip as parseModelSpec,Ao as persistToolOutput,be as plannerAgent,Tm as plannerCodingAgent,br as prewarmRepoIntelligenceCaches,Me as readArtifact,we as readAuditEntries,ze as readBudget,Ce as readDisableState,up as readSpeculativeWindowFromEnv,_m as readTrustState,m as reasoningCapabilityToOverride,Ff as reasoningModeToDepth,p as reasoningOverrideToCapability,zf as reconstructMessagesWithToolGuard,xp as recordAutoModeAllow,tp as recordAutoModeBlock,gp as recordBreakerError,Om as recordDenial,Zf as registerCodingInvariants,Bm as registerConfiguredMcpCapabilityProvider,A as registerCustomProviders,G as registerModelProvider,Cm as registerOfficialSandboxExtension,to as registerPresetDispatcher,Se as registerTool,Je as rehydrateActiveArtifacts,Ae as remainingSelfModifyBudget,Ro as renderChangedScope,Yo as renderImpactEstimate,Vo as renderModuleContext,Xo as renderProcessContext,df as renderPromptSections,Oo as renderRepoOverview,sr as renderRetrievalResult,Wo as renderSymbolContext,Be as resetBudget,jp as resolveClassifierModel,ge as resolveConstructedAgent,L as resolveProvider,Ef as resolveReasoningMode,$o as resolveRepoIntelligenceMode,_o as resolveRepoIntelligenceRuntimeConfig,vf as resolveResilienceConfig,Nr as resolveSessionLineageTarget,Wf as resolveToolCapability,Ke as revoke,Sr as rewindSessionLineage,Qe as rollbackSelfModify,le as runAstRules,Rf as runKodaX,ue as runLlmReview,nm as runManagedTask,Dm as runOrchestration,a as saveReasoningOverride,ae as scoutAgent,Sm as scoutCodingAgent,vm as searchMcpCatalog,$r as setActiveExtensionRuntime,ao as setAgentConfigHome,Or as setSessionLineageActiveEntry,vp as speculativeRace,Ge as stage,Tf as startKodaX,ep as stripAssistantText,kr as stripHtmlToText,He as testArtifact,Lo as toolAskUserQuestion,Ho as toolBash,Uo as toolChangedDiff,To as toolChangedScope,yr as toolCodeSearch,Do as toolEdit,Io as toolGlob,Jo as toolGrep,hr as toolImpactEstimate,Go as toolInsertAfterAnchor,cr as toolModuleContext,Xf as toolPermission,gr as toolProcessContext,Bo as toolRead,So as toolRepoOverview,zr as toolSemanticLookup,dr as toolSymbolContext,Ko as toolUndo,wr as toolWebFetch,vr as toolWebSearch,Co as toolWrite,wo as truncateHead,zo as truncateLine,yo as truncateTail,$m as trustProjectRules,ho as validateAndFixToolHistory,y as validateCustomProviderConfig,Hm as validateSubtaskIndependence,ne as validateToolSchemaForProvider,rr as warmRepoIntelligenceRuntime,Er as webhook};
package/dist/sdk-llm.d.ts CHANGED
@@ -1,15 +1,215 @@
1
+ import { q as KodaXProviderCapabilityProfile, m as KodaXMessage, F as KodaXReasoningRequest, W as KodaXTokenUsage, g as KodaXContentBlock, f as KodaXCacheBoundary } from './types-chunks/types.d-B1uGoVTE.js';
2
+ export { K as KodaXAmaControllerDecision, a as KodaXAmaFanoutClass, b as KodaXAmaFanoutPolicy, c as KodaXAmaProfile, d as KodaXAmaTactic, e as KodaXAssuranceIntent, h as KodaXCustomProviderConfig, i as KodaXExecutionMode, j as KodaXExecutionPattern, k as KodaXHarnessProfile, l as KodaXImageBlock, n as KodaXModelDescriptor, o as KodaXMutationSurface, p as KodaXProtocolFamily, r as KodaXProviderConfig, s as KodaXProviderContextFidelity, t as KodaXProviderConversationSemantics, u as KodaXProviderEvidenceSupport, v as KodaXProviderLongRunningSupport, w as KodaXProviderMcpSupport, x as KodaXProviderMultimodalSupport, y as KodaXProviderSessionSupport, z as KodaXProviderStreamOptions, A as KodaXProviderToolCallingFidelity, B as KodaXProviderTransport, C as KodaXReasoningCapability, D as KodaXReasoningMode, E as KodaXReasoningOverride, G as KodaXRedactedThinkingBlock, H as KodaXReviewScale, I as KodaXRiskLevel, J as KodaXStreamResult, L as KodaXTaskActionability, M as KodaXTaskBudgetOverrides, N as KodaXTaskComplexity, O as KodaXTaskFamily, P as KodaXTaskRoutingDecision, Q as KodaXTaskType, R as KodaXTaskWorkIntent, S as KodaXTextBlock, T as KodaXThinkingBlock, U as KodaXThinkingBudgetMap, V as KodaXThinkingDepth, X as KodaXToolDefinition, Y as KodaXToolResultBlock, Z as KodaXToolResultContentItem, _ as KodaXToolResultImageItem, $ as KodaXToolResultTextItem, a0 as KodaXToolUseBlock } from './types-chunks/types.d-B1uGoVTE.js';
3
+ export { K as KODAX_DEFAULT_PROVIDER, a as KODAX_DEFAULT_THINKING_BUDGETS, b as KODAX_PROVIDERS, c as KODAX_PROVIDER_SNAPSHOTS, d as KODAX_REASONING_MODE_SEQUENCE, e as KODAX_REASONING_SAFETY_RESERVE, f as KodaXAnthropicCompatProvider, g as KodaXError, h as KodaXNetworkError, i as KodaXOpenAICompatProvider, j as KodaXProviderError, k as KodaXRateLimitError, l as KodaXToolCallIdError, P as ProviderName, m as buildReasoningOverrideKey, n as clampThinkingBudget, o as clearReasoningOverride, p as clearRuntimeModelProviders, q as createCustomProvider, r as getAvailableProviderNames, s as getCustomProvider, t as getCustomProviderList, u as getCustomProviderModels, v as getCustomProviderNames, w as getDefaultThinkingDepthForMode, x as getProvider, y as getProviderConfiguredCapabilityProfile, z as getProviderConfiguredReasoningCapability, A as getProviderList, B as getProviderModel, C as getProviderModels, D as getReasoningCapability, E as getRuntimeModelProvider, F as getRuntimeModelProviderNames, G as isCustomProviderName, H as isKnownProvider, I as isProviderConfigured, J as isProviderName, L as isReasoningEnabled, M as isRuntimeModelProviderName, N as loadReasoningOverride, O as mapDepthToOpenAIReasoningEffort, Q as normalizeReasoningRequest, R as reasoningCapabilityToOverride, S as reasoningOverrideToCapability, T as registerCustomProviders, U as registerModelProvider, V as resolveProvider, W as resolveThinkingBudget, X as saveReasoningOverride, Y as validateCustomProviderConfig } from './types-chunks/resolver.d-DX9au4NJ.js';
4
+ import { K as KodaXBaseProvider, a as CostTracker } from './types-chunks/cost-tracker.d-B6vMoLLF.js';
5
+ export { C as CostRate, D as DEFAULT_COST_RATES, b as KodaXOnRetryAfterCallback, c as KodaXRetryAfterEvent, P as ParseRetryAfterOptions, d as ProviderCostSummary, R as RetryAfterResult, e as RetryAfterSource, f as RetryRecord, S as SessionCostSummary, T as TokenUsageRecord, g as calculateCost, h as createCostTracker, i as extractHeadersFromError, j as formatCost, k as formatCostReport, l as getCostRate, m as getSummary, p as parseRetryAfter, r as recordRetry, n as recordUsage } from './types-chunks/cost-tracker.d-B6vMoLLF.js';
6
+ export { C as CapabilityKind, a as CapabilityProvider, b as CapabilityResult } from './types-chunks/capability.d-3C62G8Eq.js';
7
+ import '@anthropic-ai/sdk';
8
+ import 'openai';
9
+
1
10
  /**
2
- * SDK subpath entry — `@kodax-ai/kodax/llm`
11
+ * KodaX AI Constants
3
12
  *
4
- * Re-exports the entire `@kodax-ai/llm` public API — LLM provider
5
- * abstraction layer covering 12 providers (Anthropic / OpenAI / DeepSeek /
6
- * Kimi / Qwen / Zhipu / MiniMax / MiMo / Gemini / Codex / etc.).
13
+ * AI 层常量配置 - Provider 模块共享的常量
14
+ */
15
+ declare const KODAX_MAX_TOKENS = 32768;
16
+ /**
17
+ * Capped default output token budget for long-output-prone providers
18
+ * (e.g. zhipu-coding). Providers using this value request a modest budget
19
+ * on every turn so generation finishes well under server-side kill
20
+ * windows (Zhipu reportedly terminates streams around 8 minutes). If
21
+ * the model hits `stop_reason: max_tokens` at this cap, the agent loop
22
+ * escalates the same turn once to `KODAX_ESCALATED_MAX_OUTPUT_TOKENS`
23
+ * (see `coding/src/agent.ts` max_tokens handler).
24
+ */
25
+ declare const KODAX_CAPPED_MAX_OUTPUT_TOKENS = 32000;
26
+ /**
27
+ * One-shot escalated budget used by the agent loop when a capped turn
28
+ * returns `stop_reason: max_tokens`. The next stream call in the same
29
+ * logical turn is issued with this value. Set once per turn via the
30
+ * provider's public `setMaxOutputTokensOverride`; auto-cleared on the
31
+ * next successful response in `base.ts withRateLimit`.
32
+ */
33
+ declare const KODAX_ESCALATED_MAX_OUTPUT_TOKENS = 64000;
34
+ declare const KODAX_API_MIN_INTERVAL = 0.5;
35
+
36
+ interface NormalizedKodaXProviderCapabilityProfile extends KodaXProviderCapabilityProfile {
37
+ contextFidelity: NonNullable<KodaXProviderCapabilityProfile['contextFidelity']>;
38
+ toolCallingFidelity: NonNullable<KodaXProviderCapabilityProfile['toolCallingFidelity']>;
39
+ sessionSupport: NonNullable<KodaXProviderCapabilityProfile['sessionSupport']>;
40
+ longRunningSupport: NonNullable<KodaXProviderCapabilityProfile['longRunningSupport']>;
41
+ multimodalSupport: NonNullable<KodaXProviderCapabilityProfile['multimodalSupport']>;
42
+ evidenceSupport: NonNullable<KodaXProviderCapabilityProfile['evidenceSupport']>;
43
+ }
44
+ declare function normalizeCapabilityProfile(profile: KodaXProviderCapabilityProfile): NormalizedKodaXProviderCapabilityProfile;
45
+
46
+ declare function getCodexCliDefaultModel(): string;
47
+ declare function getGeminiCliDefaultModel(): string;
48
+ declare function getCodexCliKnownModels(): string[];
49
+ declare function getGeminiCliKnownModels(): string[];
50
+
51
+ /**
52
+ * Shared parser for streamed tool_use input across all provider transports.
53
+ *
54
+ * Why this exists: when a provider hits `stop_reason: max_tokens`
55
+ * (Anthropic) or `finish_reason: length` (OpenAI-compat) during a
56
+ * tool_use turn, the accumulated `arguments` / `input_json_delta`
57
+ * buffer is truncated mid-JSON. Two compat paths previously diverged:
58
+ *
59
+ * - anthropic.ts: strict → partial-json salvage → {}
60
+ * - openai.ts: strict → {} (lost the partial work)
7
61
  *
8
- * Usage:
9
- * ```ts
10
- * import { createProvider, resolveProvider } from '@kodax-ai/kodax/llm';
11
- * ```
62
+ * Centralising in one helper means the OpenAI path (deepseek-v4,
63
+ * pay-as-you-go kimi/qwen/zhipu, plus any custom provider extending
64
+ * KodaXOpenAICompatProvider) gets the same recovery as Anthropic-compat.
65
+ *
66
+ * Salvage strategy verified by deepseek-v4 bench (flash + pro, 6
67
+ * truncation runs at 800-8000 max_tokens): all real-world truncations
68
+ * land mid-string in the largest field with clean byte boundaries (no
69
+ * mid-multibyte, no mid-`\uXXXX` escape, no lone backslash). partial-json
70
+ * recovers a usable Record in 100% of observed cases.
71
+ */
72
+ /**
73
+ * Parse a tool_use input buffer with three-stage recovery.
74
+ *
75
+ * Stages:
76
+ * 1. strict `JSON.parse` — fast path for the 99% complete case.
77
+ * 2. `partial-json` salvage — closes open strings/brackets and
78
+ * returns whatever prefix was parseable. Lets the agent loop
79
+ * surface concrete partial work (e.g. half a `write` payload)
80
+ * to the model on the next turn instead of pretending the call
81
+ * had no input.
82
+ * 3. empty `{}` — last-resort fallback for total garbage.
83
+ *
84
+ * Always returns a plain object so the caller can construct a valid
85
+ * `KodaXToolUseBlock` without further type guards.
86
+ */
87
+ declare function parseToolInputWithSalvage(raw: string | undefined | null): Record<string, unknown>;
88
+
89
+ /**
90
+ * sideQuery — independent one-shot LLM invocation.
91
+ *
92
+ * Used by features that need a clean LLM call outside the main agent loop.
93
+ * The auto mode classifier (FEATURE_092) is the first consumer; future
94
+ * users include compaction, title generation, and SA mutation reflection.
95
+ *
96
+ * Constraints (deliberate):
97
+ * - tools=[] hardcoded — sideQuery is single-turn, no tool loop
98
+ * - text-only output — tool_use blocks from the model produce stopReason='error'
99
+ * - independent timeout (default 30s; classifier overrides to ~8s)
100
+ * - independent cost bucket via querySource (mapped to TokenUsageRecord.role)
101
+ *
102
+ * Failure handling: never throws. Timeout, abort, provider error, and
103
+ * unexpected tool_use all produce a result with stopReason='timeout' /
104
+ * 'aborted' / 'error' so callers implement their own degradation.
105
+ */
106
+
107
+ type SideQueryStopReason = 'end_turn' | 'max_tokens' | 'timeout' | 'aborted' | 'error';
108
+ interface SideQueryRequest {
109
+ readonly provider: KodaXBaseProvider;
110
+ readonly model: string;
111
+ readonly system: string;
112
+ readonly messages: readonly KodaXMessage[];
113
+ readonly reasoning?: KodaXReasoningRequest;
114
+ readonly timeoutMs?: number;
115
+ readonly abortSignal?: AbortSignal;
116
+ readonly querySource: string;
117
+ readonly costTracker?: CostTracker;
118
+ }
119
+ interface SideQueryResult {
120
+ readonly text: string;
121
+ readonly usage: KodaXTokenUsage;
122
+ readonly costTracker?: CostTracker;
123
+ readonly stopReason: SideQueryStopReason;
124
+ readonly error?: Error;
125
+ }
126
+ declare function sideQuery(req: SideQueryRequest): Promise<SideQueryResult>;
127
+
128
+ /**
129
+ * KodaX Cache Control — FEATURE_116 (v0.7.37)
130
+ *
131
+ * Helpers for inserting and lowering `KodaXCacheBoundary` markers across
132
+ * the prompt assembly path. The two halves of the contract:
133
+ *
134
+ * producer side — `insertCacheBoundary(blocks, hint)` appends a
135
+ * boundary to the end of any stable prefix (system
136
+ * prompt blocks, role prompt blocks, …).
137
+ * consumer side — `lowerCacheBoundaries(blocks, mode)` is called by
138
+ * a provider base class right before serialisation:
139
+ * - `attach`: write `cache_control` onto the block
140
+ * immediately before each boundary, then drop the
141
+ * boundaries (Anthropic-compat path).
142
+ * - `strip`: drop the boundaries with no further
143
+ * action (OpenAI-compat / ACP CLI bridge path).
144
+ *
145
+ * The boundary marker is purely client-side and MUST be removed before
146
+ * a request is sent over the wire. Provider subclasses do nothing —
147
+ * lowering happens once per base class in `KodaXAnthropicCompatProvider`,
148
+ * `KodaXOpenAICompatProvider`, and `KodaXAcpProvider`.
149
+ */
150
+
151
+ /**
152
+ * Block shape Anthropic accepts where a `cache_control` field can be
153
+ * legally attached. Used in `lowerCacheBoundaries` mode `'attach'` to
154
+ * mark the preceding block as a cache prefix.
155
+ */
156
+ interface KodaXAnthropicCacheableBlock {
157
+ type: string;
158
+ cache_control?: {
159
+ type: 'ephemeral';
160
+ };
161
+ [key: string]: unknown;
162
+ }
163
+ type KodaXCacheLowerMode = 'attach' | 'strip';
164
+ /**
165
+ * Append a cache-boundary marker to a block array. Idempotent: if the
166
+ * last block is already a boundary with the same hint, the array is
167
+ * returned unchanged (avoids accidental double-marking when the same
168
+ * stable prefix is composed twice).
169
+ */
170
+ declare function insertCacheBoundary<T extends KodaXContentBlock>(blocks: readonly T[], hint?: KodaXCacheBoundary['hint']): readonly (T | KodaXCacheBoundary)[];
171
+ /**
172
+ * Type-guard. Cheap to call repeatedly during lowering.
173
+ *
174
+ * Structural narrowing rather than just `type === 'cache-boundary'`:
175
+ * the block must carry no fields beyond `type` and the optional `hint`.
176
+ * This prevents an external wire payload that happens to carry
177
+ * `type: 'cache-boundary'` plus other fields (a coincidental name
178
+ * collision) from being silently stripped during lowering.
179
+ */
180
+ declare function isCacheBoundary(block: unknown): block is KodaXCacheBoundary;
181
+ /**
182
+ * Provider-base-class entry point. Walks the block array once.
183
+ *
184
+ * - `mode === 'attach'`: for each boundary, set
185
+ * `cache_control: { type: 'ephemeral' }` on the immediately preceding
186
+ * non-boundary block, then drop the boundary itself. If a boundary is
187
+ * the first block (no predecessor) it is silently dropped — there is
188
+ * nothing to attach to. If multiple boundaries land back-to-back, only
189
+ * the predecessor of the *first* one in the run is marked (the others
190
+ * collapse, since they would all attach to the same predecessor).
191
+ *
192
+ * - `mode === 'strip'`: drop every boundary. No `cache_control` is
193
+ * added. Used by adapters whose wire format does not expose a
194
+ * client-side cache marker (OpenAI-compat, ACP CLI bridge).
195
+ *
196
+ * Always returns a NEW array (never mutates input — the caller may hold
197
+ * references to the original payload for diagnostics).
198
+ */
199
+ declare function lowerCacheBoundaries<T extends KodaXAnthropicCacheableBlock>(blocks: readonly (T | KodaXCacheBoundary)[], mode: KodaXCacheLowerMode): T[];
200
+ /**
201
+ * Drop every cache boundary from a block array without attaching any
202
+ * cache marker. Convenience wrapper for `lowerCacheBoundaries(blocks, 'strip')`
203
+ * for callers that only need the strip behaviour.
12
204
  *
13
- * See docs/ADR.md ADR-024 for the SDK formalization decision.
205
+ * Generic bound is intentionally loose (`{ type: string }`) so the helper
206
+ * is callable both at the KodaX-internal level (KodaXContentBlock arrays)
207
+ * and at the provider-wire level (Anthropic-compat / OpenAI-compat block
208
+ * shapes that include extra wire fields).
14
209
  */
15
- export * from '@kodax-ai/llm';
210
+ declare function stripCacheBoundaries<T extends {
211
+ type: string;
212
+ }>(blocks: readonly (T | KodaXCacheBoundary)[]): T[];
213
+
214
+ export { CostTracker, KODAX_API_MIN_INTERVAL, KODAX_CAPPED_MAX_OUTPUT_TOKENS, KODAX_ESCALATED_MAX_OUTPUT_TOKENS, KODAX_MAX_TOKENS, KodaXBaseProvider, KodaXCacheBoundary, KodaXContentBlock, KodaXMessage, KodaXProviderCapabilityProfile, KodaXReasoningRequest, KodaXTokenUsage, getCodexCliDefaultModel, getCodexCliKnownModels, getGeminiCliDefaultModel, getGeminiCliKnownModels, insertCacheBoundary, isCacheBoundary, lowerCacheBoundaries, normalizeCapabilityProfile, parseToolInputWithSalvage, sideQuery, stripCacheBoundaries };
215
+ export type { KodaXAnthropicCacheableBlock, KodaXCacheLowerMode, SideQueryRequest, SideQueryResult, SideQueryStopReason };
package/dist/sdk-llm.js CHANGED
@@ -1,2 +1,2 @@
1
1
  // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- import{$,A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z,_,a as o,aa as oo,b as r,ba as ro,c as e,ca as eo,d as f,da as fo,e as m,ea as mo,f as p,fa as po,g as t,ga as to,h as x,ha as xo,i as a,ia as ao,j as b,ja as bo,k as c,ka as co,l as d,la as go,m as g,ma as ho,n as h,na as io,o as i,oa as jo,p as j,pa as ko,q as k,qa as lo,r as l,ra as no,s as n,sa as qo,t as q,ta as so,u as s,ua as uo,v as u,va as vo,w as v,x as w,y,z}from"./chunks/chunk-6QO6HWGU.js";import"./chunks/chunk-V4WSBIXB.js";export{ho as DEFAULT_COST_RATES,a as KODAX_API_MIN_INTERVAL,t as KODAX_CAPPED_MAX_OUTPUT_TOKENS,Q as KODAX_DEFAULT_PROVIDER,c as KODAX_DEFAULT_THINKING_BUDGETS,x as KODAX_ESCALATED_MAX_OUTPUT_TOKENS,p as KODAX_MAX_TOKENS,P as KODAX_PROVIDERS,O as KODAX_PROVIDER_SNAPSHOTS,b as KODAX_REASONING_MODE_SEQUENCE,d as KODAX_REASONING_SAFETY_RESERVE,I as KodaXAnthropicCompatProvider,C as KodaXBaseProvider,o as KodaXError,f as KodaXNetworkError,J as KodaXOpenAICompatProvider,r as KodaXProviderError,e as KodaXRateLimitError,m as KodaXToolCallIdError,u as buildReasoningOverrideKey,jo as calculateCost,l as clampThinkingBudget,y as clearReasoningOverride,ao as clearRuntimeModelProviders,ko as createCostTracker,Z as createCustomProvider,A as extractHeadersFromError,so as formatCost,uo as formatCostReport,go as getAvailableProviderNames,K as getCodexCliDefaultModel,M as getCodexCliKnownModels,io as getCostRate,$ as getCustomProvider,eo as getCustomProviderList,fo as getCustomProviderModels,ro as getCustomProviderNames,j as getDefaultThinkingDepthForMode,L as getGeminiCliDefaultModel,N as getGeminiCliKnownModels,R as getProvider,V as getProviderConfiguredCapabilityProfile,U as getProviderConfiguredReasoningCapability,W as getProviderList,T as getProviderModel,X as getProviderModels,g as getReasoningCapability,po as getRuntimeModelProvider,xo as getRuntimeModelProviderNames,qo as getSummary,E as insertCacheBoundary,F as isCacheBoundary,oo as isCustomProviderName,co as isKnownProvider,S as isProviderConfigured,Y as isProviderName,h as isReasoningEnabled,to as isRuntimeModelProviderName,v as loadReasoningOverride,G as lowerCacheBoundaries,n as mapDepthToOpenAIReasoningEffort,B as normalizeCapabilityProfile,i as normalizeReasoningRequest,z as parseRetryAfter,D as parseToolInputWithSalvage,q as reasoningCapabilityToOverride,s as reasoningOverrideToCapability,lo as recordRetry,no as recordUsage,_ as registerCustomProviders,mo as registerModelProvider,bo as resolveProvider,k as resolveThinkingBudget,w as saveReasoningOverride,vo as sideQuery,H as stripCacheBoundaries};
2
+ import{$,A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z,_,a as o,aa as oo,b as r,ba as ro,c as e,ca as eo,d as f,da as fo,e as m,ea as mo,f as p,fa as po,g as t,ga as to,h as x,ha as xo,i as a,ia as ao,j as b,ja as bo,k as c,ka as co,l as d,la as go,m as g,ma as ho,n as h,na as io,o as i,oa as jo,p as j,pa as ko,q as k,qa as lo,r as l,ra as no,s as n,sa as qo,t as q,ta as so,u as s,ua as uo,v as u,va as vo,w as v,wa as wo,x as w,y,z}from"./chunks/chunk-HMYEQJGT.js";import"./chunks/chunk-V4WSBIXB.js";export{io as DEFAULT_COST_RATES,a as KODAX_API_MIN_INTERVAL,t as KODAX_CAPPED_MAX_OUTPUT_TOKENS,Q as KODAX_DEFAULT_PROVIDER,c as KODAX_DEFAULT_THINKING_BUDGETS,x as KODAX_ESCALATED_MAX_OUTPUT_TOKENS,p as KODAX_MAX_TOKENS,P as KODAX_PROVIDERS,O as KODAX_PROVIDER_SNAPSHOTS,b as KODAX_REASONING_MODE_SEQUENCE,d as KODAX_REASONING_SAFETY_RESERVE,I as KodaXAnthropicCompatProvider,C as KodaXBaseProvider,o as KodaXError,f as KodaXNetworkError,J as KodaXOpenAICompatProvider,r as KodaXProviderError,e as KodaXRateLimitError,m as KodaXToolCallIdError,u as buildReasoningOverrideKey,ko as calculateCost,l as clampThinkingBudget,y as clearReasoningOverride,bo as clearRuntimeModelProviders,lo as createCostTracker,_ as createCustomProvider,A as extractHeadersFromError,uo as formatCost,vo as formatCostReport,ho as getAvailableProviderNames,K as getCodexCliDefaultModel,M as getCodexCliKnownModels,jo as getCostRate,oo as getCustomProvider,fo as getCustomProviderList,mo as getCustomProviderModels,eo as getCustomProviderNames,j as getDefaultThinkingDepthForMode,L as getGeminiCliDefaultModel,N as getGeminiCliKnownModels,R as getProvider,V as getProviderConfiguredCapabilityProfile,U as getProviderConfiguredReasoningCapability,W as getProviderList,T as getProviderModel,X as getProviderModels,g as getReasoningCapability,to as getRuntimeModelProvider,ao as getRuntimeModelProviderNames,so as getSummary,E as insertCacheBoundary,F as isCacheBoundary,ro as isCustomProviderName,go as isKnownProvider,S as isProviderConfigured,Y as isProviderName,h as isReasoningEnabled,xo as isRuntimeModelProviderName,v as loadReasoningOverride,G as lowerCacheBoundaries,n as mapDepthToOpenAIReasoningEffort,B as normalizeCapabilityProfile,i as normalizeReasoningRequest,z as parseRetryAfter,D as parseToolInputWithSalvage,q as reasoningCapabilityToOverride,s as reasoningOverrideToCapability,no as recordRetry,qo as recordUsage,$ as registerCustomProviders,po as registerModelProvider,co as resolveProvider,k as resolveThinkingBudget,w as saveReasoningOverride,wo as sideQuery,H as stripCacheBoundaries,Z as validateCustomProviderConfig};
@@ -0,0 +1,17 @@
1
+ import { b as McpServersConfig } from './types-chunks/config.d-BfJUXxC0.js';
2
+ export { M as McpConnectMode, a as McpServerConfig, c as McpTransportKind } from './types-chunks/config.d-BfJUXxC0.js';
3
+ export { M as McpCapabilityDescriptor, a as McpCapabilityKind, b as McpCapabilityProvider, c as McpCapabilityRisk, d as McpCatalogItem, e as McpProviderOptions, f as McpServerCatalogSnapshot, g as McpServerRuntime, h as McpServerRuntimeDiagnostics, i as McpTransport, j as McpTransportEvents, k as createMcpCapabilityId, l as createMcpTransport, m as defaultMcpCacheDir, n as getMcpCachePaths, p as parseMcpCapabilityId, s as searchMcpCatalog } from './types-chunks/transport.d-DuyjG30t.js';
4
+ import './types-chunks/capability.d-3C62G8Eq.js';
5
+
6
+ interface McpTestServerFixture {
7
+ cacheDir: string;
8
+ servers: McpServersConfig;
9
+ promptId: string;
10
+ resourceId: string;
11
+ scriptPath: string;
12
+ serverId: string;
13
+ toolId: string;
14
+ }
15
+ declare function createMcpTestServerFixture(tempDir: string): Promise<McpTestServerFixture>;
16
+
17
+ export { McpServersConfig, createMcpTestServerFixture };
@@ -0,0 +1,2 @@
1
+ // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
+ import{d as o,e as r,f as e,g as f,h as m,i as p,j as t,k as x,l as a}from"./chunks/chunk-DKXUY5F2.js";import"./chunks/chunk-3RKBXWZS.js";import"./chunks/chunk-V4WSBIXB.js";export{x as McpCapabilityProvider,t as McpServerRuntime,r as createMcpCapabilityId,a as createMcpTestServerFixture,p as createMcpTransport,o as defaultMcpCacheDir,m as getMcpCachePaths,e as parseMcpCapabilityId,f as searchMcpCatalog};