lemura 1.0.0

package/dist/tools/index.mjs

@@ -0,0 +1,70 @@
+// src/types/errors.ts
+var LemuraError = class extends Error {
+  /**
+   * @param message - The error message
+   * @param code - The error code for programmatic handling
+   * @param problem - A clear description of the problem for the end user
+   * @param hints - A list of suggestions to resolve the issue
+   */
+  constructor(message, code, problem, hints = []) {
+    super(message);
+    this.code = code;
+    this.problem = problem;
+    this.hints = hints;
+    this.name = "LemuraError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var LemuraToolNotFoundError = class extends LemuraError {
+  constructor(message) {
+    super(message, "TOOL_NOT_FOUND");
+    this.name = "LemuraToolNotFoundError";
+  }
+};
+var LemuraToolValidationError = class extends LemuraError {
+  constructor(message) {
+    super(message, "TOOL_VALIDATION_FAILED");
+    this.name = "LemuraToolValidationError";
+  }
+};
+
+// src/tools/ToolRegistry.ts
+var ToolRegistry = class {
+  tools = /* @__PURE__ */ new Map();
+  constructor(initialTools = []) {
+    for (const tool of initialTools) {
+      this.register(tool);
+    }
+  }
+  register(tool) {
+    if (this.tools.has(tool.name)) {
+      throw new Error(`Tool ${tool.name} is already registered.`);
+    }
+    this.tools.set(tool.name, tool);
+  }
+  get(name) {
+    return this.tools.get(name);
+  }
+  getAll() {
+    return Array.from(this.tools.values());
+  }
+  async execute(name, params, context) {
+    const tool = this.tools.get(name);
+    if (!tool) {
+      throw new LemuraToolNotFoundError(`Tool '${name}' not found.`);
+    }
+    try {
+      const result = await tool.execute(params, context);
+      return result;
+    } catch (err) {
+      if (err instanceof LemuraToolValidationError) {
+        throw err;
+      }
+      throw new Error(`Tool execution failed for '${name}': ${err.message}`);
+    }
+  }
+};
+
+export { ToolRegistry };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/tools/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/errors.ts","../../src/tools/ToolRegistry.ts"],"names":[],"mappings":";AAMO,IAAM,WAAA,GAAN,cAA0B,KAAA,CAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOnC,YACI,OAAA,EACgB,IAAA,EACA,OAAA,EACA,KAAA,GAAkB,EAAC,EACrC;AACE,IAAA,KAAA,CAAM,OAAO,CAAA;AAJG,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AACA,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAGhB,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EACpD;AACJ,CAAA;AAWO,IAAM,uBAAA,GAAN,cAAsC,WAAA,CAAY;AAAA,EACrD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,gBAAgB,CAAA;AAC/B,IAAA,IAAA,CAAK,IAAA,GAAO,yBAAA;AAAA,EAChB;AACJ,CAAA;AAiCO,IAAM,yBAAA,GAAN,cAAwC,WAAA,CAAY;AAAA,EACvD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,wBAAwB,CAAA;AACvC,IAAA,IAAA,CAAK,IAAA,GAAO,2BAAA;AAAA,EAChB;AACJ,CAAA;;;ACxEO,IAAM,eAAN,MAAmB;AAAA,EACd,KAAA,uBAA0C,GAAA,EAAI;AAAA,EAEtD,WAAA,CAAY,YAAA,GAAkC,EAAC,EAAG;AAC9C,IAAA,KAAA,MAAW,QAAQ,YAAA,EAAc;AAC7B,MAAA,IAAA,CAAK,SAAS,IAAI,CAAA;AAAA,IACtB;AAAA,EACJ;AAAA,EAEA,SAAS,IAAA,EAA6B;AAClC,IAAA,IAAI,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAA,CAAK,IAAI,CAAA,EAAG;AAC3B,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,KAAA,EAAQ,IAAA,CAAK,IAAI,CAAA,uBAAA,CAAyB,CAAA;AAAA,IAC9D;AACA,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAA,CAAK,IAAA,EAAM,IAAI,CAAA;AAAA,EAClC;AAAA,EAEA,IAAI,IAAA,EAA2C;AAC3C,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAI,CAAA;AAAA,EAC9B;AAAA,EAEA,MAAA,GAA4B;AACxB,IAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,KAAA,CAAM,QAAQ,CAAA;AAAA,EACzC;AAAA,EAEA,MAAM,OAAA,CAAQ,IAAA,EAAc,MAAA,EAAiB,OAAA,EAAwC;AACjF,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAI,CAAA;AAChC,IAAA,IAAI,CAAC,IAAA,EAAM;AACP,MAAA,MAAM,IAAI,uBAAA,CAAwB,CAAA,MAAA,EAAS,IAAI,CAAA,YAAA,CAAc,CAAA;AAAA,IACjE;AAEA,IAAA,IAAI;AAGA,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,OAAA,CAAQ,QAAQ,OAAO,CAAA;AACjD,MAAA,OAAO,MAAA;AAAA,IACX,SAAS,GAAA,EAAU;AACf,MAAA,IAAI,eAAe,yBAAA,EAA2B;AAC1C,QAAA,MAAM,GAAA;AAAA,MACV;AACA,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,2BAAA,EAA8B,IAAI,CAAA,GAAA,EAAM,GAAA,CAAI,OAAO,CAAA,CAAE,CAAA;AAAA,IACzE;AAAA,EACJ;AACJ","file":"index.mjs","sourcesContent":["/**\n * Base class for all custom errors thrown by lemura.\n *\n * @example\n * throw new LemuraError('Something went wrong', 'UNKNOWN_ERROR');\n */\nexport class LemuraError extends Error {\n    /**\n     * @param message - The error message\n     * @param code - The error code for programmatic handling\n     * @param problem - A clear description of the problem for the end user\n     * @param hints - A list of suggestions to resolve the issue\n     */\n    constructor(\n        message: string,\n        public readonly code: string,\n        public readonly problem?: string,\n        public readonly hints: string[] = []\n    ) {\n        super(message);\n        this.name = 'LemuraError';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/** Error thrown when context exceeds max tokens and cannot be compressed further */\nexport class LemuraContextOverflowError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'CONTEXT_OVERFLOW');\n        this.name = 'LemuraContextOverflowError';\n    }\n}\n\n/** Error thrown when a requested tool is not found in the registry */\nexport class LemuraToolNotFoundError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_NOT_FOUND');\n        this.name = 'LemuraToolNotFoundError';\n    }\n}\n\n/** Error thrown when an adapter encounters an API or formatting issue */\nexport class LemuraAdapterError extends LemuraError {\n    constructor(\n        message: string,\n        code = 'ADAPTER_ERROR',\n        public cause?: any,\n        problem?: string,\n        hints: string[] = []\n    ) {\n        super(message, code, problem, hints);\n        this.name = 'LemuraAdapterError';\n    }\n}\n\n/** Error thrown when a skill cannot be parsed or injected */\nexport class LemuraSkillInjectionError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'SKILL_INJECTION_FAILED');\n        this.name = 'LemuraSkillInjectionError';\n    }\n}\n\n/** Error thrown when the ReAct loop exceeds the configured max iterations */\nexport class LemuraMaxIterationsError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'MAX_ITERATIONS_EXCEEDED');\n        this.name = 'LemuraMaxIterationsError';\n    }\n}\n\n/** Error thrown when tool parameters fail JSON schema validation */\nexport class LemuraToolValidationError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_VALIDATION_FAILED');\n        this.name = 'LemuraToolValidationError';\n    }\n}\n\n/** Error thrown when a tool execute function exceeds its timeout */\nexport class LemuraToolTimeoutError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_TIMEOUT');\n        this.name = 'LemuraToolTimeoutError';\n    }\n}\n","import { IToolDefinition, LemuraToolNotFoundError, LemuraToolValidationError, ToolContext } from '../types/index.js';\n\n/**\n * Manages registered tools and their execution\n */\nexport class ToolRegistry {\n    private tools: Map<string, IToolDefinition> = new Map();\n\n    constructor(initialTools: IToolDefinition[] = []) {\n        for (const tool of initialTools) {\n            this.register(tool);\n        }\n    }\n\n    register(tool: IToolDefinition): void {\n        if (this.tools.has(tool.name)) {\n            throw new Error(`Tool ${tool.name} is already registered.`);\n        }\n        this.tools.set(tool.name, tool);\n    }\n\n    get(name: string): IToolDefinition | undefined {\n        return this.tools.get(name);\n    }\n\n    getAll(): IToolDefinition[] {\n        return Array.from(this.tools.values());\n    }\n\n    async execute(name: string, params: unknown, context: ToolContext): Promise<unknown> {\n        const tool = this.tools.get(name);\n        if (!tool) {\n            throw new LemuraToolNotFoundError(`Tool '${name}' not found.`);\n        }\n\n        try {\n            // Basic JSON schema validation logic goes here\n            // Real implementation would use Ajv or similar to validate `params` against `tool.parameters`\n            const result = await tool.execute(params, context);\n            return result;\n        } catch (err: any) {\n            if (err instanceof LemuraToolValidationError) {\n                throw err;\n            }\n            throw new Error(`Tool execution failed for '${name}': ${err.message}`);\n        }\n    }\n}\n"]}

package/dist/types/index.d.mts

@@ -0,0 +1,118 @@
+import { e as IProviderAdapter, I as IContextStrategy } from '../adapters-BnG0LEYD.mjs';
+export { A as AudioChunk, b as CompletionChunk, c as CompletionRequest, d as CompletionResponse, a as ContentBlock, C as ContextWindow, f as ImageGenRequest, g as ImageGenResponse, M as ModelInfo, N as NormalizedMessage, S as SynthesisRequest, h as TokenUsage, i as ToolCall, j as ToolResult, k as TranscriptionRequest, l as TranscriptionResponse, T as Turn, V as VisionRequest, m as VisionResponse } from '../adapters-BnG0LEYD.mjs';
+import { I as IToolDefinition, c as ShortTermMemoryRegistry } from '../storage-DMcliVVj.mjs';
+export { a as IStorageAdapter, S as STMItem, T as ToolContext } from '../storage-DMcliVVj.mjs';
+import { I as ILogger } from '../logger-DxvKliuk.mjs';
+export { L as LogLevel, a as LogMetadata, S as Severity } from '../logger-DxvKliuk.mjs';
+import { I as ISkill } from '../skills-wc8S-OvC.mjs';
+import { I as IRAGAdapter } from '../rag-La_Bo-J8.mjs';
+export { R as RAGDocument, a as RAGIngestOptions, b as RAGIngestRequest, c as RAGIngestResponse, d as RAGQueryRequest, e as RAGQueryResponse, f as RAGResult } from '../rag-La_Bo-J8.mjs';
+
+interface ToolResponseEvaluation {
+    relevanceScore: number;
+    sizeClass: 'small' | 'medium' | 'large' | 'oversized';
+    shouldCompress: boolean;
+    suggestedMaxTokens: number;
+    answered: boolean;
+    answeredPartially: boolean;
+    errorDetected: boolean;
+    suggestedAction: 'continue' | 'retry' | 'retry_with_params' | 'skip' | 'escalate';
+}
+interface IToolResponseProcessor {
+    evaluate(response: string, tool: IToolDefinition, context: unknown): ToolResponseEvaluation;
+    compress(response: string, evaluation: ToolResponseEvaluation): string;
+}
+/** Configuration for a lemura Session */
+interface SessionConfig {
+    /** The provider adapter to use */
+    adapter: IProviderAdapter;
+    /** Model string */
+    model: string;
+    /** Max context tokens */
+    maxTokens: number;
+    /** Max ReAct cycles */
+    maxIterations?: number;
+    /** Explicit tools */
+    tools?: IToolDefinition[];
+    /** Explicit skills */
+    skills?: ISkill[];
+    /** RAG adapter */
+    ragAdapter?: IRAGAdapter;
+    /** Context compression strategies */
+    compressionStrategies?: IContextStrategy[];
+    /** System prompt base */
+    systemPrompt?: string;
+    /** Logger */
+    logger?: ILogger;
+    /** Budget for tool responses before compression */
+    toolResponseTokenBudget?: number;
+    /** Processor for tool responses */
+    toolResponseProcessor?: IToolResponseProcessor;
+    /** Max single steps (tool calls) */
+    maxSteps?: number;
+    /** Enable tool continuation planning */
+    enableContinuationPlanning?: boolean;
+    continuationStrategy?: 'sequential' | 'parallel' | 'conditional';
+    /** Enable goal planning */
+    enableGoalPlanning?: boolean;
+    goalInjectionFrequency?: 'always' | 'every_N_turns' | 'on_compression';
+    goalInjectionPosition?: 'system_prompt' | 'pre_turn';
+    /** Skill budget */
+    skillTokenBudget?: number;
+    /** Callback for each turn in the session */
+    onTurn?: (turn: any) => void;
+    /** Short Term Memory Registry */
+    stmRegistry?: ShortTermMemoryRegistry;
+    /** Max tokens allowed for a single tool response */
+    maxTokensPerTool?: number;
+}
+
+/**
+ * Base class for all custom errors thrown by lemura.
+ *
+ * @example
+ * throw new LemuraError('Something went wrong', 'UNKNOWN_ERROR');
+ */
+declare class LemuraError extends Error {
+    readonly code: string;
+    readonly problem?: string | undefined;
+    readonly hints: string[];
+    /**
+     * @param message - The error message
+     * @param code - The error code for programmatic handling
+     * @param problem - A clear description of the problem for the end user
+     * @param hints - A list of suggestions to resolve the issue
+     */
+    constructor(message: string, code: string, problem?: string | undefined, hints?: string[]);
+}
+/** Error thrown when context exceeds max tokens and cannot be compressed further */
+declare class LemuraContextOverflowError extends LemuraError {
+    constructor(message: string);
+}
+/** Error thrown when a requested tool is not found in the registry */
+declare class LemuraToolNotFoundError extends LemuraError {
+    constructor(message: string);
+}
+/** Error thrown when an adapter encounters an API or formatting issue */
+declare class LemuraAdapterError extends LemuraError {
+    cause?: any | undefined;
+    constructor(message: string, code?: string, cause?: any | undefined, problem?: string, hints?: string[]);
+}
+/** Error thrown when a skill cannot be parsed or injected */
+declare class LemuraSkillInjectionError extends LemuraError {
+    constructor(message: string);
+}
+/** Error thrown when the ReAct loop exceeds the configured max iterations */
+declare class LemuraMaxIterationsError extends LemuraError {
+    constructor(message: string);
+}
+/** Error thrown when tool parameters fail JSON schema validation */
+declare class LemuraToolValidationError extends LemuraError {
+    constructor(message: string);
+}
+/** Error thrown when a tool execute function exceeds its timeout */
+declare class LemuraToolTimeoutError extends LemuraError {
+    constructor(message: string);
+}
+
+export { IContextStrategy, ILogger, IProviderAdapter, IRAGAdapter, ISkill, IToolDefinition, type IToolResponseProcessor, LemuraAdapterError, LemuraContextOverflowError, LemuraError, LemuraMaxIterationsError, LemuraSkillInjectionError, LemuraToolNotFoundError, LemuraToolTimeoutError, LemuraToolValidationError, type SessionConfig, type ToolResponseEvaluation };

package/dist/types/index.d.ts

@@ -0,0 +1,118 @@
+import { e as IProviderAdapter, I as IContextStrategy } from '../adapters-BSkhv5ac.js';
+export { A as AudioChunk, b as CompletionChunk, c as CompletionRequest, d as CompletionResponse, a as ContentBlock, C as ContextWindow, f as ImageGenRequest, g as ImageGenResponse, M as ModelInfo, N as NormalizedMessage, S as SynthesisRequest, h as TokenUsage, i as ToolCall, j as ToolResult, k as TranscriptionRequest, l as TranscriptionResponse, T as Turn, V as VisionRequest, m as VisionResponse } from '../adapters-BSkhv5ac.js';
+import { I as IToolDefinition, c as ShortTermMemoryRegistry } from '../storage-BGu4Loao.js';
+export { a as IStorageAdapter, S as STMItem, T as ToolContext } from '../storage-BGu4Loao.js';
+import { I as ILogger } from '../logger-DxvKliuk.js';
+export { L as LogLevel, a as LogMetadata, S as Severity } from '../logger-DxvKliuk.js';
+import { I as ISkill } from '../skills-wc8S-OvC.js';
+import { I as IRAGAdapter } from '../rag-La_Bo-J8.js';
+export { R as RAGDocument, a as RAGIngestOptions, b as RAGIngestRequest, c as RAGIngestResponse, d as RAGQueryRequest, e as RAGQueryResponse, f as RAGResult } from '../rag-La_Bo-J8.js';
+
+interface ToolResponseEvaluation {
+    relevanceScore: number;
+    sizeClass: 'small' | 'medium' | 'large' | 'oversized';
+    shouldCompress: boolean;
+    suggestedMaxTokens: number;
+    answered: boolean;
+    answeredPartially: boolean;
+    errorDetected: boolean;
+    suggestedAction: 'continue' | 'retry' | 'retry_with_params' | 'skip' | 'escalate';
+}
+interface IToolResponseProcessor {
+    evaluate(response: string, tool: IToolDefinition, context: unknown): ToolResponseEvaluation;
+    compress(response: string, evaluation: ToolResponseEvaluation): string;
+}
+/** Configuration for a lemura Session */
+interface SessionConfig {
+    /** The provider adapter to use */
+    adapter: IProviderAdapter;
+    /** Model string */
+    model: string;
+    /** Max context tokens */
+    maxTokens: number;
+    /** Max ReAct cycles */
+    maxIterations?: number;
+    /** Explicit tools */
+    tools?: IToolDefinition[];
+    /** Explicit skills */
+    skills?: ISkill[];
+    /** RAG adapter */
+    ragAdapter?: IRAGAdapter;
+    /** Context compression strategies */
+    compressionStrategies?: IContextStrategy[];
+    /** System prompt base */
+    systemPrompt?: string;
+    /** Logger */
+    logger?: ILogger;
+    /** Budget for tool responses before compression */
+    toolResponseTokenBudget?: number;
+    /** Processor for tool responses */
+    toolResponseProcessor?: IToolResponseProcessor;
+    /** Max single steps (tool calls) */
+    maxSteps?: number;
+    /** Enable tool continuation planning */
+    enableContinuationPlanning?: boolean;
+    continuationStrategy?: 'sequential' | 'parallel' | 'conditional';
+    /** Enable goal planning */
+    enableGoalPlanning?: boolean;
+    goalInjectionFrequency?: 'always' | 'every_N_turns' | 'on_compression';
+    goalInjectionPosition?: 'system_prompt' | 'pre_turn';
+    /** Skill budget */
+    skillTokenBudget?: number;
+    /** Callback for each turn in the session */
+    onTurn?: (turn: any) => void;
+    /** Short Term Memory Registry */
+    stmRegistry?: ShortTermMemoryRegistry;
+    /** Max tokens allowed for a single tool response */
+    maxTokensPerTool?: number;
+}
+
+/**
+ * Base class for all custom errors thrown by lemura.
+ *
+ * @example
+ * throw new LemuraError('Something went wrong', 'UNKNOWN_ERROR');
+ */
+declare class LemuraError extends Error {
+    readonly code: string;
+    readonly problem?: string | undefined;
+    readonly hints: string[];
+    /**
+     * @param message - The error message
+     * @param code - The error code for programmatic handling
+     * @param problem - A clear description of the problem for the end user
+     * @param hints - A list of suggestions to resolve the issue
+     */
+    constructor(message: string, code: string, problem?: string | undefined, hints?: string[]);
+}
+/** Error thrown when context exceeds max tokens and cannot be compressed further */
+declare class LemuraContextOverflowError extends LemuraError {
+    constructor(message: string);
+}
+/** Error thrown when a requested tool is not found in the registry */
+declare class LemuraToolNotFoundError extends LemuraError {
+    constructor(message: string);
+}
+/** Error thrown when an adapter encounters an API or formatting issue */
+declare class LemuraAdapterError extends LemuraError {
+    cause?: any | undefined;
+    constructor(message: string, code?: string, cause?: any | undefined, problem?: string, hints?: string[]);
+}
+/** Error thrown when a skill cannot be parsed or injected */
+declare class LemuraSkillInjectionError extends LemuraError {
+    constructor(message: string);
+}
+/** Error thrown when the ReAct loop exceeds the configured max iterations */
+declare class LemuraMaxIterationsError extends LemuraError {
+    constructor(message: string);
+}
+/** Error thrown when tool parameters fail JSON schema validation */
+declare class LemuraToolValidationError extends LemuraError {
+    constructor(message: string);
+}
+/** Error thrown when a tool execute function exceeds its timeout */
+declare class LemuraToolTimeoutError extends LemuraError {
+    constructor(message: string);
+}
+
+export { IContextStrategy, ILogger, IProviderAdapter, IRAGAdapter, ISkill, IToolDefinition, type IToolResponseProcessor, LemuraAdapterError, LemuraContextOverflowError, LemuraError, LemuraMaxIterationsError, LemuraSkillInjectionError, LemuraToolNotFoundError, LemuraToolTimeoutError, LemuraToolValidationError, type SessionConfig, type ToolResponseEvaluation };

package/dist/types/index.js

@@ -0,0 +1,84 @@
+'use strict';
+
+// src/types/errors.ts
+var LemuraError = class extends Error {
+  /**
+   * @param message - The error message
+   * @param code - The error code for programmatic handling
+   * @param problem - A clear description of the problem for the end user
+   * @param hints - A list of suggestions to resolve the issue
+   */
+  constructor(message, code, problem, hints = []) {
+    super(message);
+    this.code = code;
+    this.problem = problem;
+    this.hints = hints;
+    this.name = "LemuraError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var LemuraContextOverflowError = class extends LemuraError {
+  constructor(message) {
+    super(message, "CONTEXT_OVERFLOW");
+    this.name = "LemuraContextOverflowError";
+  }
+};
+var LemuraToolNotFoundError = class extends LemuraError {
+  constructor(message) {
+    super(message, "TOOL_NOT_FOUND");
+    this.name = "LemuraToolNotFoundError";
+  }
+};
+var LemuraAdapterError = class extends LemuraError {
+  constructor(message, code = "ADAPTER_ERROR", cause, problem, hints = []) {
+    super(message, code, problem, hints);
+    this.cause = cause;
+    this.name = "LemuraAdapterError";
+  }
+};
+var LemuraSkillInjectionError = class extends LemuraError {
+  constructor(message) {
+    super(message, "SKILL_INJECTION_FAILED");
+    this.name = "LemuraSkillInjectionError";
+  }
+};
+var LemuraMaxIterationsError = class extends LemuraError {
+  constructor(message) {
+    super(message, "MAX_ITERATIONS_EXCEEDED");
+    this.name = "LemuraMaxIterationsError";
+  }
+};
+var LemuraToolValidationError = class extends LemuraError {
+  constructor(message) {
+    super(message, "TOOL_VALIDATION_FAILED");
+    this.name = "LemuraToolValidationError";
+  }
+};
+var LemuraToolTimeoutError = class extends LemuraError {
+  constructor(message) {
+    super(message, "TOOL_TIMEOUT");
+    this.name = "LemuraToolTimeoutError";
+  }
+};
+
+// src/types/logger.ts
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["DEBUG"] = 0] = "DEBUG";
+  LogLevel2[LogLevel2["INFO"] = 1] = "INFO";
+  LogLevel2[LogLevel2["WARN"] = 2] = "WARN";
+  LogLevel2[LogLevel2["ERROR"] = 3] = "ERROR";
+  LogLevel2[LogLevel2["FATAL"] = 4] = "FATAL";
+  return LogLevel2;
+})(LogLevel || {});
+
+exports.LemuraAdapterError = LemuraAdapterError;
+exports.LemuraContextOverflowError = LemuraContextOverflowError;
+exports.LemuraError = LemuraError;
+exports.LemuraMaxIterationsError = LemuraMaxIterationsError;
+exports.LemuraSkillInjectionError = LemuraSkillInjectionError;
+exports.LemuraToolNotFoundError = LemuraToolNotFoundError;
+exports.LemuraToolTimeoutError = LemuraToolTimeoutError;
+exports.LemuraToolValidationError = LemuraToolValidationError;
+exports.LogLevel = LogLevel;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/errors.ts","../../src/types/logger.ts"],"names":["LogLevel"],"mappings":";;;AAMO,IAAM,WAAA,GAAN,cAA0B,KAAA,CAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOnC,YACI,OAAA,EACgB,IAAA,EACA,OAAA,EACA,KAAA,GAAkB,EAAC,EACrC;AACE,IAAA,KAAA,CAAM,OAAO,CAAA;AAJG,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AACA,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAGhB,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EACpD;AACJ;AAGO,IAAM,0BAAA,GAAN,cAAyC,WAAA,CAAY;AAAA,EACxD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,kBAAkB,CAAA;AACjC,IAAA,IAAA,CAAK,IAAA,GAAO,4BAAA;AAAA,EAChB;AACJ;AAGO,IAAM,uBAAA,GAAN,cAAsC,WAAA,CAAY;AAAA,EACrD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,gBAAgB,CAAA;AAC/B,IAAA,IAAA,CAAK,IAAA,GAAO,yBAAA;AAAA,EAChB;AACJ;AAGO,IAAM,kBAAA,GAAN,cAAiC,WAAA,CAAY;AAAA,EAChD,WAAA,CACI,SACA,IAAA,GAAO,eAAA,EACA,OACP,OAAA,EACA,KAAA,GAAkB,EAAC,EACrB;AACE,IAAA,KAAA,CAAM,OAAA,EAAS,IAAA,EAAM,OAAA,EAAS,KAAK,CAAA;AAJ5B,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAKP,IAAA,IAAA,CAAK,IAAA,GAAO,oBAAA;AAAA,EAChB;AACJ;AAGO,IAAM,yBAAA,GAAN,cAAwC,WAAA,CAAY;AAAA,EACvD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,wBAAwB,CAAA;AACvC,IAAA,IAAA,CAAK,IAAA,GAAO,2BAAA;AAAA,EAChB;AACJ;AAGO,IAAM,wBAAA,GAAN,cAAuC,WAAA,CAAY;AAAA,EACtD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,yBAAyB,CAAA;AACxC,IAAA,IAAA,CAAK,IAAA,GAAO,0BAAA;AAAA,EAChB;AACJ;AAGO,IAAM,yBAAA,GAAN,cAAwC,WAAA,CAAY;AAAA,EACvD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,wBAAwB,CAAA;AACvC,IAAA,IAAA,CAAK,IAAA,GAAO,2BAAA;AAAA,EAChB;AACJ;AAGO,IAAM,sBAAA,GAAN,cAAqC,WAAA,CAAY;AAAA,EACpD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,cAAc,CAAA;AAC7B,IAAA,IAAA,CAAK,IAAA,GAAO,wBAAA;AAAA,EAChB;AACJ;;;ACpFO,IAAK,QAAA,qBAAAA,SAAAA,KAAL;AACH,EAAAA,SAAAA,CAAAA,SAAAA,CAAA,WAAQ,CAAA,CAAA,GAAR,OAAA;AACA,EAAAA,SAAAA,CAAAA,SAAAA,CAAA,UAAO,CAAA,CAAA,GAAP,MAAA;AACA,EAAAA,SAAAA,CAAAA,SAAAA,CAAA,UAAO,CAAA,CAAA,GAAP,MAAA;AACA,EAAAA,SAAAA,CAAAA,SAAAA,CAAA,WAAQ,CAAA,CAAA,GAAR,OAAA;AACA,EAAAA,SAAAA,CAAAA,SAAAA,CAAA,WAAQ,CAAA,CAAA,GAAR,OAAA;AALQ,EAAA,OAAAA,SAAAA;AAAA,CAAA,EAAA,QAAA,IAAA,EAAA","file":"index.js","sourcesContent":["/**\n * Base class for all custom errors thrown by lemura.\n *\n * @example\n * throw new LemuraError('Something went wrong', 'UNKNOWN_ERROR');\n */\nexport class LemuraError extends Error {\n    /**\n     * @param message - The error message\n     * @param code - The error code for programmatic handling\n     * @param problem - A clear description of the problem for the end user\n     * @param hints - A list of suggestions to resolve the issue\n     */\n    constructor(\n        message: string,\n        public readonly code: string,\n        public readonly problem?: string,\n        public readonly hints: string[] = []\n    ) {\n        super(message);\n        this.name = 'LemuraError';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/** Error thrown when context exceeds max tokens and cannot be compressed further */\nexport class LemuraContextOverflowError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'CONTEXT_OVERFLOW');\n        this.name = 'LemuraContextOverflowError';\n    }\n}\n\n/** Error thrown when a requested tool is not found in the registry */\nexport class LemuraToolNotFoundError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_NOT_FOUND');\n        this.name = 'LemuraToolNotFoundError';\n    }\n}\n\n/** Error thrown when an adapter encounters an API or formatting issue */\nexport class LemuraAdapterError extends LemuraError {\n    constructor(\n        message: string,\n        code = 'ADAPTER_ERROR',\n        public cause?: any,\n        problem?: string,\n        hints: string[] = []\n    ) {\n        super(message, code, problem, hints);\n        this.name = 'LemuraAdapterError';\n    }\n}\n\n/** Error thrown when a skill cannot be parsed or injected */\nexport class LemuraSkillInjectionError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'SKILL_INJECTION_FAILED');\n        this.name = 'LemuraSkillInjectionError';\n    }\n}\n\n/** Error thrown when the ReAct loop exceeds the configured max iterations */\nexport class LemuraMaxIterationsError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'MAX_ITERATIONS_EXCEEDED');\n        this.name = 'LemuraMaxIterationsError';\n    }\n}\n\n/** Error thrown when tool parameters fail JSON schema validation */\nexport class LemuraToolValidationError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_VALIDATION_FAILED');\n        this.name = 'LemuraToolValidationError';\n    }\n}\n\n/** Error thrown when a tool execute function exceeds its timeout */\nexport class LemuraToolTimeoutError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_TIMEOUT');\n        this.name = 'LemuraToolTimeoutError';\n    }\n}\n","/** Log levels supported by lemura */\nexport enum LogLevel {\n    DEBUG = 0,\n    INFO = 1,\n    WARN = 2,\n    ERROR = 3,\n    FATAL = 4,\n}\n\n/** Severity levels for user-facing logs */\nexport type Severity = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR' | 'FATAL';\n\n/** Metadata for structured logging and error reporting */\nexport interface LogMetadata {\n    problem?: string;\n    hints?: string[];\n    severity?: Severity;\n    [key: string]: unknown;\n}\n\n/**\n * Enhanced logger interface for lemura.\n * Supports structured logging with problems and hints.\n */\nexport interface ILogger {\n    /** Log a debug message (trace-level details) */\n    debug(message: string, metadata?: LogMetadata): void;\n    /** Log an informational message */\n    info(message: string, metadata?: LogMetadata): void;\n    /** Log a warning */\n    warn(message: string, metadata?: LogMetadata): void;\n    /** Log an error */\n    error(message: string, metadata?: LogMetadata): void;\n    /** Log a fatal error that prevents execution */\n    fatal(message: string, metadata?: LogMetadata): void;\n\n    /** Set the minimum log level to display */\n    setLevel(level: LogLevel): void;\n}\n"]}

package/dist/types/index.mjs

@@ -0,0 +1,74 @@
+// src/types/errors.ts
+var LemuraError = class extends Error {
+  /**
+   * @param message - The error message
+   * @param code - The error code for programmatic handling
+   * @param problem - A clear description of the problem for the end user
+   * @param hints - A list of suggestions to resolve the issue
+   */
+  constructor(message, code, problem, hints = []) {
+    super(message);
+    this.code = code;
+    this.problem = problem;
+    this.hints = hints;
+    this.name = "LemuraError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var LemuraContextOverflowError = class extends LemuraError {
+  constructor(message) {
+    super(message, "CONTEXT_OVERFLOW");
+    this.name = "LemuraContextOverflowError";
+  }
+};
+var LemuraToolNotFoundError = class extends LemuraError {
+  constructor(message) {
+    super(message, "TOOL_NOT_FOUND");
+    this.name = "LemuraToolNotFoundError";
+  }
+};
+var LemuraAdapterError = class extends LemuraError {
+  constructor(message, code = "ADAPTER_ERROR", cause, problem, hints = []) {
+    super(message, code, problem, hints);
+    this.cause = cause;
+    this.name = "LemuraAdapterError";
+  }
+};
+var LemuraSkillInjectionError = class extends LemuraError {
+  constructor(message) {
+    super(message, "SKILL_INJECTION_FAILED");
+    this.name = "LemuraSkillInjectionError";
+  }
+};
+var LemuraMaxIterationsError = class extends LemuraError {
+  constructor(message) {
+    super(message, "MAX_ITERATIONS_EXCEEDED");
+    this.name = "LemuraMaxIterationsError";
+  }
+};
+var LemuraToolValidationError = class extends LemuraError {
+  constructor(message) {
+    super(message, "TOOL_VALIDATION_FAILED");
+    this.name = "LemuraToolValidationError";
+  }
+};
+var LemuraToolTimeoutError = class extends LemuraError {
+  constructor(message) {
+    super(message, "TOOL_TIMEOUT");
+    this.name = "LemuraToolTimeoutError";
+  }
+};
+
+// src/types/logger.ts
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["DEBUG"] = 0] = "DEBUG";
+  LogLevel2[LogLevel2["INFO"] = 1] = "INFO";
+  LogLevel2[LogLevel2["WARN"] = 2] = "WARN";
+  LogLevel2[LogLevel2["ERROR"] = 3] = "ERROR";
+  LogLevel2[LogLevel2["FATAL"] = 4] = "FATAL";
+  return LogLevel2;
+})(LogLevel || {});
+
+export { LemuraAdapterError, LemuraContextOverflowError, LemuraError, LemuraMaxIterationsError, LemuraSkillInjectionError, LemuraToolNotFoundError, LemuraToolTimeoutError, LemuraToolValidationError, LogLevel };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/types/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/errors.ts","../../src/types/logger.ts"],"names":["LogLevel"],"mappings":";AAMO,IAAM,WAAA,GAAN,cAA0B,KAAA,CAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOnC,YACI,OAAA,EACgB,IAAA,EACA,OAAA,EACA,KAAA,GAAkB,EAAC,EACrC;AACE,IAAA,KAAA,CAAM,OAAO,CAAA;AAJG,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AACA,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAGhB,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EACpD;AACJ;AAGO,IAAM,0BAAA,GAAN,cAAyC,WAAA,CAAY;AAAA,EACxD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,kBAAkB,CAAA;AACjC,IAAA,IAAA,CAAK,IAAA,GAAO,4BAAA;AAAA,EAChB;AACJ;AAGO,IAAM,uBAAA,GAAN,cAAsC,WAAA,CAAY;AAAA,EACrD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,gBAAgB,CAAA;AAC/B,IAAA,IAAA,CAAK,IAAA,GAAO,yBAAA;AAAA,EAChB;AACJ;AAGO,IAAM,kBAAA,GAAN,cAAiC,WAAA,CAAY;AAAA,EAChD,WAAA,CACI,SACA,IAAA,GAAO,eAAA,EACA,OACP,OAAA,EACA,KAAA,GAAkB,EAAC,EACrB;AACE,IAAA,KAAA,CAAM,OAAA,EAAS,IAAA,EAAM,OAAA,EAAS,KAAK,CAAA;AAJ5B,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAKP,IAAA,IAAA,CAAK,IAAA,GAAO,oBAAA;AAAA,EAChB;AACJ;AAGO,IAAM,yBAAA,GAAN,cAAwC,WAAA,CAAY;AAAA,EACvD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,wBAAwB,CAAA;AACvC,IAAA,IAAA,CAAK,IAAA,GAAO,2BAAA;AAAA,EAChB;AACJ;AAGO,IAAM,wBAAA,GAAN,cAAuC,WAAA,CAAY;AAAA,EACtD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,yBAAyB,CAAA;AACxC,IAAA,IAAA,CAAK,IAAA,GAAO,0BAAA;AAAA,EAChB;AACJ;AAGO,IAAM,yBAAA,GAAN,cAAwC,WAAA,CAAY;AAAA,EACvD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,wBAAwB,CAAA;AACvC,IAAA,IAAA,CAAK,IAAA,GAAO,2BAAA;AAAA,EAChB;AACJ;AAGO,IAAM,sBAAA,GAAN,cAAqC,WAAA,CAAY;AAAA,EACpD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,cAAc,CAAA;AAC7B,IAAA,IAAA,CAAK,IAAA,GAAO,wBAAA;AAAA,EAChB;AACJ;;;ACpFO,IAAK,QAAA,qBAAAA,SAAAA,KAAL;AACH,EAAAA,SAAAA,CAAAA,SAAAA,CAAA,WAAQ,CAAA,CAAA,GAAR,OAAA;AACA,EAAAA,SAAAA,CAAAA,SAAAA,CAAA,UAAO,CAAA,CAAA,GAAP,MAAA;AACA,EAAAA,SAAAA,CAAAA,SAAAA,CAAA,UAAO,CAAA,CAAA,GAAP,MAAA;AACA,EAAAA,SAAAA,CAAAA,SAAAA,CAAA,WAAQ,CAAA,CAAA,GAAR,OAAA;AACA,EAAAA,SAAAA,CAAAA,SAAAA,CAAA,WAAQ,CAAA,CAAA,GAAR,OAAA;AALQ,EAAA,OAAAA,SAAAA;AAAA,CAAA,EAAA,QAAA,IAAA,EAAA","file":"index.mjs","sourcesContent":["/**\n * Base class for all custom errors thrown by lemura.\n *\n * @example\n * throw new LemuraError('Something went wrong', 'UNKNOWN_ERROR');\n */\nexport class LemuraError extends Error {\n    /**\n     * @param message - The error message\n     * @param code - The error code for programmatic handling\n     * @param problem - A clear description of the problem for the end user\n     * @param hints - A list of suggestions to resolve the issue\n     */\n    constructor(\n        message: string,\n        public readonly code: string,\n        public readonly problem?: string,\n        public readonly hints: string[] = []\n    ) {\n        super(message);\n        this.name = 'LemuraError';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/** Error thrown when context exceeds max tokens and cannot be compressed further */\nexport class LemuraContextOverflowError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'CONTEXT_OVERFLOW');\n        this.name = 'LemuraContextOverflowError';\n    }\n}\n\n/** Error thrown when a requested tool is not found in the registry */\nexport class LemuraToolNotFoundError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_NOT_FOUND');\n        this.name = 'LemuraToolNotFoundError';\n    }\n}\n\n/** Error thrown when an adapter encounters an API or formatting issue */\nexport class LemuraAdapterError extends LemuraError {\n    constructor(\n        message: string,\n        code = 'ADAPTER_ERROR',\n        public cause?: any,\n        problem?: string,\n        hints: string[] = []\n    ) {\n        super(message, code, problem, hints);\n        this.name = 'LemuraAdapterError';\n    }\n}\n\n/** Error thrown when a skill cannot be parsed or injected */\nexport class LemuraSkillInjectionError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'SKILL_INJECTION_FAILED');\n        this.name = 'LemuraSkillInjectionError';\n    }\n}\n\n/** Error thrown when the ReAct loop exceeds the configured max iterations */\nexport class LemuraMaxIterationsError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'MAX_ITERATIONS_EXCEEDED');\n        this.name = 'LemuraMaxIterationsError';\n    }\n}\n\n/** Error thrown when tool parameters fail JSON schema validation */\nexport class LemuraToolValidationError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_VALIDATION_FAILED');\n        this.name = 'LemuraToolValidationError';\n    }\n}\n\n/** Error thrown when a tool execute function exceeds its timeout */\nexport class LemuraToolTimeoutError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_TIMEOUT');\n        this.name = 'LemuraToolTimeoutError';\n    }\n}\n","/** Log levels supported by lemura */\nexport enum LogLevel {\n    DEBUG = 0,\n    INFO = 1,\n    WARN = 2,\n    ERROR = 3,\n    FATAL = 4,\n}\n\n/** Severity levels for user-facing logs */\nexport type Severity = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR' | 'FATAL';\n\n/** Metadata for structured logging and error reporting */\nexport interface LogMetadata {\n    problem?: string;\n    hints?: string[];\n    severity?: Severity;\n    [key: string]: unknown;\n}\n\n/**\n * Enhanced logger interface for lemura.\n * Supports structured logging with problems and hints.\n */\nexport interface ILogger {\n    /** Log a debug message (trace-level details) */\n    debug(message: string, metadata?: LogMetadata): void;\n    /** Log an informational message */\n    info(message: string, metadata?: LogMetadata): void;\n    /** Log a warning */\n    warn(message: string, metadata?: LogMetadata): void;\n    /** Log an error */\n    error(message: string, metadata?: LogMetadata): void;\n    /** Log a fatal error that prevents execution */\n    fatal(message: string, metadata?: LogMetadata): void;\n\n    /** Set the minimum log level to display */\n    setLevel(level: LogLevel): void;\n}\n"]}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "lemura",
+  "version": "1.0.0",
+  "description": "Provider-agnostic agentic AI runtime",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "import": "./dist/adapters/index.mjs",
+      "require": "./dist/adapters/index.js"
+    },
+    "./context": {
+      "types": "./dist/context/index.d.ts",
+      "import": "./dist/context/index.mjs",
+      "require": "./dist/context/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.mjs",
+      "require": "./dist/tools/index.js"
+    },
+    "./skills": {
+      "types": "./dist/skills/index.d.ts",
+      "import": "./dist/skills/index.mjs",
+      "require": "./dist/skills/index.js"
+    },
+    "./rag": {
+      "types": "./dist/rag/index.d.ts",
+      "import": "./dist/rag/index.mjs",
+      "require": "./dist/rag/index.js"
+    },
+    "./logger": {
+      "types": "./dist/logger/index.d.ts",
+      "import": "./dist/logger/index.mjs",
+      "require": "./dist/logger/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.mjs",
+      "require": "./dist/types/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "skills",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "package": "pnpm pack --pack-destination ./package",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:docs": "vitest run tests/docs/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist coverage .turbo",
+    "docs:api": "typedoc --out docs/api src/index.ts"
+  },
+  "devDependencies": {
+    "@types/node": "20.11.24",
+    "@vitest/coverage-v8": "^1.0.0",
+    "tsup": "^8.0.0",
+    "typedoc": "^0.28.17",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  }
+}