@edwardlee5423/magi 0.1.0-alpha.0

package/dist/commands/usage.js

@@ -0,0 +1,54 @@
+export const command = {
+    name: "usage",
+    description: "Show recent API usage rate (calls and tokens by hour)",
+    usage: "/usage [hours]",
+    group: "Session",
+    handler: (args, input) => {
+        const hours = Math.max(1, Math.min(168, Number(args[0]) || 24));
+        const now = Date.now();
+        const cutoff = now - hours * 3600_000;
+        const usage = input.store.listAllUsage(5000).filter(u => new Date(u.createdAt).getTime() >= cutoff);
+        if (usage.length === 0) {
+            return `No API calls in the last ${hours}h.`;
+        }
+        // Bucket by hour
+        const buckets = new Map();
+        for (const u of usage) {
+            const t = new Date(u.createdAt);
+            const hourKey = `${t.toISOString().slice(0, 13)}:00`;
+            const b = buckets.get(hourKey) ?? { calls: 0, input: 0, output: 0, models: new Set() };
+            b.calls += 1;
+            b.input += u.inputTokens;
+            b.output += u.outputTokens;
+            b.models.add(u.model);
+            buckets.set(hourKey, b);
+        }
+        const sortedKeys = [...buckets.keys()].sort().reverse().slice(0, 24);
+        const lines = [
+            `API usage in the last ${hours}h: ${usage.length} calls`,
+            "",
+            `  ${"Hour".padEnd(20)} ${"Calls".padStart(6)} ${"Input".padStart(10)} ${"Output".padStart(10)}  Models`
+        ];
+        for (const key of sortedKeys) {
+            const b = buckets.get(key);
+            const inK = formatTokens(b.input);
+            const outK = formatTokens(b.output);
+            lines.push(`  ${key.replace("T", " ").padEnd(20)} ${String(b.calls).padStart(6)} ${inK.padStart(10)} ${outK.padStart(10)}  ${[...b.models].slice(0, 2).join(", ")}`);
+        }
+        const total = usage.reduce((s, u) => ({ input: s.input + u.inputTokens, output: s.output + u.outputTokens }), { input: 0, output: 0 });
+        lines.push("");
+        lines.push(`  Total: ${formatTokens(total.input)} in, ${formatTokens(total.output)} out`);
+        lines.push("");
+        lines.push("Note: this is local accounting, not the provider's enforced rate limit.");
+        lines.push("Use /cost for per-model cost breakdown.");
+        return lines.join("\n");
+    }
+};
+function formatTokens(n) {
+    if (n < 1000)
+        return String(n);
+    if (n < 1_000_000)
+        return `${(n / 1000).toFixed(1)}k`;
+    return `${(n / 1_000_000).toFixed(2)}M`;
+}
+//# sourceMappingURL=usage.js.map

package/dist/commands/usage.js.map

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

package/dist/commands/vim.d.ts

@@ -0,0 +1,10 @@
+import { SlashCommandInput } from "./registry.js";
+export declare function isVimModeEnabled(): boolean;
+export declare function setVimMode(enabled: boolean): void;
+export declare const command: {
+    name: string;
+    description: string;
+    usage: string;
+    group: string;
+    handler: (args: string[], _input: SlashCommandInput) => string;
+};

package/dist/commands/vim.js

@@ -0,0 +1,34 @@
+let vimEnabled = false;
+export function isVimModeEnabled() {
+    return vimEnabled;
+}
+export function setVimMode(enabled) {
+    vimEnabled = enabled;
+}
+export const command = {
+    name: "vim",
+    description: "Toggle vim mode for input editing",
+    usage: "/vim [on|off]",
+    group: "Editor",
+    handler: (args, _input) => {
+        if (args.length === 0) {
+            vimEnabled = !vimEnabled;
+        }
+        else if (args[0] === "on" || args[0] === "true") {
+            vimEnabled = true;
+        }
+        else if (args[0] === "off" || args[0] === "false") {
+            vimEnabled = false;
+        }
+        else {
+            return `Unknown option: ${args[0]}. Use /vim on, /vim off, or /vim`;
+        }
+        return [
+            `Vim mode: ${vimEnabled ? "ON" : "OFF"}`,
+            vimEnabled
+                ? "  - Press Escape to enter NORMAL mode\n  - Use h/l/0/$/w/b/e to navigate\n  - Use i/a/I/A/o to enter INSERT mode\n  - Use d/c/y + motion (dw, cw, yy, etc.) for operations\n  - Use x/D/p for char/line ops\n  - Press Enter to submit"
+                : "  - Standard readline editing (emacs-style)"
+        ].join("\n");
+    }
+};
+//# sourceMappingURL=vim.js.map

package/dist/commands/vim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vim.js","sourceRoot":"","sources":["../../src/commands/vim.ts"],"names":[],"mappings":"AAEA,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,MAAM,UAAU,gBAAgB;IAC9B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,UAAU,GAAG,OAAO,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,mCAAmC;IAChD,KAAK,EAAE,eAAe;IACtB,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,CAAC,IAAc,EAAE,MAAyB,EAAU,EAAE;QAC7D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,UAAU,GAAG,CAAC,UAAU,CAAC;QAC3B,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;YAClD,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YACpD,UAAU,GAAG,KAAK,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,OAAO,mBAAmB,IAAI,CAAC,CAAC,CAAC,kCAAkC,CAAC;QACtE,CAAC;QACD,OAAO;YACL,aAAa,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE;YACxC,UAAU;gBACR,CAAC,CAAC,wOAAwO;gBAC1O,CAAC,CAAC,6CAA6C;SAClD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,104 @@
+import { MagiPaths } from "./paths.js";
+export type ProviderKind = "openai" | "messages-compatible";
+export type OpenAiEndpoint = "chat" | "responses";
+export type MessagesCompatibleFormat = "openai-chat" | "anthropic-messages";
+export interface ProviderConfig {
+    type: ProviderKind;
+    apiKeyEnv?: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    endpoint?: OpenAiEndpoint;
+    format?: MessagesCompatibleFormat;
+    timeoutMs?: number;
+}
+export interface MagiConfig {
+    version: string;
+    control: {
+        bind: string;
+        port: number;
+    };
+    providers: Record<string, ProviderConfig>;
+    models: {
+        aliases: Record<string, string>;
+        fallbacks: Record<string, string[]>;
+        router?: Record<string, import("./routing/model-router.js").ModelCapabilities>;
+    };
+    mcp: {
+        servers: Record<string, McpServerConfig>;
+    };
+    hooks: HookDefinition[];
+    context: ContextConfig;
+    memory: MemoryConfig;
+    webSearch: WebSearchConfig;
+}
+export interface McpServerConfig {
+    transport?: "stdio" | "http" | "sse" | "websocket" | "websocket-ide";
+    command: string;
+    args: string[];
+    url?: string;
+    headers?: Record<string, string>;
+    env: Record<string, string>;
+    approval: "always" | "dangerous" | "never";
+    oauth?: McpOAuthConfig;
+}
+export interface McpOAuthConfig {
+    /** Authorization Server URL. If omitted, server is expected to advertise via WWW-Authenticate. */
+    authServerUrl?: string;
+    /** Static client_id. If omitted, Dynamic Client Registration is attempted. */
+    clientId?: string;
+    /** Optional client secret (for confidential clients; PKCE prefers no secret). */
+    clientSecret?: string;
+    /** OAuth scope to request. */
+    scope?: string;
+}
+export interface ContextConfig {
+    recentMessages: number;
+    autoCompactTokenThreshold?: number;
+    /** Trigger compaction once the session reaches this many messages, even if
+     * the token estimate is below the token threshold. Long conversations cause
+     * model attention drift / hallucinations long before they hit the context
+     * window, so this gives an earlier safety net. */
+    autoCompactMessageThreshold?: number;
+    compactionModel?: string;
+}
+export interface MemoryConfig {
+    enabled: boolean;
+    autoWrite: "off" | "explicit";
+    maxResults: number;
+    scopes: Array<"user" | "project" | "session">;
+    selectionModel?: string;
+}
+export interface WebSearchConfig {
+    provider?: "http-json";
+    endpoint?: string;
+    apiKeyEnv?: string;
+    locale: string;
+    market: string;
+    mainlandBoost: boolean;
+    queryParam: string;
+    apiKeyHeader?: string;
+    resultsPath: string;
+    titlePath: string;
+    urlPath: string;
+    snippetPath: string;
+    maxResults: number;
+}
+export type HookEvent = "pre_tool_use" | "post_tool_use" | "post_tool_use_failure" | "session_start" | "session_end" | "user_prompt_submit" | "pre_compact" | "post_compact" | "permission_request" | "permission_denied" | "subagent_start" | "subagent_stop" | "teammate_idle" | "task_created" | "task_completed" | "elicitation" | "elicitation_result" | "config_change" | "worktree_create" | "worktree_remove" | "instructions_loaded" | "cwd_changed" | "file_changed" | "notification" | "setup" | "stop" | "stop_failure";
+export type HookType = "command" | "prompt" | "http" | "agent";
+export interface HookDefinition {
+    event: HookEvent;
+    type: HookType;
+    if?: string;
+    command?: string;
+    prompt?: string;
+    model?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    allowedEnvVars?: string[];
+    timeoutMs?: number;
+    once?: boolean;
+    blocking?: boolean;
+}
+export declare function loadConfig(paths: MagiPaths, env?: NodeJS.ProcessEnv): MagiConfig;
+export declare function validateConfig(value: unknown, configFile: string, env?: NodeJS.ProcessEnv): MagiConfig;
+export declare function formatConfig(config: MagiConfig): string;