@mnemom/mnemom 0.7.2 → 0.9.0

package/dist/lib/config.js

@@ -1,9 +1,14 @@
-import * as fs from "node:fs";
+/**
+ * Environment resolution and URL constants.
+ *
+ * UC-9 simplification: this module no longer manages a config file.
+ * Auth tokens live in auth.ts → ~/.mnemom/auth.json.
+ * Agent resolution is server-side via api.ts → resolveAgentId().
+ */
 import * as path from "node:path";
 import * as os from "node:os";
-import * as crypto from "node:crypto";
-export const CONFIG_DIR = path.join(os.homedir(), ".smoltbot");
-export const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+/** Base directory for mnemom CLI state (auth tokens, caches). */
+export const MNEMOM_DIR = path.join(os.homedir(), ".mnemom");
 const API_URLS = {
     production: "https://api.mnemom.ai",
     staging: "https://api-staging.mnemom.ai",
@@ -20,14 +25,11 @@ const WEBSITE_URLS = {
     local: "http://localhost:5173",
 };
 /**
- * Resolve the active environment.
- *
- * Resolution order:
- *  1. `SMOLTBOT_ENV` environment variable
- *  2. Defaults to `production`
+ * Resolve the active environment from MNEMOM_ENV.
+ * Defaults to production.
  */
 export function getEnvironment() {
-    const env = process.env.SMOLTBOT_ENV;
+    const env = process.env.MNEMOM_ENV;
     if (env === "staging" || env === "local")
         return env;
     return "production";
@@ -41,213 +43,3 @@ export function getGatewayUrl() {
 export function getWebsiteUrl() {
     return WEBSITE_URLS[getEnvironment()];
 }
-// ---------------------------------------------------------------------------
-// Migration
-// ---------------------------------------------------------------------------
-/**
- * Migrate a v1 config into v2 format.
- * All agent-specific fields move into `agents.default`.
- */
-export function migrateConfig(raw) {
-    return {
-        version: 2,
-        defaultAgent: "default",
-        gateway: raw.gateway ?? "https://gateway.mnemom.ai",
-        mnemomApiKey: raw.mnemomApiKey,
-        licenseJwt: raw.licenseJwt,
-        agents: {
-            default: {
-                agentId: raw.agentId,
-                openclawConfigured: raw.openclawConfigured,
-                providers: raw.providers,
-                configuredAt: raw.configuredAt,
-            },
-        },
-    };
-}
-// ---------------------------------------------------------------------------
-// Persistence
-// ---------------------------------------------------------------------------
-export function configExists() {
-    return fs.existsSync(CONFIG_FILE);
-}
-/**
- * Load the config file.
- * If the file is v1 (no `version` field), it is automatically migrated to v2
- * and written back to disk before returning.
- */
-export function loadConfig() {
-    if (!configExists()) {
-        return null;
-    }
-    try {
-        const content = fs.readFileSync(CONFIG_FILE, "utf-8");
-        const raw = JSON.parse(content);
-        // Detect v1: no `version` field present
-        if (!raw.version) {
-            const migrated = migrateConfig(raw);
-            saveConfig(migrated);
-            return migrated;
-        }
-        return raw;
-    }
-    catch {
-        return null;
-    }
-}
-export function saveConfig(config) {
-    if (!fs.existsSync(CONFIG_DIR)) {
-        fs.mkdirSync(CONFIG_DIR, { recursive: true });
-    }
-    // Validate write path stays within expected directory
-    const resolvedPath = path.resolve(CONFIG_FILE);
-    if (!resolvedPath.startsWith(path.resolve(CONFIG_DIR))) {
-        throw new Error("Config file path escapes expected directory");
-    }
-    // Re-serialize to sanitize any HTTP-sourced data before writing to disk
-    const sanitizedConfig = JSON.parse(JSON.stringify(config));
-    const tmpFile = `${resolvedPath}.${process.pid}.tmp`;
-    fs.writeFileSync(tmpFile, JSON.stringify(sanitizedConfig, null, 2));
-    fs.renameSync(tmpFile, resolvedPath);
-}
-// ---------------------------------------------------------------------------
-// Agent resolution
-// ---------------------------------------------------------------------------
-/**
- * Resolve the active agent config.
- *
- * Resolution order:
- *  1. Explicit `agentName` parameter (--agent flag)
- *  2. `SMOLTBOT_AGENT` environment variable
- *
- * Returns `null` if no agent is specified or the agent is not found.
- * Callers must require --agent or SMOLTBOT_AGENT for agent-scoped commands.
- */
-export function getActiveAgent(agentName) {
-    const config = loadConfig();
-    if (!config) {
-        return null;
-    }
-    const name = agentName ??
-        process.env.SMOLTBOT_AGENT;
-    if (!name) {
-        return null;
-    }
-    return config.agents[name] ?? null;
-}
-/**
- * Require an explicit agent selection. Exits with a helpful error if
- * no agent was specified via --agent or SMOLTBOT_AGENT.
- *
- * Falls back to API lookup if the agent is not in local config:
- *  - smolt-XXXXXXXX IDs: public endpoint, no auth required
- *  - Names: authenticated account listing (requires `smoltbot login`)
- */
-export async function requireAgent(agentName) {
-    if (!configExists()) {
-        console.error("\nsmoltbot is not initialized. Run `smoltbot init` first.\n");
-        process.exit(1);
-    }
-    // Fast path: local config hit — no network call needed
-    const localAgent = getActiveAgent(agentName);
-    if (localAgent)
-        return localAgent;
-    const name = agentName ?? process.env.SMOLTBOT_AGENT;
-    if (!name) {
-        console.error("\nAgent required. Use --agent <name> or set SMOLTBOT_AGENT.\n");
-        console.error("Available agents:");
-        const config = loadConfig();
-        if (config) {
-            for (const [n, a] of Object.entries(config.agents)) {
-                console.error(`  ${n} (${a.agentId})`);
-            }
-        }
-        console.error();
-        process.exit(1);
-    }
-    // API fallback: resolve from account
-    try {
-        const { getAgent, getAgentByName } = await import("./api.js");
-        let found = null;
-        if (/^smolt-[0-9a-f]{8}$/.test(name)) {
-            // Public endpoint — no auth needed
-            found = await getAgent(name);
-        }
-        else {
-            found = await getAgentByName(name);
-        }
-        if (found) {
-            return { agentId: found.id };
-        }
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        if (msg.includes("Not logged in")) {
-            console.error(`\n${msg}\n`);
-            process.exit(1);
-        }
-        // Other API errors: fall through to "not found" message
-    }
-    console.error(`\nAgent not found: ${name}`);
-    console.error(`Run \`smoltbot agents add ${name}\` to register it locally,`);
-    console.error(`or check \`smoltbot agents\` to see agents in your account.\n`);
-    process.exit(1);
-}
-// ---------------------------------------------------------------------------
-// ID generation
-// ---------------------------------------------------------------------------
-export function generateAgentId() {
-    // New format per ADR-019 (scale/step-25b): mnm-{uuid_v4} for all new agents.
-    // crypto.randomUUID() is a Node.js built-in (>=14.17), no new dependencies.
-    return `mnm-${crypto.randomUUID()}`;
-}
-/**
- * Compute the 16-char agent_hash for a given API key and optional agent name.
- * Matches the gateway's hashApiKey() and the POST /v1/agents/:id/rekey expected format.
- *
- * Unnamed agent:  SHA256(apiKey).slice(0, 16)
- * Named agent:    SHA256(apiKey + '|' + name).slice(0, 16)
- */
-export function computeAgentHash(apiKey, name) {
-    const input = name ? `${apiKey}|${name}` : apiKey;
-    // eslint-disable-next-line -- deterministic ID derivation must match gateway SHA-256
-    return crypto.createHash("sha256").update(input).digest("hex").slice(0, 16); // lgtm[js/insufficient-password-hash]
-}
-/**
- * Derive agent ID deterministically from an API key.
- * Uses SHA-256 to match the gateway's hashApiKey (Web Crypto SHA-256, first 16 hex chars).
- * The agent ID is "smolt-" + first 8 hex chars of the SHA-256 digest.
- */
-export function deriveAgentId(apiKey) {
-    return `smolt-${computeAgentHash(apiKey).slice(0, 8)}`;
-}
-/**
- * Derive agent ID deterministically from an API key *and* a name.
- * Allows multiple named agents to share one API key with distinct IDs.
- * Uses SHA-256 to match the gateway's hashApiKey(apiKey + '|' + name).
- */
-export function deriveAgentIdWithName(apiKey, name) {
-    return `smolt-${computeAgentHash(apiKey, name).slice(0, 8)}`;
-}
-// ---------------------------------------------------------------------------
-// Auth token helpers
-// ---------------------------------------------------------------------------
-export function saveAuthTokens(tokens) {
-    const config = loadConfig();
-    if (!config) {
-        throw new Error("Config not initialized. Run `smoltbot init` first.");
-    }
-    config.auth = tokens;
-    saveConfig(config);
-}
-export function clearAuthTokens() {
-    const config = loadConfig();
-    if (!config)
-        return;
-    delete config.auth;
-    saveConfig(config);
-}
-export function getAuthInfo() {
-    const config = loadConfig();
-    return config?.auth ?? null;
-}

package/dist/lib/model-cache.js

@@ -1,9 +1,8 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
-import * as os from "node:os";
 import { MODEL_REGISTRY, getModelDefinition as getStaticModelDefinition } from "./models.js";
-const SMOLTBOT_DIR = path.join(os.homedir(), ".smoltbot");
-const CACHE_FILE = path.join(SMOLTBOT_DIR, "models-cache.json");
+import { MNEMOM_DIR } from "./config.js";
+const CACHE_FILE = path.join(MNEMOM_DIR, "models-cache.json");
 const MODELS_URL = "https://gateway.mnemom.ai/models.json";
 const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
 /**
@@ -36,12 +35,12 @@ function saveCache(models) {
         return;
     }
     // Ensure directory exists
-    if (!fs.existsSync(SMOLTBOT_DIR)) {
-        fs.mkdirSync(SMOLTBOT_DIR, { recursive: true });
+    if (!fs.existsSync(MNEMOM_DIR)) {
+        fs.mkdirSync(MNEMOM_DIR, { recursive: true });
     }
     // Validate write path stays within expected directory
     const resolvedCachePath = path.resolve(CACHE_FILE);
-    if (!resolvedCachePath.startsWith(path.resolve(SMOLTBOT_DIR))) {
+    if (!resolvedCachePath.startsWith(path.resolve(MNEMOM_DIR))) {
         throw new Error("Cache file path escapes expected directory");
     }
     // Re-serialize HTTP-sourced data to sanitize before writing to disk

package/dist/smoltbot-shim.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // smoltbot is deprecated — this shim prints a warning then hands off to mnemom
 process.stderr.write('\n⚠️  The smoltbot command is deprecated. Use mnemom instead.\n' +
-    '   Run: mnemom migrate-config   (updates your OpenClaw provider config)\n\n');
+    '   Install: npm install -g @mnemom/mnemom\n\n');
 // Dynamic import runs index.ts which calls program.parse(process.argv) automatically
 await import('./index.js');
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mnemom/mnemom",
-  "version": "0.7.2",
-  "description": "Transparent AI agent tracing - AAP compliant",
+  "version": "0.9.0",
+  "description": "Transparent AI agent tracing",
   "type": "module",
   "bin": {
     "mnemom": "./dist/index.js",

package/dist/commands/init.d.ts

@@ -1,7 +0,0 @@
-export interface InitOptions {
-    yes?: boolean;
-    force?: boolean;
-    openclaw?: boolean;
-    standalone?: boolean;
-}
-export declare function initCommand(options?: InitOptions): Promise<void>;