@within-7/minto 0.4.1 → 0.4.3

package/dist/utils/agentMemory.js

@@ -1,134 +0,0 @@
-import {
-  existsSync,
-  readFileSync,
-  writeFileSync,
-  mkdirSync,
-  unlinkSync
-} from "fs";
-import { join, dirname } from "path";
-import { homedir } from "os";
-import { getCwd } from "./state.js";
-function getMemoryBasePath(scope) {
-  const cwd = getCwd();
-  switch (scope) {
-    case "user":
-      return join(homedir(), ".minto", "memory");
-    case "project":
-      return join(cwd, ".minto", "memory");
-    case "local":
-      return join(cwd, ".minto", ".memory");
-    // Gitignored by convention
-    default:
-      return join(cwd, ".minto", "memory");
-  }
-}
-function getMemoryFilePath(agentType, memory) {
-  const basePath = getMemoryBasePath(memory.scope);
-  const key = memory.key || agentType;
-  const sanitizedKey = key.replace(/[^a-zA-Z0-9_-]/g, "_");
-  return join(basePath, `${sanitizedKey}.json`);
-}
-async function loadAgentMemory(agentType, memory) {
-  const filePath = getMemoryFilePath(agentType, memory);
-  if (!existsSync(filePath)) {
-    return null;
-  }
-  try {
-    const data = JSON.parse(readFileSync(filePath, "utf-8"));
-    return data.content;
-  } catch (error) {
-    console.warn(`Failed to load agent memory from ${filePath}:`, error);
-    return null;
-  }
-}
-async function saveAgentMemory(agentType, memory, content) {
-  const filePath = getMemoryFilePath(agentType, memory);
-  const dirPath = dirname(filePath);
-  try {
-    if (!existsSync(dirPath)) {
-      mkdirSync(dirPath, { recursive: true });
-    }
-    let version = 1;
-    if (existsSync(filePath)) {
-      try {
-        const existing = JSON.parse(
-          readFileSync(filePath, "utf-8")
-        );
-        version = (existing.version || 0) + 1;
-      } catch {
-      }
-    }
-    const entry = {
-      content,
-      updatedAt: Date.now(),
-      agentType,
-      version
-    };
-    writeFileSync(filePath, JSON.stringify(entry, null, 2), "utf-8");
-  } catch (error) {
-    console.error(`Failed to save agent memory to ${filePath}:`, error);
-    throw error;
-  }
-}
-async function deleteAgentMemory(agentType, memory) {
-  const filePath = getMemoryFilePath(agentType, memory);
-  if (existsSync(filePath)) {
-    try {
-      unlinkSync(filePath);
-    } catch (error) {
-      console.warn(`Failed to delete agent memory at ${filePath}:`, error);
-    }
-  }
-}
-function hasAgentMemory(agentType, memory) {
-  const filePath = getMemoryFilePath(agentType, memory);
-  return existsSync(filePath);
-}
-async function getAgentMemoryMetadata(agentType, memory) {
-  const filePath = getMemoryFilePath(agentType, memory);
-  if (!existsSync(filePath)) {
-    return null;
-  }
-  try {
-    const data = JSON.parse(readFileSync(filePath, "utf-8"));
-    return {
-      updatedAt: data.updatedAt,
-      version: data.version
-    };
-  } catch {
-    return null;
-  }
-}
-function formatMemoryForPrompt(content, agentType) {
-  return `
-<agent-memory agent="${agentType}">
-${content}
-</agent-memory>
-`;
-}
-function ensureLocalMemoryGitignored() {
-  const cwd = getCwd();
-  const gitignorePath = join(cwd, ".gitignore");
-  const memoryPattern = ".minto/.memory";
-  try {
-    if (existsSync(gitignorePath)) {
-      const content = readFileSync(gitignorePath, "utf-8");
-      if (!content.includes(memoryPattern)) {
-        console.debug(
-          `Consider adding '${memoryPattern}' to .gitignore for local agent memory`
-        );
-      }
-    }
-  } catch {
-  }
-}
-export {
-  deleteAgentMemory,
-  ensureLocalMemoryGitignored,
-  formatMemoryForPrompt,
-  getAgentMemoryMetadata,
-  hasAgentMemory,
-  loadAgentMemory,
-  saveAgentMemory
-};
-//# sourceMappingURL=agentMemory.js.map

package/dist/utils/agentMemory.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/utils/agentMemory.ts"],
-  "sourcesContent": ["/**\n * Agent Memory Persistence\n *\n * Implements Claude Code specification for agent memory persistence.\n * Supports three scopes:\n * - user: ~/.minto/memory/ (persists across all projects)\n * - project: ./.minto/memory/ (persists within project, tracked in git)\n * - local: ./.minto/.memory/ (persists within project, gitignored)\n */\n\nimport {\n  existsSync,\n  readFileSync,\n  writeFileSync,\n  mkdirSync,\n  unlinkSync,\n} from 'fs'\nimport { join, dirname } from 'path'\nimport { homedir } from 'os'\nimport { getCwd } from './state'\nimport type { AgentMemory } from './agentLoader'\n\n/**\n * Memory entry structure\n */\ninterface MemoryEntry {\n  content: string\n  updatedAt: number\n  agentType: string\n  version: number\n}\n\n/**\n * Get the base path for memory storage based on scope\n */\nfunction getMemoryBasePath(scope: AgentMemory['scope']): string {\n  const cwd = getCwd()\n\n  switch (scope) {\n    case 'user':\n      return join(homedir(), '.minto', 'memory')\n    case 'project':\n      return join(cwd, '.minto', 'memory')\n    case 'local':\n      return join(cwd, '.minto', '.memory') // Gitignored by convention\n    default:\n      return join(cwd, '.minto', 'memory')\n  }\n}\n\n/**\n * Get the full path for a memory file\n */\nfunction getMemoryFilePath(agentType: string, memory: AgentMemory): string {\n  const basePath = getMemoryBasePath(memory.scope)\n  const key = memory.key || agentType\n  // Sanitize key to be a valid filename\n  const sanitizedKey = key.replace(/[^a-zA-Z0-9_-]/g, '_')\n  return join(basePath, `${sanitizedKey}.json`)\n}\n\n/**\n * Load agent memory from persistent storage\n *\n * @param agentType - The agent type identifier\n * @param memory - Memory configuration\n * @returns Memory content if found, null otherwise\n */\nexport async function loadAgentMemory(\n  agentType: string,\n  memory: AgentMemory,\n): Promise<string | null> {\n  const filePath = getMemoryFilePath(agentType, memory)\n\n  if (!existsSync(filePath)) {\n    return null\n  }\n\n  try {\n    const data = JSON.parse(readFileSync(filePath, 'utf-8')) as MemoryEntry\n    return data.content\n  } catch (error) {\n    console.warn(`Failed to load agent memory from ${filePath}:`, error)\n    return null\n  }\n}\n\n/**\n * Save agent memory to persistent storage\n *\n * @param agentType - The agent type identifier\n * @param memory - Memory configuration\n * @param content - Content to save\n */\nexport async function saveAgentMemory(\n  agentType: string,\n  memory: AgentMemory,\n  content: string,\n): Promise<void> {\n  const filePath = getMemoryFilePath(agentType, memory)\n  const dirPath = dirname(filePath)\n\n  try {\n    // Ensure directory exists\n    if (!existsSync(dirPath)) {\n      mkdirSync(dirPath, { recursive: true })\n    }\n\n    // Load existing entry to preserve version\n    let version = 1\n    if (existsSync(filePath)) {\n      try {\n        const existing = JSON.parse(\n          readFileSync(filePath, 'utf-8'),\n        ) as MemoryEntry\n        version = (existing.version || 0) + 1\n      } catch {\n        // Ignore parse errors, start fresh\n      }\n    }\n\n    const entry: MemoryEntry = {\n      content,\n      updatedAt: Date.now(),\n      agentType,\n      version,\n    }\n\n    writeFileSync(filePath, JSON.stringify(entry, null, 2), 'utf-8')\n  } catch (error) {\n    console.error(`Failed to save agent memory to ${filePath}:`, error)\n    throw error\n  }\n}\n\n/**\n * Delete agent memory from persistent storage\n *\n * @param agentType - The agent type identifier\n * @param memory - Memory configuration\n */\nexport async function deleteAgentMemory(\n  agentType: string,\n  memory: AgentMemory,\n): Promise<void> {\n  const filePath = getMemoryFilePath(agentType, memory)\n\n  if (existsSync(filePath)) {\n    try {\n      unlinkSync(filePath)\n    } catch (error) {\n      console.warn(`Failed to delete agent memory at ${filePath}:`, error)\n    }\n  }\n}\n\n/**\n * Check if agent memory exists\n *\n * @param agentType - The agent type identifier\n * @param memory - Memory configuration\n * @returns True if memory exists\n */\nexport function hasAgentMemory(\n  agentType: string,\n  memory: AgentMemory,\n): boolean {\n  const filePath = getMemoryFilePath(agentType, memory)\n  return existsSync(filePath)\n}\n\n/**\n * Get memory metadata without loading content\n *\n * @param agentType - The agent type identifier\n * @param memory - Memory configuration\n * @returns Metadata if found, null otherwise\n */\nexport async function getAgentMemoryMetadata(\n  agentType: string,\n  memory: AgentMemory,\n): Promise<{ updatedAt: number; version: number } | null> {\n  const filePath = getMemoryFilePath(agentType, memory)\n\n  if (!existsSync(filePath)) {\n    return null\n  }\n\n  try {\n    const data = JSON.parse(readFileSync(filePath, 'utf-8')) as MemoryEntry\n    return {\n      updatedAt: data.updatedAt,\n      version: data.version,\n    }\n  } catch {\n    return null\n  }\n}\n\n/**\n * Format memory content for injection into system prompt\n *\n * @param content - Memory content\n * @param agentType - Agent type for context\n * @returns Formatted memory section for system prompt\n */\nexport function formatMemoryForPrompt(\n  content: string,\n  agentType: string,\n): string {\n  return `\n<agent-memory agent=\"${agentType}\">\n${content}\n</agent-memory>\n`\n}\n\n/**\n * Ensure the .memory directory is gitignored for 'local' scope\n * This should be called once during initialization\n */\nexport function ensureLocalMemoryGitignored(): void {\n  const cwd = getCwd()\n  const gitignorePath = join(cwd, '.gitignore')\n  const memoryPattern = '.minto/.memory'\n\n  try {\n    if (existsSync(gitignorePath)) {\n      const content = readFileSync(gitignorePath, 'utf-8')\n      if (!content.includes(memoryPattern)) {\n        // Could optionally append to .gitignore, but for now just warn\n        console.debug(\n          `Consider adding '${memoryPattern}' to .gitignore for local agent memory`,\n        )\n      }\n    }\n  } catch {\n    // Ignore errors reading .gitignore\n  }\n}\n"],
-  "mappings": "AAUA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,MAAM,eAAe;AAC9B,SAAS,eAAe;AACxB,SAAS,cAAc;AAgBvB,SAAS,kBAAkB,OAAqC;AAC9D,QAAM,MAAM,OAAO;AAEnB,UAAQ,OAAO;AAAA,IACb,KAAK;AACH,aAAO,KAAK,QAAQ,GAAG,UAAU,QAAQ;AAAA,IAC3C,KAAK;AACH,aAAO,KAAK,KAAK,UAAU,QAAQ;AAAA,IACrC,KAAK;AACH,aAAO,KAAK,KAAK,UAAU,SAAS;AAAA;AAAA,IACtC;AACE,aAAO,KAAK,KAAK,UAAU,QAAQ;AAAA,EACvC;AACF;AAKA,SAAS,kBAAkB,WAAmB,QAA6B;AACzE,QAAM,WAAW,kBAAkB,OAAO,KAAK;AAC/C,QAAM,MAAM,OAAO,OAAO;AAE1B,QAAM,eAAe,IAAI,QAAQ,mBAAmB,GAAG;AACvD,SAAO,KAAK,UAAU,GAAG,YAAY,OAAO;AAC9C;AASA,eAAsB,gBACpB,WACA,QACwB;AACxB,QAAM,WAAW,kBAAkB,WAAW,MAAM;AAEpD,MAAI,CAAC,WAAW,QAAQ,GAAG;AACzB,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,OAAO,KAAK,MAAM,aAAa,UAAU,OAAO,CAAC;AACvD,WAAO,KAAK;AAAA,EACd,SAAS,OAAO;AACd,YAAQ,KAAK,oCAAoC,QAAQ,KAAK,KAAK;AACnE,WAAO;AAAA,EACT;AACF;AASA,eAAsB,gBACpB,WACA,QACA,SACe;AACf,QAAM,WAAW,kBAAkB,WAAW,MAAM;AACpD,QAAM,UAAU,QAAQ,QAAQ;AAEhC,MAAI;AAEF,QAAI,CAAC,WAAW,OAAO,GAAG;AACxB,gBAAU,SAAS,EAAE,WAAW,KAAK,CAAC;AAAA,IACxC;AAGA,QAAI,UAAU;AACd,QAAI,WAAW,QAAQ,GAAG;AACxB,UAAI;AACF,cAAM,WAAW,KAAK;AAAA,UACpB,aAAa,UAAU,OAAO;AAAA,QAChC;AACA,mBAAW,SAAS,WAAW,KAAK;AAAA,MACtC,QAAQ;AAAA,MAER;AAAA,IACF;AAEA,UAAM,QAAqB;AAAA,MACzB;AAAA,MACA,WAAW,KAAK,IAAI;AAAA,MACpB;AAAA,MACA;AAAA,IACF;AAEA,kBAAc,UAAU,KAAK,UAAU,OAAO,MAAM,CAAC,GAAG,OAAO;AAAA,EACjE,SAAS,OAAO;AACd,YAAQ,MAAM,kCAAkC,QAAQ,KAAK,KAAK;AAClE,UAAM;AAAA,EACR;AACF;AAQA,eAAsB,kBACpB,WACA,QACe;AACf,QAAM,WAAW,kBAAkB,WAAW,MAAM;AAEpD,MAAI,WAAW,QAAQ,GAAG;AACxB,QAAI;AACF,iBAAW,QAAQ;AAAA,IACrB,SAAS,OAAO;AACd,cAAQ,KAAK,oCAAoC,QAAQ,KAAK,KAAK;AAAA,IACrE;AAAA,EACF;AACF;AASO,SAAS,eACd,WACA,QACS;AACT,QAAM,WAAW,kBAAkB,WAAW,MAAM;AACpD,SAAO,WAAW,QAAQ;AAC5B;AASA,eAAsB,uBACpB,WACA,QACwD;AACxD,QAAM,WAAW,kBAAkB,WAAW,MAAM;AAEpD,MAAI,CAAC,WAAW,QAAQ,GAAG;AACzB,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,OAAO,KAAK,MAAM,aAAa,UAAU,OAAO,CAAC;AACvD,WAAO;AAAA,MACL,WAAW,KAAK;AAAA,MAChB,SAAS,KAAK;AAAA,IAChB;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AASO,SAAS,sBACd,SACA,WACQ;AACR,SAAO;AAAA,uBACc,SAAS;AAAA,EAC9B,OAAO;AAAA;AAAA;AAGT;AAMO,SAAS,8BAAoC;AAClD,QAAM,MAAM,OAAO;AACnB,QAAM,gBAAgB,KAAK,KAAK,YAAY;AAC5C,QAAM,gBAAgB;AAEtB,MAAI;AACF,QAAI,WAAW,aAAa,GAAG;AAC7B,YAAM,UAAU,aAAa,eAAe,OAAO;AACnD,UAAI,CAAC,QAAQ,SAAS,aAAa,GAAG;AAEpC,gBAAQ;AAAA,UACN,oBAAoB,aAAa;AAAA,QACnC;AAAA,MACF;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAER;AACF;",
-  "names": []
-}

package/dist/utils/agentStorage.js

@@ -1,59 +0,0 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
-import { join } from "path";
-import { homedir } from "os";
-import { randomUUID } from "crypto";
-function getConfigDirectory() {
-  return process.env.MINTO_CONFIG_DIR ?? process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), ".minto");
-}
-function getSessionId() {
-  return process.env.MINTO_SESSION_ID ?? "default-session";
-}
-function getAgentFilePath(agentId) {
-  const sessionId = getSessionId();
-  const filename = `${sessionId}-agent-${agentId}.json`;
-  const configDir = getConfigDirectory();
-  if (!existsSync(configDir)) {
-    mkdirSync(configDir, { recursive: true });
-  }
-  return join(configDir, filename);
-}
-function readAgentData(agentId) {
-  const filePath = getAgentFilePath(agentId);
-  if (!existsSync(filePath)) {
-    return null;
-  }
-  try {
-    const content = readFileSync(filePath, "utf-8");
-    return JSON.parse(content);
-  } catch (error) {
-    console.error(`Failed to read agent data for ${agentId}:`, error);
-    return null;
-  }
-}
-function writeAgentData(agentId, data) {
-  const filePath = getAgentFilePath(agentId);
-  try {
-    writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
-  } catch (error) {
-    console.error(`Failed to write agent data for ${agentId}:`, error);
-    throw error;
-  }
-}
-function getDefaultAgentId() {
-  return "default";
-}
-function resolveAgentId(agentId) {
-  return agentId || getDefaultAgentId();
-}
-function generateAgentId() {
-  return randomUUID();
-}
-export {
-  generateAgentId,
-  getAgentFilePath,
-  getDefaultAgentId,
-  readAgentData,
-  resolveAgentId,
-  writeAgentData
-};
-//# sourceMappingURL=agentStorage.js.map

package/dist/utils/agentStorage.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/utils/agentStorage.ts"],
-  "sourcesContent": ["import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs'\nimport { join } from 'path'\nimport { homedir } from 'os'\nimport { randomUUID } from 'crypto'\n\n/**\n * Agent Storage Utilities\n * Provides file-based state isolation for different agents\n * Based on Minto's Agent ID architecture\n */\n\n/**\n * Get the minto config directory\n * Priority: MINTO_CONFIG_DIR > CLAUDE_CONFIG_DIR > ~/.minto\n */\nfunction getConfigDirectory(): string {\n  return (\n    process.env.MINTO_CONFIG_DIR ??\n    process.env.CLAUDE_CONFIG_DIR ??\n    join(homedir(), '.minto')\n  )\n}\n\n/**\n * Get the current session ID\n */\nfunction getSessionId(): string {\n  // This should be set when the session starts\n  return process.env.MINTO_SESSION_ID ?? 'default-session'\n}\n\n/**\n * Generate agent-specific file path\n * Pattern: ${sessionId}-agent-${agentId}.json\n * Stored in ~/.minto/ directory\n */\nexport function getAgentFilePath(agentId: string): string {\n  const sessionId = getSessionId()\n  const filename = `${sessionId}-agent-${agentId}.json`\n  const configDir = getConfigDirectory()\n\n  // Ensure minto config directory exists\n  if (!existsSync(configDir)) {\n    mkdirSync(configDir, { recursive: true })\n  }\n\n  return join(configDir, filename)\n}\n\n/**\n * Read agent-specific data from storage\n */\nexport function readAgentData<T = any>(agentId: string): T | null {\n  const filePath = getAgentFilePath(agentId)\n\n  if (!existsSync(filePath)) {\n    return null\n  }\n\n  try {\n    const content = readFileSync(filePath, 'utf-8')\n    return JSON.parse(content) as T\n  } catch (error) {\n    console.error(`Failed to read agent data for ${agentId}:`, error)\n    return null\n  }\n}\n\n/**\n * Write agent-specific data to storage\n */\nexport function writeAgentData<T = any>(agentId: string, data: T): void {\n  const filePath = getAgentFilePath(agentId)\n\n  try {\n    writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8')\n  } catch (error) {\n    console.error(`Failed to write agent data for ${agentId}:`, error)\n    throw error\n  }\n}\n\n/**\n * Get default agent ID if none is provided\n */\nexport function getDefaultAgentId(): string {\n  return 'default'\n}\n\n/**\n * Resolve agent ID from context\n */\nexport function resolveAgentId(agentId?: string): string {\n  return agentId || getDefaultAgentId()\n}\n\n/**\n * Generate a new unique Agent ID\n */\nexport function generateAgentId(): string {\n  return randomUUID()\n}\n"],
-  "mappings": "AAAA,SAAS,YAAY,cAAc,eAAe,iBAAiB;AACnE,SAAS,YAAY;AACrB,SAAS,eAAe;AACxB,SAAS,kBAAkB;AAY3B,SAAS,qBAA6B;AACpC,SACE,QAAQ,IAAI,oBACZ,QAAQ,IAAI,qBACZ,KAAK,QAAQ,GAAG,QAAQ;AAE5B;AAKA,SAAS,eAAuB;AAE9B,SAAO,QAAQ,IAAI,oBAAoB;AACzC;AAOO,SAAS,iBAAiB,SAAyB;AACxD,QAAM,YAAY,aAAa;AAC/B,QAAM,WAAW,GAAG,SAAS,UAAU,OAAO;AAC9C,QAAM,YAAY,mBAAmB;AAGrC,MAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,cAAU,WAAW,EAAE,WAAW,KAAK,CAAC;AAAA,EAC1C;AAEA,SAAO,KAAK,WAAW,QAAQ;AACjC;AAKO,SAAS,cAAuB,SAA2B;AAChE,QAAM,WAAW,iBAAiB,OAAO;AAEzC,MAAI,CAAC,WAAW,QAAQ,GAAG;AACzB,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,UAAU,aAAa,UAAU,OAAO;AAC9C,WAAO,KAAK,MAAM,OAAO;AAAA,EAC3B,SAAS,OAAO;AACd,YAAQ,MAAM,iCAAiC,OAAO,KAAK,KAAK;AAChE,WAAO;AAAA,EACT;AACF;AAKO,SAAS,eAAwB,SAAiB,MAAe;AACtE,QAAM,WAAW,iBAAiB,OAAO;AAEzC,MAAI;AACF,kBAAc,UAAU,KAAK,UAAU,MAAM,MAAM,CAAC,GAAG,OAAO;AAAA,EAChE,SAAS,OAAO;AACd,YAAQ,MAAM,kCAAkC,OAAO,KAAK,KAAK;AACjE,UAAM;AAAA,EACR;AACF;AAKO,SAAS,oBAA4B;AAC1C,SAAO;AACT;AAKO,SAAS,eAAe,SAA0B;AACvD,SAAO,WAAW,kBAAkB;AACtC;AAKO,SAAS,kBAA0B;AACxC,SAAO,WAAW;AACpB;",
-  "names": []
-}