nemoris 0.1.0 → 0.1.2

package/src/utils/errors.js

@@ -1,80 +1,80 @@
-/**
- * Shared error formatting utility for Nemoris V2.
- * Provides consistent, structured error output across all modules.
- */
-
-const VALID_CATEGORIES = new Set([
-  "config",
-  "provider",
-  "memory",
-  "delivery",
-  "security",
-  "execution"
-]);
-
-export class RuntimeError extends Error {
-  /**
-   * @param {string} message
-   * @param {object} options
-   * @param {string} options.category - one of: config, provider, memory, delivery, security, execution
-   * @param {object} [options.context] - key-value context for diagnostics
-   * @param {boolean} [options.recoverable] - whether the caller can retry/recover
-   */
-  constructor(message, { category, context = {}, recoverable = false } = {}) {
-    super(message);
-    this.name = "RuntimeError";
-    this.category = VALID_CATEGORIES.has(category) ? category : "execution";
-    this.context = context;
-    this.recoverable = recoverable;
-  }
-}
-
-/**
- * Format any error into a consistent Nemoris error string.
- *
- * Output format:
- *   [Nemoris] <category>: <message>
- *     context: <key=value pairs>
- *     source: <file:line if available>
- *
- * @param {Error|RuntimeError} error
- * @param {object} [context] - additional context merged with error.context
- * @returns {string}
- */
-export function formatRuntimeError(error, context = {}) {
-  const category = error?.category || "execution";
-  const message = error?.message || String(error);
-
-  const mergedContext = { ...(error?.context || {}), ...context };
-  const contextEntries = Object.entries(mergedContext);
-  const contextLine = contextEntries.length
-    ? contextEntries.map(([k, v]) => `${k}=${typeof v === "object" ? JSON.stringify(v) : v}`).join(", ")
-    : "none";
-
-  const source = extractSource(error);
-
-  const lines = [`[Nemoris] ${category}: ${message}`];
-  lines.push(`  context: ${contextLine}`);
-  lines.push(`  source: ${source}`);
-
-  return lines.join("\n");
-}
-
-function extractSource(error) {
-  if (!error?.stack) return "unknown";
-  const lines = error.stack.split("\n");
-  // Find first stack frame that is not this file
-  for (const line of lines) {
-    const match = line.match(/at\s+.+?\((.+:\d+:\d+)\)/);
-    if (match && !match[1].includes("utils/errors.js")) {
-      return match[1];
-    }
-    const matchNoParens = line.match(/at\s+(.+:\d+:\d+)$/);
-    if (matchNoParens && !matchNoParens[1].includes("utils/errors.js")) {
-      return matchNoParens[1];
-    }
-  }
-  return "unknown";
-}
-
-export { VALID_CATEGORIES };
+/**
+ * Shared error formatting utility for Nemoris V2.
+ * Provides consistent, structured error output across all modules.
+ */
+
+const VALID_CATEGORIES = new Set([
+  "config",
+  "provider",
+  "memory",
+  "delivery",
+  "security",
+  "execution"
+]);
+
+export class RuntimeError extends Error {
+  /**
+   * @param {string} message
+   * @param {object} options
+   * @param {string} options.category - one of: config, provider, memory, delivery, security, execution
+   * @param {object} [options.context] - key-value context for diagnostics
+   * @param {boolean} [options.recoverable] - whether the caller can retry/recover
+   */
+  constructor(message, { category, context = {}, recoverable = false } = {}) {
+    super(message);
+    this.name = "RuntimeError";
+    this.category = VALID_CATEGORIES.has(category) ? category : "execution";
+    this.context = context;
+    this.recoverable = recoverable;
+  }
+}
+
+/**
+ * Format any error into a consistent Nemoris error string.
+ *
+ * Output format:
+ *   [Nemoris] <category>: <message>
+ *     context: <key=value pairs>
+ *     source: <file:line if available>
+ *
+ * @param {Error|RuntimeError} error
+ * @param {object} [context] - additional context merged with error.context
+ * @returns {string}
+ */
+export function formatRuntimeError(error, context = {}) {
+  const category = error?.category || "execution";
+  const message = error?.message || String(error);
+
+  const mergedContext = { ...(error?.context || {}), ...context };
+  const contextEntries = Object.entries(mergedContext);
+  const contextLine = contextEntries.length
+    ? contextEntries.map(([k, v]) => `${k}=${typeof v === "object" ? JSON.stringify(v) : v}`).join(", ")
+    : "none";
+
+  const source = extractSource(error);
+
+  const lines = [`[Nemoris] ${category}: ${message}`];
+  lines.push(`  context: ${contextLine}`);
+  lines.push(`  source: ${source}`);
+
+  return lines.join("\n");
+}
+
+function extractSource(error) {
+  if (!error?.stack) return "unknown";
+  const lines = error.stack.split("\n");
+  // Find first stack frame that is not this file
+  for (const line of lines) {
+    const match = line.match(/at\s+.+?\((.+:\d+:\d+)\)/);
+    if (match && !match[1].includes("utils/errors.js")) {
+      return match[1];
+    }
+    const matchNoParens = line.match(/at\s+(.+:\d+:\d+)$/);
+    if (matchNoParens && !matchNoParens[1].includes("utils/errors.js")) {
+      return matchNoParens[1];
+    }
+  }
+  return "unknown";
+}
+
+export { VALID_CATEGORIES };

package/src/utils/fs.js

@@ -1,101 +1,101 @@
-import { mkdir, readFile, writeFile, appendFile, readdir, rm, stat } from "node:fs/promises";
-import path from "node:path";
-
-export async function ensureDir(dirPath) {
-  await mkdir(dirPath, { recursive: true });
-}
-
-export async function readJson(filePath, fallback = null) {
-  try {
-    const raw = await readFile(filePath, "utf8");
-    return JSON.parse(raw);
-  } catch (error) {
-    if (error.code === "ENOENT") return fallback;
-    throw error;
-  }
-}
-
-export async function readText(filePath, fallback = null) {
-  try {
-    return await readFile(filePath, "utf8");
-  } catch (error) {
-    if (error.code === "ENOENT") return fallback;
-    throw error;
-  }
-}
-
-export async function writeJson(filePath, value) {
-  await ensureDir(path.dirname(filePath));
-  await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
-}
-
-export async function appendJsonLine(filePath, value) {
-  await ensureDir(path.dirname(filePath));
-  await appendFile(filePath, `${JSON.stringify(value)}\n`, "utf8");
-}
-
-export async function readJsonLines(filePath) {
-  try {
-    const raw = await readFile(filePath, "utf8");
-    return raw
-      .split("\n")
-      .map((line) => line.trim())
-      .filter(Boolean)
-      .map((line) => JSON.parse(line));
-  } catch (error) {
-    if (error.code === "ENOENT") return [];
-    throw error;
-  }
-}
-
-export async function listFiles(dirPath) {
-  try {
-    return await readdir(dirPath);
-  } catch (error) {
-    if (error.code === "ENOENT") return [];
-    throw error;
-  }
-}
-
-export async function listFilesRecursive(dirPath) {
-  const results = [];
-
-  async function walk(currentPath) {
-    let entries;
-    try {
-      entries = await readdir(currentPath, { withFileTypes: true });
-    } catch (error) {
-      if (error.code === "ENOENT") return;
-      throw error;
-    }
-
-    for (const entry of entries) {
-      const fullPath = path.join(currentPath, entry.name);
-      if (entry.isDirectory()) {
-        await walk(fullPath);
-      } else {
-        results.push(fullPath);
-      }
-    }
-  }
-
-  await walk(dirPath);
-  return results;
-}
-
-export async function resetDir(dirPath) {
-  await rm(dirPath, { recursive: true, force: true });
-}
-
-export async function removePath(targetPath) {
-  await rm(targetPath, { recursive: true, force: true });
-}
-
-export async function statPath(targetPath) {
-  try {
-    return await stat(targetPath);
-  } catch (error) {
-    if (error.code === "ENOENT") return null;
-    throw error;
-  }
-}
+import { mkdir, readFile, writeFile, appendFile, readdir, rm, stat } from "node:fs/promises";
+import path from "node:path";
+
+export async function ensureDir(dirPath) {
+  await mkdir(dirPath, { recursive: true });
+}
+
+export async function readJson(filePath, fallback = null) {
+  try {
+    const raw = await readFile(filePath, "utf8");
+    return JSON.parse(raw);
+  } catch (error) {
+    if (error.code === "ENOENT") return fallback;
+    throw error;
+  }
+}
+
+export async function readText(filePath, fallback = null) {
+  try {
+    return await readFile(filePath, "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") return fallback;
+    throw error;
+  }
+}
+
+export async function writeJson(filePath, value) {
+  await ensureDir(path.dirname(filePath));
+  await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+
+export async function appendJsonLine(filePath, value) {
+  await ensureDir(path.dirname(filePath));
+  await appendFile(filePath, `${JSON.stringify(value)}\n`, "utf8");
+}
+
+export async function readJsonLines(filePath) {
+  try {
+    const raw = await readFile(filePath, "utf8");
+    return raw
+      .split("\n")
+      .map((line) => line.trim())
+      .filter(Boolean)
+      .map((line) => JSON.parse(line));
+  } catch (error) {
+    if (error.code === "ENOENT") return [];
+    throw error;
+  }
+}
+
+export async function listFiles(dirPath) {
+  try {
+    return await readdir(dirPath);
+  } catch (error) {
+    if (error.code === "ENOENT") return [];
+    throw error;
+  }
+}
+
+export async function listFilesRecursive(dirPath) {
+  const results = [];
+
+  async function walk(currentPath) {
+    let entries;
+    try {
+      entries = await readdir(currentPath, { withFileTypes: true });
+    } catch (error) {
+      if (error.code === "ENOENT") return;
+      throw error;
+    }
+
+    for (const entry of entries) {
+      const fullPath = path.join(currentPath, entry.name);
+      if (entry.isDirectory()) {
+        await walk(fullPath);
+      } else {
+        results.push(fullPath);
+      }
+    }
+  }
+
+  await walk(dirPath);
+  return results;
+}
+
+export async function resetDir(dirPath) {
+  await rm(dirPath, { recursive: true, force: true });
+}
+
+export async function removePath(targetPath) {
+  await rm(targetPath, { recursive: true, force: true });
+}
+
+export async function statPath(targetPath) {
+  try {
+    return await stat(targetPath);
+  } catch (error) {
+    if (error.code === "ENOENT") return null;
+    throw error;
+  }
+}

package/src/utils/ids.js

@@ -1,5 +1,5 @@
-import crypto from "node:crypto";
-
-export function createRuntimeId(prefix = "id") {
-  return `${prefix}:${crypto.randomUUID()}`;
-}
+import crypto from "node:crypto";
+
+export function createRuntimeId(prefix = "id") {
+  return `${prefix}:${crypto.randomUUID()}`;
+}

package/src/utils/model-context-limits.js

@@ -1,30 +1,30 @@
-/**
- * Model context window and output token limits by model ID.
- */
-
-/**
- * Return the context window size for a given model ID.
- * @param {string} modelId
- * @returns {number}
- */
-export function getContextLimit(modelId) {
-  const id = String(modelId || "").toLowerCase();
-  if (id.includes("opus") || id.includes("sonnet") || id.includes("haiku")) return 200000;
-  if (id.includes("gpt-4")) return 128000;
-  if (id.includes("gpt-3.5")) return 16000;
-  return 100000;
-}
-
-/**
- * Return the max output tokens for a given model ID.
- * @param {string} modelId
- * @returns {number}
- */
-export function getMaxOutputTokens(modelId) {
-  const id = String(modelId || "").toLowerCase();
-  if (id.includes("anthropic") || id.includes("claude") || id.includes("opus") ||
-      id.includes("sonnet") || id.includes("haiku")) {
-    return 8192;
-  }
-  return 4096;
-}
+/**
+ * Model context window and output token limits by model ID.
+ */
+
+/**
+ * Return the context window size for a given model ID.
+ * @param {string} modelId
+ * @returns {number}
+ */
+export function getContextLimit(modelId) {
+  const id = String(modelId || "").toLowerCase();
+  if (id.includes("opus") || id.includes("sonnet") || id.includes("haiku")) return 200000;
+  if (id.includes("gpt-4")) return 128000;
+  if (id.includes("gpt-3.5")) return 16000;
+  return 100000;
+}
+
+/**
+ * Return the max output tokens for a given model ID.
+ * @param {string} modelId
+ * @returns {number}
+ */
+export function getMaxOutputTokens(modelId) {
+  const id = String(modelId || "").toLowerCase();
+  if (id.includes("anthropic") || id.includes("claude") || id.includes("opus") ||
+      id.includes("sonnet") || id.includes("haiku")) {
+    return 8192;
+  }
+  return 4096;
+}

package/src/utils/token-budget.js

@@ -1,74 +1,74 @@
-/**
- * Token budget utilities — rough estimation and context pruning.
- * Uses character-count heuristic (length / 4) to avoid tiktoken dependency.
- */
-
-/**
- * Estimate token count for an array of messages.
- * @param {Array} messages
- * @returns {number}
- */
-export function estimateTokens(messages) {
-  return Math.ceil(JSON.stringify(messages).length / 4);
-}
-
-/**
- * Prune stale tool_use + tool_result pairs from the start of a message list
- * when the estimated token count exceeds 80% of maxContextTokens.
- * Always preserves the last 4 turns.
- *
- * @param {Array<{role: string, content: any}>} messages
- * @param {number} maxContextTokens
- * @returns {{ pruned: Array, removed: number, estimatedTokens: number }}
- */
-export function pruneContext(messages, maxContextTokens) {
-  const threshold = maxContextTokens * 0.8;
-
-  if (estimateTokens(messages) <= threshold) {
-    return { pruned: messages, removed: 0, estimatedTokens: estimateTokens(messages) };
-  }
-
-  // Identify tool_use + tool_result pair indices, from oldest to newest.
-  // A pair is: assistant turn with tool_use content followed immediately by
-  // user turn with tool_result content.
-  const pairs = [];
-  for (let i = 0; i < messages.length - 1; i++) {
-    const msg = messages[i];
-    const next = messages[i + 1];
-    if (msg.role === "assistant" && isToolUse(msg.content) &&
-        next.role === "user" && isToolResult(next.content)) {
-      pairs.push([i, i + 1]);
-    }
-  }
-
-  const protectedStart = Math.max(0, messages.length - 4);
-  // Only consider pairs where both indices are before the protected zone
-  const pruneable = pairs.filter(([a, b]) => a < protectedStart && b < protectedStart);
-
-  let working = [...messages];
-  let removed = 0;
-
-  for (const [a, b] of pruneable) {
-    if (estimateTokens(working) <= threshold) break;
-    // Adjust indices for previously removed items
-    const adj = a - removed * 2;
-    working.splice(adj, 2);
-    removed++;
-  }
-
-  return { pruned: working, removed, estimatedTokens: estimateTokens(working) };
-}
-
-function isToolUse(content) {
-  if (Array.isArray(content)) {
-    return content.some((c) => c.type === "tool_use");
-  }
-  return false;
-}
-
-function isToolResult(content) {
-  if (Array.isArray(content)) {
-    return content.some((c) => c.type === "tool_result");
-  }
-  return false;
-}
+/**
+ * Token budget utilities — rough estimation and context pruning.
+ * Uses character-count heuristic (length / 4) to avoid tiktoken dependency.
+ */
+
+/**
+ * Estimate token count for an array of messages.
+ * @param {Array} messages
+ * @returns {number}
+ */
+export function estimateTokens(messages) {
+  return Math.ceil(JSON.stringify(messages).length / 4);
+}
+
+/**
+ * Prune stale tool_use + tool_result pairs from the start of a message list
+ * when the estimated token count exceeds 80% of maxContextTokens.
+ * Always preserves the last 4 turns.
+ *
+ * @param {Array<{role: string, content: any}>} messages
+ * @param {number} maxContextTokens
+ * @returns {{ pruned: Array, removed: number, estimatedTokens: number }}
+ */
+export function pruneContext(messages, maxContextTokens) {
+  const threshold = maxContextTokens * 0.8;
+
+  if (estimateTokens(messages) <= threshold) {
+    return { pruned: messages, removed: 0, estimatedTokens: estimateTokens(messages) };
+  }
+
+  // Identify tool_use + tool_result pair indices, from oldest to newest.
+  // A pair is: assistant turn with tool_use content followed immediately by
+  // user turn with tool_result content.
+  const pairs = [];
+  for (let i = 0; i < messages.length - 1; i++) {
+    const msg = messages[i];
+    const next = messages[i + 1];
+    if (msg.role === "assistant" && isToolUse(msg.content) &&
+        next.role === "user" && isToolResult(next.content)) {
+      pairs.push([i, i + 1]);
+    }
+  }
+
+  const protectedStart = Math.max(0, messages.length - 4);
+  // Only consider pairs where both indices are before the protected zone
+  const pruneable = pairs.filter(([a, b]) => a < protectedStart && b < protectedStart);
+
+  let working = [...messages];
+  let removed = 0;
+
+  for (const [a, b] of pruneable) {
+    if (estimateTokens(working) <= threshold) break;
+    // Adjust indices for previously removed items
+    const adj = a - removed * 2;
+    working.splice(adj, 2);
+    removed++;
+  }
+
+  return { pruned: working, removed, estimatedTokens: estimateTokens(working) };
+}
+
+function isToolUse(content) {
+  if (Array.isArray(content)) {
+    return content.some((c) => c.type === "tool_use");
+  }
+  return false;
+}
+
+function isToolResult(content) {
+  if (Array.isArray(content)) {
+    return content.some((c) => c.type === "tool_result");
+  }
+  return false;
+}

package/src/utils/usage-cost.js

@@ -1,25 +1,25 @@
-// Rough cost per 1M tokens (USD) — update as pricing changes
-const COSTS = {
-  "anthropic/claude-sonnet-4-6":  { in: 3.00, out: 15.00 },
-  "anthropic/claude-haiku-4-5":   { in: 0.80, out: 4.00 },
-  "anthropic/claude-opus-4-6":    { in: 15.00, out: 75.00 },
-  "openrouter/anthropic/claude-sonnet-4-6": { in: 3.00, out: 15.00 },
-  "openrouter/anthropic/claude-haiku-4-5":  { in: 0.80, out: 4.00 },
-  "openrouter/anthropic/claude-opus-4-6":   { in: 15.00, out: 75.00 },
-};
-
-/**
- * Estimate the cost of an LLM turn in USD.
- * @param {string} model The model ID (e.g. "anthropic/claude-sonnet-4-6")
- * @param {number} tokensIn Input tokens
- * @param {number} tokensOut Output tokens
- * @returns {number|null} Estimated cost in USD, or null if model unknown
- */
-export function estimateCost(model, tokensIn, tokensOut) {
-  if (typeof model === "string" && model.startsWith("ollama/")) {
-    return 0;
-  }
-  const rates = COSTS[model];
-  if (!rates) return null; // Unknown or unpriced remote models are intentionally left unresolved.
-  return (tokensIn / 1_000_000) * rates.in + (tokensOut / 1_000_000) * rates.out;
-}
+// Rough cost per 1M tokens (USD) — update as pricing changes
+const COSTS = {
+  "anthropic/claude-sonnet-4-6":  { in: 3.00, out: 15.00 },
+  "anthropic/claude-haiku-4-5":   { in: 0.80, out: 4.00 },
+  "anthropic/claude-opus-4-6":    { in: 15.00, out: 75.00 },
+  "openrouter/anthropic/claude-sonnet-4-6": { in: 3.00, out: 15.00 },
+  "openrouter/anthropic/claude-haiku-4-5":  { in: 0.80, out: 4.00 },
+  "openrouter/anthropic/claude-opus-4-6":   { in: 15.00, out: 75.00 },
+};
+
+/**
+ * Estimate the cost of an LLM turn in USD.
+ * @param {string} model The model ID (e.g. "anthropic/claude-sonnet-4-6")
+ * @param {number} tokensIn Input tokens
+ * @param {number} tokensOut Output tokens
+ * @returns {number|null} Estimated cost in USD, or null if model unknown
+ */
+export function estimateCost(model, tokensIn, tokensOut) {
+  if (typeof model === "string" && model.startsWith("ollama/")) {
+    return 0;
+  }
+  const rates = COSTS[model];
+  if (!rates) return null; // Unknown or unpriced remote models are intentionally left unresolved.
+  return (tokensIn / 1_000_000) * rates.in + (tokensOut / 1_000_000) * rates.out;
+}

package/src/utils/usage-metrics.js

@@ -1,14 +1,14 @@
-export function extractUsageMetrics(rawResponse) {
-  return {
-    tokensIn: rawResponse?.usage?.input_tokens
-      || rawResponse?.usage?.prompt_tokens
-      || 0,
-    tokensOut: rawResponse?.usage?.output_tokens
-      || rawResponse?.usage?.completion_tokens
-      || 0,
-    cacheIn: rawResponse?.usage?.cache_read_input_tokens
-      || rawResponse?.usage?.prompt_tokens_details?.cached_tokens
-      || 0,
-    cacheCreation: rawResponse?.usage?.cache_creation_input_tokens || 0,
-  };
-}
+export function extractUsageMetrics(rawResponse) {
+  return {
+    tokensIn: rawResponse?.usage?.input_tokens
+      || rawResponse?.usage?.prompt_tokens
+      || 0,
+    tokensOut: rawResponse?.usage?.output_tokens
+      || rawResponse?.usage?.completion_tokens
+      || 0,
+    cacheIn: rawResponse?.usage?.cache_read_input_tokens
+      || rawResponse?.usage?.prompt_tokens_details?.cached_tokens
+      || 0,
+    cacheCreation: rawResponse?.usage?.cache_creation_input_tokens || 0,
+  };
+}