anantham-v2 2.0.2 → 2.0.4

package/dist/bin/anantham.js

@@ -53,6 +53,14 @@ async function main() {
         else if (arg === "--session" && args[i + 1]) {
             initialSessionId = args[++i];
         }
+        else if (arg === "--logo" && args[i + 1]) {
+            const customLogo = args[++i];
+            process.env.ANANTHAM_LOGO_PATH = customLogo;
+            try {
+                UserConfigManager.getInstance().setLogoPath(customLogo);
+            }
+            catch { }
+        }
         else if (arg === "--help" || arg === "-h") {
             console.log(`
 Anantham V2 — Programmable AI Agent Operating Environment
@@ -68,13 +76,14 @@ Options:
   -e, --eval <cmd>  Execute single slash command and exit
   --project <id>    Initial active project ID
   --session <id>    Initial active session ID
+  --logo <path>     Custom logo image path (PNG/Sixel/ANSI)
   -h, --help        Show this help message
   -v, --version     Show runtime version
       `);
             process.exit(0);
         }
         else if (arg === "--version" || arg === "-v") {
-            console.log("2.0.2");
+            console.log("2.0.4");
             process.exit(0);
         }
         else if (!arg.startsWith("-") && !executeCmd) {

package/dist/bin/anantham.js.map

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

package/dist/cli/command-registry.d.ts

@@ -10,6 +10,7 @@ import { SessionResumeEngine } from "../resume/session-resume-engine.js";
 import { ToolRegistry } from "../tools/tool-registry.js";
 import { PolicyEngine } from "../policy/policy-engine.js";
 import { TaskClaimManager } from "../tasks/task-claim-manager.js";
+import { UserConfigManager } from "../persistence/user-config-manager.js";
 export type CommandHandler = (cmd: ParsedCommand, controller: SessionController) => Promise<CommandExecutionResult> | CommandExecutionResult;
 export interface CommandRegistryOptions {
     sessionController: SessionController;
@@ -24,6 +25,13 @@ export interface CommandRegistryOptions {
     claimManager?: TaskClaimManager;
     errorHandler?: CliErrorHandler;
 }
+export interface ModelEntry {
+    id: string;
+    provider: string;
+    isCustom?: boolean;
+}
+export declare const CURATED_MODELS_BY_PROVIDER: Record<string, string[]>;
+export declare function getNumberedModelList(configMgr: UserConfigManager): ModelEntry[];
 /**
  * Command Registry & Execution Dispatcher.
  * PRD Part 2 Section 170–175.

package/dist/cli/command-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/cli/command-registry.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC5B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAMlE,MAAM,MAAM,cAAc,GAAG,CAC3B,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,iBAAiB,KAC1B,OAAO,CAAC,sBAAsB,CAAC,GAAG,sBAAsB,CAAC;AAE9D,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAmB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;gBAEnC,OAAO,EAAE,sBAAsB;IAgBpC,eAAe,CAAC,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAS7E,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI1D,eAAe,IAAI,iBAAiB,EAAE;IAI7C;;OAEG;IACU,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAgBzE;;OAEG;IACH,OAAO,CAAC,uBAAuB;CA6wBhC"}
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/cli/command-registry.ts"],"names":[],"mappings":"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"}

package/dist/cli/command-registry.js

@@ -4,6 +4,96 @@ import { ProjectDeletionSafetyManager } from "../workspace/project-deletion-safe
 import { SlashMigrateCommand } from "./slash-migrate.js";
 import { maskSecret } from "../models/secret-store.js";
 import { UserConfigManager } from "../persistence/user-config-manager.js";
+import { TokenMetricsManager } from "../persistence/token-metrics-manager.js";
+import { ModelCatalogCache } from "../persistence/model-catalog-cache.js";
+export const CURATED_MODELS_BY_PROVIDER = {
+    openrouter: [
+        "openrouter/anthropic/claude-3.5-sonnet",
+        "openrouter/deepseek/deepseek-r1",
+        "openrouter/openai/gpt-4o",
+        "openrouter/google/gemini-2.5-pro",
+        "openrouter/meta-llama/llama-3.3-70b-instruct",
+        "openrouter/qwen/qwen-2.5-coder-32b-instruct",
+    ],
+    anthropic: [
+        "claude-3-5-sonnet-20241022",
+        "claude-3-5-haiku-20241022",
+        "claude-3-opus-20240229",
+    ],
+    openai: [
+        "gpt-4o",
+        "gpt-4o-mini",
+        "o1",
+        "o3-mini",
+    ],
+    gemini: [
+        "gemini-2.5-pro",
+        "gemini-2.5-flash",
+        "gemini-2.0-flash-thinking-exp",
+    ],
+    groq: [
+        "groq/llama-3.3-70b-versatile",
+        "groq/deepseek-r1-distill-llama-70b",
+    ],
+    deepseek: [
+        "deepseek-chat",
+        "deepseek-reasoner",
+    ],
+    ollama: [
+        "ollama/llama3.2",
+        "ollama/mistral",
+        "ollama/qwen2.5-coder",
+    ],
+};
+export function getNumberedModelList(configMgr) {
+    const result = [];
+    const configuredProviders = configMgr
+        .listKeys()
+        .filter((k) => k.configured)
+        .map((k) => k.provider);
+    // 1. Prioritize models for configured providers
+    for (const prov of configuredProviders) {
+        const list = CURATED_MODELS_BY_PROVIDER[prov] || [];
+        for (const id of list) {
+            if (!result.some((r) => r.id === id)) {
+                result.push({ id, provider: prov });
+            }
+        }
+    }
+    // 2. Custom models
+    for (const customId of configMgr.getCustomModels()) {
+        if (!result.some((r) => r.id === customId)) {
+            result.push({ id: customId, provider: "custom", isCustom: true });
+        }
+    }
+    // 3. Cached models from ModelCatalogCache (if any and not already present)
+    try {
+        const cached = ModelCatalogCache.getInstance().getCachedModels();
+        if (cached && cached.length > 0) {
+            for (const m of cached) {
+                if (!result.some((r) => r.id === m.id)) {
+                    result.push({ id: m.id, provider: m.provider });
+                }
+            }
+        }
+    }
+    catch {
+        // safe fallback
+    }
+    // 4. Fallback default models if no keys configured
+    if (result.length === 0) {
+        const defaultOrder = ["openrouter", "gemini", "anthropic", "openai"];
+        for (const prov of defaultOrder) {
+            const list = CURATED_MODELS_BY_PROVIDER[prov] || [];
+            for (const id of list.slice(0, 2)) {
+                if (!result.some((r) => r.id === id)) {
+                    result.push({ id, provider: prov });
+                }
+            }
+        }
+    }
+    return result;
+}
 /**
  * Command Registry & Execution Dispatcher.
  * PRD Part 2 Section 170–175.
@@ -44,7 +134,15 @@ export class CommandRegistry {
         }
     }
     getDescriptor(name) {
-        return this.descriptors.get(name.toLowerCase());
+        const direct = this.descriptors.get(name.toLowerCase());
+        if (direct)
+            return direct;
+        for (const desc of this.descriptors.values()) {
+            if (desc.aliases.some((a) => a.toLowerCase() === name.toLowerCase())) {
+                return desc;
+            }
+        }
+        return undefined;
     }
     listDescriptors() {
         return Array.from(this.descriptors.values());
@@ -78,7 +176,7 @@ export class CommandRegistry {
         }, (cmd) => {
             if (cmd.args.length > 0) {
                 const target = cmd.args[0].replace(/^\//, "").toLowerCase();
-                const desc = this.descriptors.get(target);
+                const desc = this.getDescriptor(target);
                 if (!desc) {
                     return {
                         success: false,
@@ -530,9 +628,9 @@ export class CommandRegistry {
             return {
                 success: true,
                 commandName: "version",
-                message: "Anantham V2 v2.0.2",
+                message: "Anantham V2 v2.0.4",
                 data: {
-                    version: "2.0.2",
+                    version: "2.0.4",
                     releaseChannel: "release",
                 },
                 exitRequested: false,
@@ -637,112 +735,288 @@ export class CommandRegistry {
             }
             throw new Error(`Unknown key subcommand '${sub}'. Use 'list', 'set <provider> <key>', or 'remove <provider>'.`);
         });
-        // 15. /model
+        // 15. /models (Unified Model Command aliased to /model, /m, /model-list)
         this.registerCommand({
-            name: "model",
-            description: "Display or switch the active LLM model",
-            aliases: ["m"],
-            usage: "/model [modelId]",
+            name: "models",
+            description: "Display, switch, search, or browse AI models (aliased to /model)",
+            aliases: ["model", "m", "model-list"],
+            usage: "/models [<number> | <modelId> | <provider> | add <id> | remove <id> | search <query> | all]",
             options: [],
-        }, (cmd, ctrl) => {
+        }, async (cmd, ctrl) => {
             const configMgr = UserConfigManager.getInstance();
-            if (cmd.args.length > 0) {
-                const modelId = cmd.args[0];
+            const cmdName = cmd.name.toLowerCase();
+            const activeProjectId = ctrl.getContext().activeProjectId;
+            const proj = activeProjectId ? this.projectRepo.findById(activeProjectId) : null;
+            const currentModel = proj?.modelProfile || configMgr.getDefaultModel();
+            // 1. If run without arguments:
+            if (cmd.args.length === 0) {
+                if (cmdName === "model") {
+                    const list = getNumberedModelList(configMgr);
+                    const customModels = configMgr.getCustomModels();
+                    const customInfo = customModels.length > 0 ? `\nCustom models: ${customModels.join(", ")}` : "";
+                    return {
+                        success: true,
+                        commandName: "model",
+                        message: `Current active model: ${currentModel}\n\nQuick switch: /model <number> (e.g. /model 1)\nAdd custom:   /model add <modelId>\nList models:  /models${customInfo}`,
+                        data: { model: currentModel, models: list, interactiveModal: true },
+                        exitRequested: false,
+                    };
+                }
+                const configuredKeys = configMgr.listKeys().filter((k) => k.configured);
+                const list = getNumberedModelList(configMgr);
+                let listBody;
+                if (configuredKeys.length > 0) {
+                    const provNames = configuredKeys.map((k) => k.provider.toUpperCase()).join(", ");
+                    const rows = list.map((item, idx) => {
+                        const num = `[${idx + 1}]`.padEnd(4);
+                        const isActive = item.id === currentModel ? " (ACTIVE)" : "";
+                        const customTag = item.isCustom ? " [Custom]" : "";
+                        return `  ${num} ${item.id}${customTag}${isActive}`;
+                    });
+                    listBody = `Available Models for Configured Providers (${provNames}):\n${rows.join("\n")}\n\nSwitch: /model <number> (e.g. /model 1) | /model <modelId>\nCustom: /model add <id> | Search: /models search <query>`;
+                }
+                else {
+                    const fallbackRows = list.map((item, idx) => {
+                        const num = `[${idx + 1}]`.padEnd(4);
+                        const isActive = item.id === currentModel ? " (ACTIVE)" : "";
+                        return `  ${num} ${item.id} [${item.provider}]${isActive}`;
+                    });
+                    listBody = `Curated AI Models (No API keys configured yet):\n${fallbackRows.join("\n")}\n\nConnect OpenRouter or other keys via:\n  /key set openrouter <your-api-key>\nSwitch: /model <number> | View all: /models all`;
+                }
+                return {
+                    success: true,
+                    commandName: "models",
+                    message: `Current active model: ${currentModel}\n\n${listBody}`,
+                    data: {
+                        model: currentModel,
+                        activeModel: currentModel,
+                        models: list,
+                        interactiveModal: true,
+                    },
+                    exitRequested: false,
+                };
+            }
+            const sub = cmd.args[0].toLowerCase();
+            // 2. /model add <modelId>
+            if (sub === "add") {
+                const modelId = cmd.args[1]?.trim();
+                if (!modelId) {
+                    throw new Error("Usage: /model add <modelId> (e.g. /model add openrouter/mistralai/mistral-large)");
+                }
+                configMgr.addCustomModel(modelId);
                 configMgr.setDefaultModel(modelId);
-                const activeProjectId = ctrl.getContext().activeProjectId;
-                if (activeProjectId) {
-                    const proj = this.projectRepo.findById(activeProjectId);
-                    if (proj) {
-                        proj.modelProfile = modelId;
-                        this.projectRepo.save(proj);
+                if (proj) {
+                    proj.modelProfile = modelId;
+                    this.projectRepo.save(proj);
+                }
+                return {
+                    success: true,
+                    commandName: cmdName,
+                    message: `✔ Added custom model '${modelId}' and switched to it.\n  Saved to ~/.anantham/config.json and active project.`,
+                    data: { model: modelId, custom: true },
+                    exitRequested: false,
+                };
+            }
+            // 3. /model remove <modelId> or delete
+            if (sub === "remove" || sub === "delete") {
+                const modelId = cmd.args[1]?.trim();
+                if (!modelId) {
+                    throw new Error("Usage: /model remove <modelId>");
+                }
+                const removed = configMgr.removeCustomModel(modelId);
+                return {
+                    success: true,
+                    commandName: cmdName,
+                    message: removed
+                        ? `✔ Removed custom model '${modelId}'.`
+                        : `Model '${modelId}' was not in custom models list.`,
+                    data: { model: modelId, removed },
+                    exitRequested: false,
+                };
+            }
+            // 4. /models search <query> or /models fetch
+            if (sub === "search" || sub === "fetch") {
+                const query = cmd.args.slice(1).join(" ").toLowerCase();
+                const orKey = configMgr.getApiKey("openrouter");
+                if (!orKey) {
+                    throw new Error("OpenRouter API key required to search live models. Connect it with: /key set openrouter <key>");
+                }
+                try {
+                    const res = await fetch("https://openrouter.ai/api/v1/models", {
+                        headers: { Authorization: `Bearer ${orKey}` },
+                        signal: AbortSignal.timeout(6000),
+                    });
+                    if (!res.ok) {
+                        throw new Error(`OpenRouter API responded with HTTP ${res.status}`);
+                    }
+                    const data = (await res.json());
+                    let items = data.data || [];
+                    if (query) {
+                        items = items.filter((m) => m.id.toLowerCase().includes(query) || (m.name && m.name.toLowerCase().includes(query)));
                     }
+                    const matched = items.slice(0, 8);
+                    if (matched.length === 0) {
+                        return {
+                            success: true,
+                            commandName: "models",
+                            message: `No OpenRouter models found matching '${query}'.`,
+                            data: [],
+                            exitRequested: false,
+                        };
+                    }
+                    const lines = matched.map((m) => `  • ${m.id} (${m.context_length ? `${Math.round(m.context_length / 1000)}k ctx` : "std"})`);
+                    return {
+                        success: true,
+                        commandName: "models",
+                        message: `OpenRouter Live Models${query ? ` (search: '${query}')` : " (top)"}:\n${lines.join("\n")}\n\nTo use: /model <modelId> or /model add <modelId>`,
+                        data: matched.map((m) => m.id),
+                        exitRequested: false,
+                    };
+                }
+                catch (err) {
+                    throw new Error(`Failed to query OpenRouter live models: ${err.message}`);
+                }
+            }
+            // 5. /models all
+            if (sub === "all") {
+                const sections = [];
+                for (const [provider, models] of Object.entries(CURATED_MODELS_BY_PROVIDER)) {
+                    sections.push(`[${provider.toUpperCase()}]:\n` + models.slice(0, 3).map((m) => `  • ${m}`).join("\n"));
                 }
                 return {
                     success: true,
-                    commandName: "model",
-                    message: `✔ Active model switched to '${modelId}' (persisted to config & project).`,
-                    data: { model: modelId },
+                    commandName: "models",
+                    message: `Curated AI Models Catalog:\n\n${sections.join("\n\n")}\n\nSwitch via: /model <modelId>`,
+                    data: CURATED_MODELS_BY_PROVIDER,
                     exitRequested: false,
                 };
             }
-            const activeProjectId = ctrl.getContext().activeProjectId;
-            const proj = activeProjectId ? this.projectRepo.findById(activeProjectId) : null;
-            const currentModel = proj?.modelProfile || configMgr.getDefaultModel();
+            // 6. Specific provider e.g. /models anthropic or /models openrouter
+            if (CURATED_MODELS_BY_PROVIDER[sub]) {
+                const list = CURATED_MODELS_BY_PROVIDER[sub].map((m) => {
+                    const activeTag = m === currentModel ? " (ACTIVE)" : "";
+                    return `  • ${m}${activeTag}`;
+                }).join("\n");
+                return {
+                    success: true,
+                    commandName: cmdName,
+                    message: `Models for [${sub.toUpperCase()}]:\n${list}\n\nSwitch via: /model <modelId>`,
+                    data: CURATED_MODELS_BY_PROVIDER[sub],
+                    exitRequested: false,
+                };
+            }
+            // 7. Numeric selection (e.g. /model 1 or /model 2)
+            let targetModel = cmd.args[0].trim();
+            if (/^\d+$/.test(targetModel)) {
+                const num = parseInt(targetModel, 10);
+                const list = getNumberedModelList(configMgr);
+                if (num < 1 || num > list.length) {
+                    throw new Error(`Invalid model index [${num}]. Run '/models' to view available numbers (1-${list.length}).`);
+                }
+                targetModel = list[num - 1].id;
+            }
+            else if (cmdName === "models" && !targetModel.includes("/")) {
+                // If invoked as /models with an unknown provider argument, fall back gracefully to Curated AI Models list
+                const list = getNumberedModelList(configMgr);
+                const fallbackRows = list.map((item, idx) => {
+                    const num = `[${idx + 1}]`.padEnd(4);
+                    const isActive = item.id === currentModel ? " (ACTIVE)" : "";
+                    return `  ${num} ${item.id} [${item.provider}]${isActive}`;
+                });
+                return {
+                    success: true,
+                    commandName: "models",
+                    message: `Curated AI Models (Unknown provider '${cmd.args[0]}'):\n${fallbackRows.join("\n")}\n\nSwitch: /model <number> | View all: /models all`,
+                    data: list,
+                    exitRequested: false,
+                };
+            }
+            // 8. Model ID switch (e.g. /model gpt-4o or /model openrouter/anthropic/claude-3.5-sonnet)
+            configMgr.setDefaultModel(targetModel);
+            if (proj) {
+                proj.modelProfile = targetModel;
+                this.projectRepo.save(proj);
+            }
             return {
                 success: true,
-                commandName: "model",
-                message: `Current active model: ${currentModel}\nType '/models' to view curated popular models or '/model <id>' to switch.`,
-                data: { model: currentModel },
+                commandName: cmdName,
+                message: `✔ Active model switched to '${targetModel}' (persisted to config & project).`,
+                data: { model: targetModel },
                 exitRequested: false,
             };
         });
-        // 16. /models
+        // /usage — Real-time Token Usage Matrix & Cost Attribution
         this.registerCommand({
-            name: "models",
-            description: "List curated popular LLM models across providers",
-            aliases: ["model-list"],
-            usage: "/models [openrouter | anthropic | openai | gemini | groq | deepseek | ollama]",
+            name: "usage",
+            description: "Display real-time token usage matrix, model leaderboard and cost attribution",
+            aliases: ["tokens", "metrics", "cost"],
+            usage: "/usage [today | mtd | models | trend]",
             options: [],
-        }, (cmd) => {
-            const target = cmd.args[0]?.toLowerCase();
-            const curated = {
-                openrouter: [
-                    "openrouter/anthropic/claude-3.5-sonnet",
-                    "openrouter/deepseek/deepseek-r1",
-                    "openrouter/openai/gpt-4o",
-                    "openrouter/google/gemini-2.5-pro",
-                    "openrouter/meta-llama/llama-3.3-70b-instruct",
-                    "openrouter/qwen/qwen-2.5-coder-32b-instruct",
-                ],
-                anthropic: [
-                    "claude-3-5-sonnet-20241022",
-                    "claude-3-5-haiku-20241022",
-                    "claude-3-opus-20240229",
-                ],
-                openai: [
-                    "gpt-4o",
-                    "gpt-4o-mini",
-                    "o1",
-                    "o3-mini",
-                ],
-                gemini: [
-                    "gemini-2.5-pro",
-                    "gemini-2.5-flash",
-                    "gemini-2.0-flash-thinking-exp",
-                ],
-                groq: [
-                    "groq/llama-3.3-70b-versatile",
-                    "groq/deepseek-r1-distill-llama-70b",
-                ],
-                deepseek: [
-                    "deepseek-chat",
-                    "deepseek-reasoner",
-                ],
-                ollama: [
-                    "ollama/llama3.2",
-                    "ollama/mistral",
-                    "ollama/qwen2.5-coder",
-                ],
-            };
-            if (target && curated[target]) {
-                const list = curated[target].map((m) => `  • ${m}`).join("\n");
-                return {
-                    success: true,
-                    commandName: "models",
-                    message: `Models for [${target.toUpperCase()}]:\n${list}\n\nSwitch via: /model <modelId>`,
-                    data: curated[target],
-                    exitRequested: false,
-                };
-            }
-            const sections = [];
-            for (const [provider, models] of Object.entries(curated)) {
-                sections.push(`[${provider.toUpperCase()}]:\n` + models.slice(0, 3).map((m) => `  • ${m}`).join("\n"));
+        }, () => {
+            const metrics = TokenMetricsManager.getInstance();
+            const today = metrics.getDailySummary();
+            const mtd = metrics.getMtdSummary();
+            const budget = metrics.getMonthlyBudget();
+            const topModels = metrics.getTopModels(4);
+            const lines = [
+                "Token Usage Matrix & Cost Analytics:",
+                `  Today's Tokens   : ${today.totalTokens.toLocaleString()} (In: ${today.totalInputTokens.toLocaleString()} | Out: ${today.totalOutputTokens.toLocaleString()} | Cached: ${today.totalCachedTokens.toLocaleString()})`,
+                `  Today's Cost     : $${today.totalCostUsd.toFixed(4)} USD (${today.requestCount} requests)`,
+                `  Month-to-Date    : ${mtd.totalTokens.toLocaleString()} tokens | $${mtd.totalCostUsd.toFixed(2)} / $${budget.toFixed(0)} USD budget`,
+                "",
+                "Top Consuming Models:",
+            ];
+            for (const m of topModels) {
+                lines.push(`  • ${m.modelId.padEnd(34)} : ${m.totalTokens.toLocaleString().padStart(10)} tokens | $${m.costUsd.toFixed(2)} (${m.percentage}%)`);
             }
+            lines.push("");
+            lines.push("Interactive TUI: Run 'anantham --tui' and type '/usage' to view the full graphical matrix with neon sparklines.");
+            return {
+                success: true,
+                commandName: "usage",
+                message: lines.join("\n"),
+                data: { today, mtd, budget, topModels },
+                exitRequested: false,
+            };
+        });
+        // /teamwork-preview — Autonomous multi-worker preview harness
+        this.registerCommand({
+            name: "teamwork-preview",
+            description: "Autonomous agent multi-worker teamwork preview harness",
+            aliases: ["preview", "teamwork"],
+            usage: "/teamwork-preview [status | run]",
+            options: [],
+        }, () => {
+            return {
+                success: true,
+                commandName: "teamwork-preview",
+                message: [
+                    "❖ Teamwork Preview Harness Status: ONLINE",
+                    "  Engine           : Anantham V2 Autonomous Agent Coordinator",
+                    "  Parallel Workers : 4 active worker execution slots",
+                    "  Task Partitioning: Wave DAG with generation-fenced leases",
+                    "  Durability       : SQLite WAL (synchronous = FULL, RPO-0)",
+                    "  Safety Boundary  : ToolGateway sandboxed capability routing",
+                    "",
+                    "Autonomous team preview ready. Submit prompt tasks via interactive CLI or TUI.",
+                ].join("\n"),
+                data: { status: "ONLINE", workers: 4, mode: "wave_dag" },
+                exitRequested: false,
+            };
+        });
+        // /clear — Clear viewport
+        this.registerCommand({
+            name: "clear",
+            description: "Clear terminal viewport and command output buffer",
+            aliases: ["cls"],
+            usage: "/clear",
+            options: [],
+        }, () => {
             return {
                 success: true,
-                commandName: "models",
-                message: `Curated AI Models:\n\n${sections.join("\n\n")}\n\nRun '/models <provider>' for more or '/model <id>' to select.`,
-                data: curated,
+                commandName: "clear",
+                message: "",
+                data: {},
                 exitRequested: false,
             };
         });