kagent-ts 0.1.0

package/dist/core/response-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-schema.js","sourceRoot":"","sources":["../../src/core/response-schema.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAuCH,gDAwBC;AAiMD,wDAwCC;AA7QD,2EAA2E;AAE3E;;;;;;;;;GASG;AACH,SAAgB,kBAAkB,CAAC,GAAW;IAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAE9B,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEhC,4CAA4C;YAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBAE7C,IAAI,QAAQ,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;oBAChF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpD,CAAC;gBAED,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,iDAAiD;IACjD,MAAM,QAAQ,GAAG;QACf,IAAI,CAAC,IAAI,EAAE;QACX,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;KACnD,CAAC;IAEF,wBAAwB;IACxB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3C,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,mCAAmC;IACnC,IAAI,WAAW,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,+DAA+D;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAC3B,qCAAqC,CACtC,CAAC;IACF,IAAI,UAAU,IAAI,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IAEnE,wDAAwD;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAAC,IAAY;IACzC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,GAAG,KAAK,CAAC;YACrB,CAAC;iBAAM,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACvB,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;iBAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACtB,QAAQ,GAAG,KAAK,CAAC;YACnB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,QAAQ,GAAG,IAAI,CAAC;gBAChB,UAAU,GAAG,KAAK,CAAC;YACrB,CAAC;iBAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACtB,KAAK,EAAE,CAAC;YACV,CAAC;iBAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACtB,KAAK,EAAE,CAAC;gBACR,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;oBAChB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;oBACvC,IAAI,WAAW,CAAC,SAAS,CAAC;wBAAE,OAAO,SAAS,CAAC;oBAC7C,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,MAAM,GAAG,IAAI,CAAC;IAElB,6DAA6D;IAC7D,+BAA+B;IAC/B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAE1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,2EAA2E;AAE3E;;;GAGG;AACU,QAAA,8BAA8B,GAAG;;;;;;;;;;;;;;;iIAemF,CAAC;AAElI;;;GAGG;AACU,QAAA,0BAA0B,GACrC,yHAAyH,CAAC;AA8B5H;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,GAAW;IAChD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAE9B,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEhC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBAC7C,MAAM,MAAM,GAAsB,EAAE,OAAO,EAAE,CAAC;gBAE9C,0BAA0B;gBAC1B,IAAI,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC9C,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACxC,CAAC;gBAED,kCAAkC;gBAClC,IAAI,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC9D,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACxD,CAAC;gBAED,0BAA0B;gBAC1B,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;oBAC1D,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACxC,CAAC;gBAED,kDAAkD;gBAClD,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC;oBACtE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBACtD,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;;;;GAQG;AACU,QAAA,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wEAkDiC,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-export Tool from the tools module.
+ * It now lives in src/tools/types.ts alongside the circuit breaker system.
+ */
+export type { Tool } from "../tools/types";
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/core/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+export { Agent } from "./core/agent";
+export type { AgentConfig } from "./core/agent";
+export { ReActAgent } from "./core/react-agent";
+export type { ReActAgentConfig } from "./core/react-agent";
+export { PlanSolveAgent } from "./core/plan-solve-agent";
+export type { PlanSolveAgentConfig } from "./core/plan-solve-agent";
+export type { Tool } from "./core/types";
+export type { AgentHooks } from "./core/hooks";
+export { parseReActResponse, STRUCTURED_OUTPUT_INSTRUCTIONS, parsePlanSolveResponse, PLAN_SOLVE_INSTRUCTIONS, } from "./core/response-schema";
+export type { ReActResponse, ReActReasoning, ReActFinalAnswer, PlanSolveResponse, } from "./core/response-schema";
+export { ToolRegistry } from "./tools/tool-registry";
+export { CircuitBreaker } from "./tools/circuit-breaker";
+export type { CircuitBreakerConfig } from "./tools/circuit-breaker";
+export { BreakerState } from "./tools/types";
+export type { BreakerStatus } from "./tools/types";
+export { ToolErrorTracker, categorizeError } from "./tools/error-tracker";
+export type { ErrorTrackerConfig } from "./tools/error-tracker";
+export type { ToolErrorTrace, TraceEvent, ErrorTraceSummary } from "./tools/types";
+export { BUILTIN_TOOLS, registerAllBuiltinTools, ReadFileTool, WriteFileTool, EditFileTool, GrepSearchTool, GlobSearchTool, } from "./tools/builtin/index";
+export { SkillManager, FileSkillLoader, parseFrontmatter, parseKeywords } from "./skills/index";
+export type { Skill, SkillStatus } from "./skills/types";
+export { Message } from "./messages/message";
+export { Role } from "./messages/types";
+export type { MessageData, ToolCall } from "./messages/types";
+export type { LLMProvider, LLMResponse } from "./llm/interface";
+export { OpenAIProvider, LLMNetworkError, isNetworkError } from "./llm/openai-provider";
+export type { OpenAIConfig, OpenAIRetryConfig, NetworkErrorCause } from "./llm/openai-provider";
+export { ContextManager } from "./context/context-manager";
+export type { ContextConfig, ContextState } from "./context/types";
+export type { CompressionStrategy, CompressionResult } from "./compression/interface";
+export { SlidingWindowCompression } from "./compression/sliding-window";
+export type { CompressionConfig } from "./compression/types";
+export { PreferenceManager } from "./preferences/preference-manager";
+export type { Preferences, PreferenceManagerConfig } from "./preferences/types";
+export { SessionManager } from "./session/session-manager";
+export type { SessionManagerConfig } from "./session/session-manager";
+export type { SessionState, SessionStatus, AgentType, PlanSolveSessionState, } from "./session/session-types";
+export { countTokens, countMessageTokens } from "./utils/token-counter";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,YAAY,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EACL,kBAAkB,EAClB,8BAA8B,EAC9B,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGnF,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChG,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGzD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG9D,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACxF,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAIhG,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGnE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAGhF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,YAAY,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countMessageTokens = exports.countTokens = exports.SessionManager = exports.PreferenceManager = exports.SlidingWindowCompression = exports.ContextManager = exports.isNetworkError = exports.LLMNetworkError = exports.OpenAIProvider = exports.Role = exports.Message = exports.parseKeywords = exports.parseFrontmatter = exports.FileSkillLoader = exports.SkillManager = exports.GlobSearchTool = exports.GrepSearchTool = exports.EditFileTool = exports.WriteFileTool = exports.ReadFileTool = exports.registerAllBuiltinTools = exports.BUILTIN_TOOLS = exports.categorizeError = exports.ToolErrorTracker = exports.BreakerState = exports.CircuitBreaker = exports.ToolRegistry = exports.PLAN_SOLVE_INSTRUCTIONS = exports.parsePlanSolveResponse = exports.STRUCTURED_OUTPUT_INSTRUCTIONS = exports.parseReActResponse = exports.PlanSolveAgent = exports.ReActAgent = exports.Agent = void 0;
+// Core Agent
+var agent_1 = require("./core/agent");
+Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return agent_1.Agent; } });
+var react_agent_1 = require("./core/react-agent");
+Object.defineProperty(exports, "ReActAgent", { enumerable: true, get: function () { return react_agent_1.ReActAgent; } });
+var plan_solve_agent_1 = require("./core/plan-solve-agent");
+Object.defineProperty(exports, "PlanSolveAgent", { enumerable: true, get: function () { return plan_solve_agent_1.PlanSolveAgent; } });
+// Response schema — structured JSON output from LLM
+var response_schema_1 = require("./core/response-schema");
+Object.defineProperty(exports, "parseReActResponse", { enumerable: true, get: function () { return response_schema_1.parseReActResponse; } });
+Object.defineProperty(exports, "STRUCTURED_OUTPUT_INSTRUCTIONS", { enumerable: true, get: function () { return response_schema_1.STRUCTURED_OUTPUT_INSTRUCTIONS; } });
+Object.defineProperty(exports, "parsePlanSolveResponse", { enumerable: true, get: function () { return response_schema_1.parsePlanSolveResponse; } });
+Object.defineProperty(exports, "PLAN_SOLVE_INSTRUCTIONS", { enumerable: true, get: function () { return response_schema_1.PLAN_SOLVE_INSTRUCTIONS; } });
+// Tools — circuit breaker & registry
+var tool_registry_1 = require("./tools/tool-registry");
+Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return tool_registry_1.ToolRegistry; } });
+var circuit_breaker_1 = require("./tools/circuit-breaker");
+Object.defineProperty(exports, "CircuitBreaker", { enumerable: true, get: function () { return circuit_breaker_1.CircuitBreaker; } });
+var types_1 = require("./tools/types");
+Object.defineProperty(exports, "BreakerState", { enumerable: true, get: function () { return types_1.BreakerState; } });
+// Tool error tracker — observability for tool failure chains
+var error_tracker_1 = require("./tools/error-tracker");
+Object.defineProperty(exports, "ToolErrorTracker", { enumerable: true, get: function () { return error_tracker_1.ToolErrorTracker; } });
+Object.defineProperty(exports, "categorizeError", { enumerable: true, get: function () { return error_tracker_1.categorizeError; } });
+// Built-in file tools
+var index_1 = require("./tools/builtin/index");
+Object.defineProperty(exports, "BUILTIN_TOOLS", { enumerable: true, get: function () { return index_1.BUILTIN_TOOLS; } });
+Object.defineProperty(exports, "registerAllBuiltinTools", { enumerable: true, get: function () { return index_1.registerAllBuiltinTools; } });
+Object.defineProperty(exports, "ReadFileTool", { enumerable: true, get: function () { return index_1.ReadFileTool; } });
+Object.defineProperty(exports, "WriteFileTool", { enumerable: true, get: function () { return index_1.WriteFileTool; } });
+Object.defineProperty(exports, "EditFileTool", { enumerable: true, get: function () { return index_1.EditFileTool; } });
+Object.defineProperty(exports, "GrepSearchTool", { enumerable: true, get: function () { return index_1.GrepSearchTool; } });
+Object.defineProperty(exports, "GlobSearchTool", { enumerable: true, get: function () { return index_1.GlobSearchTool; } });
+// Skills — progressive disclosure
+var index_2 = require("./skills/index");
+Object.defineProperty(exports, "SkillManager", { enumerable: true, get: function () { return index_2.SkillManager; } });
+Object.defineProperty(exports, "FileSkillLoader", { enumerable: true, get: function () { return index_2.FileSkillLoader; } });
+Object.defineProperty(exports, "parseFrontmatter", { enumerable: true, get: function () { return index_2.parseFrontmatter; } });
+Object.defineProperty(exports, "parseKeywords", { enumerable: true, get: function () { return index_2.parseKeywords; } });
+// Messages
+var message_1 = require("./messages/message");
+Object.defineProperty(exports, "Message", { enumerable: true, get: function () { return message_1.Message; } });
+var types_2 = require("./messages/types");
+Object.defineProperty(exports, "Role", { enumerable: true, get: function () { return types_2.Role; } });
+var openai_provider_1 = require("./llm/openai-provider");
+Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: function () { return openai_provider_1.OpenAIProvider; } });
+Object.defineProperty(exports, "LLMNetworkError", { enumerable: true, get: function () { return openai_provider_1.LLMNetworkError; } });
+Object.defineProperty(exports, "isNetworkError", { enumerable: true, get: function () { return openai_provider_1.isNetworkError; } });
+// Context
+var context_manager_1 = require("./context/context-manager");
+Object.defineProperty(exports, "ContextManager", { enumerable: true, get: function () { return context_manager_1.ContextManager; } });
+var sliding_window_1 = require("./compression/sliding-window");
+Object.defineProperty(exports, "SlidingWindowCompression", { enumerable: true, get: function () { return sliding_window_1.SlidingWindowCompression; } });
+// User preferences
+var preference_manager_1 = require("./preferences/preference-manager");
+Object.defineProperty(exports, "PreferenceManager", { enumerable: true, get: function () { return preference_manager_1.PreferenceManager; } });
+// Session persistence & network resilience
+var session_manager_1 = require("./session/session-manager");
+Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return session_manager_1.SessionManager; } });
+// Utils
+var token_counter_1 = require("./utils/token-counter");
+Object.defineProperty(exports, "countTokens", { enumerable: true, get: function () { return token_counter_1.countTokens; } });
+Object.defineProperty(exports, "countMessageTokens", { enumerable: true, get: function () { return token_counter_1.countMessageTokens; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,aAAa;AACb,sCAAqC;AAA5B,8FAAA,KAAK,OAAA;AAEd,kDAAgD;AAAvC,yGAAA,UAAU,OAAA;AAEnB,4DAAyD;AAAhD,kHAAA,cAAc,OAAA;AAKvB,oDAAoD;AACpD,0DAKgC;AAJ9B,qHAAA,kBAAkB,OAAA;AAClB,iIAAA,8BAA8B,OAAA;AAC9B,yHAAA,sBAAsB,OAAA;AACtB,0HAAA,uBAAuB,OAAA;AASzB,qCAAqC;AACrC,uDAAqD;AAA5C,6GAAA,YAAY,OAAA;AACrB,2DAAyD;AAAhD,iHAAA,cAAc,OAAA;AAEvB,uCAA6C;AAApC,qGAAA,YAAY,OAAA;AAGrB,6DAA6D;AAC7D,uDAA0E;AAAjE,iHAAA,gBAAgB,OAAA;AAAE,gHAAA,eAAe,OAAA;AAI1C,sBAAsB;AACtB,+CAQ+B;AAP7B,sGAAA,aAAa,OAAA;AACb,gHAAA,uBAAuB,OAAA;AACvB,qGAAA,YAAY,OAAA;AACZ,sGAAA,aAAa,OAAA;AACb,qGAAA,YAAY,OAAA;AACZ,uGAAA,cAAc,OAAA;AACd,uGAAA,cAAc,OAAA;AAGhB,kCAAkC;AAClC,wCAAgG;AAAvF,qGAAA,YAAY,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,yGAAA,gBAAgB,OAAA;AAAE,sGAAA,aAAa,OAAA;AAGvE,WAAW;AACX,8CAA6C;AAApC,kGAAA,OAAO,OAAA;AAChB,0CAAwC;AAA/B,6FAAA,IAAI,OAAA;AAKb,yDAAwF;AAA/E,iHAAA,cAAc,OAAA;AAAE,kHAAA,eAAe,OAAA;AAAE,iHAAA,cAAc,OAAA;AAIxD,UAAU;AACV,6DAA2D;AAAlD,iHAAA,cAAc,OAAA;AAKvB,+DAAwE;AAA/D,0HAAA,wBAAwB,OAAA;AAGjC,mBAAmB;AACnB,uEAAqE;AAA5D,uHAAA,iBAAiB,OAAA;AAG1B,2CAA2C;AAC3C,6DAA2D;AAAlD,iHAAA,cAAc,OAAA;AASvB,QAAQ;AACR,uDAAwE;AAA/D,4GAAA,WAAW,OAAA;AAAE,mHAAA,kBAAkB,OAAA"}

package/dist/llm/interface.d.ts

@@ -0,0 +1,87 @@
+import { Tool } from "../tools/types";
+import { MessageData } from "../messages/types";
+/**
+ * Response returned by an LLM provider after a chat call.
+ */
+export interface LLMResponse {
+    content: string;
+    tool_calls?: Array<{
+        id: string;
+        type: "function";
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+/**
+ * A streaming chunk from the LLM, containing partial content or tool call data.
+ */
+export interface LLMStreamChunk {
+    type: "chunk";
+    /** Partial text content delta (may be empty string). */
+    content?: string;
+    /** Partial tool call deltas, identified by index. */
+    tool_calls?: Array<{
+        /** Index of the tool call in the overall list (used to correlate deltas). */
+        index: number;
+        /** Tool call id (typically appears only in the first delta for a given index). */
+        id?: string;
+        function?: {
+            name?: string;
+            arguments?: string;
+        };
+    }>;
+}
+/**
+ * Terminal event emitted after all streaming chunks have been consumed.
+ */
+export interface LLMStreamDone {
+    type: "done";
+    /** Usage statistics, if available from the provider. */
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+/** Union of all possible stream event types. */
+export type LLMStreamEvent = LLMStreamChunk | LLMStreamDone;
+/**
+ * Abstract interface for LLM providers.
+ * Concrete implementations (e.g., OpenAI, Anthropic) implement this.
+ */
+export interface LLMProvider {
+    /** The model identifier (e.g. "gpt-4o", "gpt-4o-mini"). */
+    readonly model: string;
+    /**
+     * Send a chat completion request (non-streaming).
+     * @param messages  The conversation messages so far.
+     * @param tools     Optional tool definitions for function calling.
+     */
+    chat(messages: MessageData[], tools?: Tool[]): Promise<LLMResponse>;
+    /**
+     * Send a chat completion request and yield events as they arrive.
+     *
+     * Yields {@link LLMStreamChunk} events for each delta, followed by a
+     * single {@link LLMStreamDone} event when the stream completes.
+     *
+     * @param messages  The conversation messages so far.
+     * @param tools     Optional tool definitions for function calling.
+     */
+    chatStream(messages: MessageData[], tools?: Tool[]): AsyncIterable<LLMStreamEvent>;
+    /**
+     * Count tokens in a text string.
+     * Uses tiktoken (by model name) when available, falling back to heuristic estimation.
+     *
+     * @param text The text to tokenize.
+     * @param model Optional model override. Defaults to the provider's own model.
+     */
+    getTokenCount(text: string, model?: string): number;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/llm/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/llm/interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC;KACH,CAAC,CAAC;IACH,KAAK,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,6EAA6E;QAC7E,KAAK,EAAE,MAAM,CAAC;QACd,kFAAkF;QAClF,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE;YACT,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,KAAK,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,aAAa,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpE;;;;;;;;OAQG;IACH,UAAU,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAEnF;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACrD"}

package/dist/llm/interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interface.js.map

package/dist/llm/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/llm/interface.ts"],"names":[],"mappings":""}

package/dist/llm/openai-provider.d.ts

@@ -0,0 +1,92 @@
+import { LLMProvider, LLMResponse, LLMStreamEvent } from "./interface";
+import { MessageData } from "../messages/types";
+import { Tool } from "../tools/types";
+/**
+ * Categories of network-related LLM failures.
+ */
+export type NetworkErrorCause = "timeout" | "connection_refused" | "connection_reset" | "dns_error" | "rate_limit" | "server_error" | "aborted" | "unknown_network";
+/**
+ * Thrown by the LLM provider when all retry attempts for a network-related
+ * failure have been exhausted. The agent catches this to save a checkpoint
+ * and guide the user to resume their session.
+ */
+export declare class LLMNetworkError extends Error {
+    readonly cause: NetworkErrorCause;
+    constructor(message: string, cause: NetworkErrorCause);
+}
+/**
+ * Check whether an error is network-related and thus retryable.
+ */
+export declare function isNetworkError(error: unknown): boolean;
+export interface OpenAIRetryConfig {
+    /** Max retry attempts for network errors (default: 3). */
+    maxRetries?: number;
+    /** Initial backoff delay in ms (default: 1000). */
+    baseDelayMs?: number;
+    /** Maximum backoff delay in ms (default: 30000). */
+    maxDelayMs?: number;
+}
+/**
+ * Configuration options for the OpenAI LLM provider.
+ */
+export interface OpenAIConfig {
+    apiKey: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    baseURL?: string;
+    /** Retry configuration for network resilience. */
+    retry?: OpenAIRetryConfig;
+    /** Request timeout in ms (default: none — SDK default ~10 min). */
+    timeout?: number;
+}
+/**
+ * OpenAI implementation of the LLMProvider interface.
+ * Uses the official `openai` npm package.
+ *
+ * Features:
+ * - Tool/function calling support
+ * - Network error retry with exponential backoff
+ * - Configurable timeout
+ * - Token counting via tiktoken (with model-aware encoding)
+ */
+export declare class OpenAIProvider implements LLMProvider {
+    readonly model: string;
+    private client;
+    private temperature;
+    private maxTokens;
+    private retryConfig;
+    private timeout;
+    constructor(config: OpenAIConfig);
+    chat(messages: MessageData[], tools?: Tool[]): Promise<LLMResponse>;
+    /**
+     * Streaming chat completion.
+     *
+     * Yields content and tool call deltas as they arrive from the API,
+     * then emits a single `"done"` event with usage statistics (when available).
+     *
+     * Note: The retry logic only covers the initial connection. If the stream
+     * drops mid-response, the consumer sees an incomplete stream and the
+     * agent's outer loop handles the error on the next LLM call.
+     */
+    chatStream(messages: MessageData[], tools?: Tool[]): AsyncIterable<LLMStreamEvent>;
+    /**
+     * Count tokens using tiktoken (with model-aware encoding) when available.
+     * Falls back to character-based estimation if tiktoken is not installed.
+     *
+     * @param text  The text to tokenize.
+     * @param model Optional model override. Defaults to this provider's model.
+     */
+    getTokenCount(text: string, model?: string): number;
+    /**
+     * Wrap an async operation with network-error retry logic.
+     *
+     * Retry strategy:
+     * - Only network-related errors (timeout, connection reset, 429, 5xx) are retried.
+     * - Uses exponential backoff with full jitter: delay = base * 2^attempt * random(0.5, 1.0).
+     * - Non-retryable errors (401, 400, abort) propagate immediately.
+     * - After all retries are exhausted, throws `LLMNetworkError`.
+     */
+    private withRetry;
+}
+//# sourceMappingURL=openai-provider.d.ts.map

package/dist/llm/openai-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../../src/llm/openai-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAKtC;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,oBAAoB,GACpB,kBAAkB,GAClB,WAAW,GACX,YAAY,GACZ,cAAc,GACd,SAAS,GACT,iBAAiB,CAAC;AAEtB;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,KAAK,EAAE,iBAAiB,CAAC;gBAE7B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB;CAKtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA0BtD;AAuBD,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;;;;GASG;AACH,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,OAAO,CAAqB;gBAExB,MAAM,EAAE,YAAY;IAgB1B,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IA+CzE;;;;;;;;;OASG;IACI,UAAU,CACf,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,CAAC,EAAE,IAAI,EAAE,GACb,aAAa,CAAC,cAAc,CAAC;IAuEhC;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAMnD;;;;;;;;OAQG;YACW,SAAS;CAgCxB"}

package/dist/llm/openai-provider.js

@@ -0,0 +1,262 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIProvider = exports.LLMNetworkError = void 0;
+exports.isNetworkError = isNetworkError;
+const openai_1 = __importDefault(require("openai"));
+const token_counter_1 = require("../utils/token-counter");
+/**
+ * Thrown by the LLM provider when all retry attempts for a network-related
+ * failure have been exhausted. The agent catches this to save a checkpoint
+ * and guide the user to resume their session.
+ */
+class LLMNetworkError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.name = "LLMNetworkError";
+        this.cause = cause;
+    }
+}
+exports.LLMNetworkError = LLMNetworkError;
+/**
+ * Check whether an error is network-related and thus retryable.
+ */
+function isNetworkError(error) {
+    if (error instanceof LLMNetworkError)
+        return true;
+    if (error instanceof openai_1.default.APIError) {
+        // 429 (rate-limit) and 5xx (server) are retryable
+        if (error.status === 429)
+            return true;
+        if (error.status !== undefined && error.status >= 500 && error.status < 600)
+            return true;
+        return false;
+    }
+    if (error instanceof Error) {
+        const msg = error.message.toLowerCase();
+        return (msg.includes("timeout") ||
+            msg.includes("econnrefused") ||
+            msg.includes("econnreset") ||
+            msg.includes("enotfound") ||
+            msg.includes("fetch failed") ||
+            msg.includes("network") ||
+            msg.includes("socket hang up") ||
+            msg.includes("econnaborted") ||
+            msg.includes("abort"));
+    }
+    return false;
+}
+/**
+ * Map a raw error to its NetworkErrorCause category.
+ */
+function classifyError(error) {
+    if (error instanceof openai_1.default.APIError) {
+        if (error.status === 429)
+            return "rate_limit";
+        if (error.status !== undefined && error.status >= 500)
+            return "server_error";
+    }
+    if (error instanceof Error) {
+        const msg = error.message.toLowerCase();
+        if (msg.includes("abort"))
+            return "aborted";
+        if (msg.includes("timeout"))
+            return "timeout";
+        if (msg.includes("econnrefused"))
+            return "connection_refused";
+        if (msg.includes("econnreset"))
+            return "connection_reset";
+        if (msg.includes("enotfound") || msg.includes("dns"))
+            return "dns_error";
+    }
+    return "unknown_network";
+}
+// ─── OpenAIProvider ────────────────────────────────────────────────────────
+/**
+ * OpenAI implementation of the LLMProvider interface.
+ * Uses the official `openai` npm package.
+ *
+ * Features:
+ * - Tool/function calling support
+ * - Network error retry with exponential backoff
+ * - Configurable timeout
+ * - Token counting via tiktoken (with model-aware encoding)
+ */
+class OpenAIProvider {
+    model;
+    client;
+    temperature;
+    maxTokens;
+    retryConfig;
+    timeout;
+    constructor(config) {
+        this.client = new openai_1.default({
+            apiKey: config.apiKey,
+            baseURL: config.baseURL,
+        });
+        this.model = config.model ?? "gpt-4o";
+        this.temperature = config.temperature ?? 0.7;
+        this.maxTokens = config.maxTokens ?? 4096;
+        this.timeout = config.timeout;
+        this.retryConfig = {
+            maxRetries: config.retry?.maxRetries ?? 3,
+            baseDelayMs: config.retry?.baseDelayMs ?? 1000,
+            maxDelayMs: config.retry?.maxDelayMs ?? 30000,
+        };
+    }
+    async chat(messages, tools) {
+        // Convert internal Tool definitions to OpenAI tool format
+        const openaiTools = tools?.map((t) => ({
+            type: "function",
+            function: {
+                name: t.name,
+                description: t.description,
+                parameters: t.parameters,
+            },
+        }));
+        const response = await this.withRetry(() => this.client.chat.completions.create({
+            model: this.model,
+            messages: messages,
+            temperature: this.temperature,
+            max_tokens: this.maxTokens,
+            tools: openaiTools,
+        }, { timeout: this.timeout }));
+        const choice = response.choices[0];
+        const message = choice.message;
+        return {
+            content: message.content ?? "",
+            tool_calls: message.tool_calls?.map((tc) => ({
+                id: tc.id,
+                type: "function",
+                function: {
+                    name: tc.function.name,
+                    arguments: tc.function.arguments,
+                },
+            })),
+            usage: response.usage
+                ? {
+                    prompt_tokens: response.usage.prompt_tokens,
+                    completion_tokens: response.usage.completion_tokens,
+                    total_tokens: response.usage.total_tokens,
+                }
+                : undefined,
+        };
+    }
+    /**
+     * Streaming chat completion.
+     *
+     * Yields content and tool call deltas as they arrive from the API,
+     * then emits a single `"done"` event with usage statistics (when available).
+     *
+     * Note: The retry logic only covers the initial connection. If the stream
+     * drops mid-response, the consumer sees an incomplete stream and the
+     * agent's outer loop handles the error on the next LLM call.
+     */
+    async *chatStream(messages, tools) {
+        const openaiTools = tools?.map((t) => ({
+            type: "function",
+            function: {
+                name: t.name,
+                description: t.description,
+                parameters: t.parameters,
+            },
+        }));
+        // Retry only the initial stream creation — not mid-stream drops.
+        // Use async wrapper so TypeScript treats APIPromise → Promise correctly.
+        const stream = await this.withRetry(async () => (await this.client.chat.completions.create({
+            model: this.model,
+            messages: messages,
+            temperature: this.temperature,
+            max_tokens: this.maxTokens,
+            tools: openaiTools,
+            stream: true,
+            stream_options: { include_usage: true },
+        }, { timeout: this.timeout })));
+        let emittedDone = false;
+        for await (const chunk of stream) {
+            const delta = chunk.choices?.[0]?.delta;
+            if (delta?.content) {
+                yield { type: "chunk", content: delta.content };
+            }
+            if (delta?.tool_calls) {
+                yield {
+                    type: "chunk",
+                    tool_calls: delta.tool_calls.map((tc) => ({
+                        index: tc.index,
+                        id: tc.id,
+                        function: tc.function
+                            ? { name: tc.function.name, arguments: tc.function.arguments }
+                            : undefined,
+                    })),
+                };
+            }
+            // The final chunk may carry usage when stream_options.include_usage is set.
+            if (chunk.usage) {
+                emittedDone = true;
+                yield {
+                    type: "done",
+                    usage: {
+                        prompt_tokens: chunk.usage.prompt_tokens,
+                        completion_tokens: chunk.usage.completion_tokens,
+                        total_tokens: chunk.usage.total_tokens,
+                    },
+                };
+            }
+        }
+        // Always yield a done event — providers that don't support usage still need
+        // a terminal signal so consumers know the stream is complete.
+        if (!emittedDone) {
+            yield { type: "done" };
+        }
+    }
+    /**
+     * Count tokens using tiktoken (with model-aware encoding) when available.
+     * Falls back to character-based estimation if tiktoken is not installed.
+     *
+     * @param text  The text to tokenize.
+     * @param model Optional model override. Defaults to this provider's model.
+     */
+    getTokenCount(text, model) {
+        return (0, token_counter_1.countTokens)(text, model ?? this.model);
+    }
+    // ─── Private Helpers ────────────────────────────────────────────────────
+    /**
+     * Wrap an async operation with network-error retry logic.
+     *
+     * Retry strategy:
+     * - Only network-related errors (timeout, connection reset, 429, 5xx) are retried.
+     * - Uses exponential backoff with full jitter: delay = base * 2^attempt * random(0.5, 1.0).
+     * - Non-retryable errors (401, 400, abort) propagate immediately.
+     * - After all retries are exhausted, throws `LLMNetworkError`.
+     */
+    async withRetry(fn) {
+        const { maxRetries, baseDelayMs, maxDelayMs } = this.retryConfig;
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error;
+                // Non-network errors propagate immediately (e.g. invalid API key)
+                if (!isNetworkError(error))
+                    throw error;
+                if (attempt >= maxRetries)
+                    break; // all retries exhausted
+                // Exponential backoff with full jitter
+                const delay = Math.min(baseDelayMs * Math.pow(2, attempt) * (0.5 + Math.random() * 0.5), maxDelayMs);
+                // eslint-disable-next-line @typescript-eslint/no-loop-func
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+        // All retries exhausted — wrap the final error
+        const cause = classifyError(lastError);
+        const message = lastError instanceof Error ? lastError.message : String(lastError);
+        throw new LLMNetworkError(message, cause);
+    }
+}
+exports.OpenAIProvider = OpenAIProvider;
+//# sourceMappingURL=openai-provider.js.map

package/dist/llm/openai-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-provider.js","sourceRoot":"","sources":["../../src/llm/openai-provider.ts"],"names":[],"mappings":"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"}