@pencil-agent/nano-pencil 1.10.3 → 1.10.4

package/dist/cli/args.d.ts

@@ -34,6 +34,8 @@ export interface Args {
     noThemes?: boolean;
     listModels?: string | true;
     offline?: boolean;
+    /** Disable MCP (Model Context Protocol). Default: false (MCP enabled) */
+    noMcp?: boolean;
     verbose?: boolean;
     /** Disable Soul (AI personality evolution). Default: false (Soul enabled) */
     disableSoul?: boolean;

package/dist/cli/args.js

@@ -138,6 +138,9 @@ export function parseArgs(args, extensionFlags) {
         else if (arg === "--disable-soul") {
             result.disableSoul = true;
         }
+        else if (arg === "--no-mcp") {
+            result.noMcp = true;
+        }
         else if (arg.startsWith("@")) {
             result.fileArgs.push(arg.slice(1)); // Remove @ prefix
         }
@@ -207,6 +210,7 @@ ${chalk.bold("Options:")}
   --verbose                      Force verbose startup (overrides quietStartup setting)
   --offline                      Disable startup network operations (same as PI_OFFLINE=1)
   --disable-soul                 Disable Soul (AI personality evolution)
+  --no-mcp                       Disable MCP (Model Context Protocol) tools
   --help, -h                     Show this help
   --version, -v                  Show version number
 

package/dist/core/mcp/mcp-client.js

@@ -8,6 +8,24 @@ import { spawn } from "child_process";
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
 import { getAgentDir } from "../../config.js";
+// Log level control: DEBUG shows all MCP messages, RELEASE only shows summary
+// Check if running from installed location (production) vs development
+const isProductionBuild = typeof import.meta.url === "string" && import.meta.url.includes("node_modules");
+const isDebugMode = process.env.NODE_ENV === "development" || (process.env.NODE_ENV !== "production" && !isProductionBuild);
+function mcpLog(...args) {
+    if (isDebugMode) {
+        console.log(...args);
+    }
+}
+function mcpWarn(...args) {
+    if (isDebugMode) {
+        console.warn(...args);
+    }
+}
+function mcpError(...args) {
+    // Errors are always shown
+    console.error(...args);
+}
 /**
  * MCP Client class
  * Manages connections to MCP servers and tool calls
@@ -38,7 +56,7 @@ export class MCPClient {
             }
         }
         catch (error) {
-            console.error(`Failed to load MCP config: ${error}`);
+            mcpError(`Failed to load MCP config: ${error}`);
         }
     }
     /**
@@ -138,12 +156,15 @@ export class MCPClient {
         runtime.process.stderr.on("data", (chunk) => {
             const text = chunk.toString("utf8").trim();
             if (text.length > 0) {
-                console.error(`[MCP:${serverId}] ${text}`);
+                // Only show stderr errors in debug mode
+                if (isDebugMode) {
+                    mcpError(`[MCP:${serverId}] ${text}`);
+                }
             }
         });
         runtime.process.on("exit", (code, signal) => {
             const message = `[MCP:debug] Server exited: code=${code ?? "null"}, signal=${signal ?? "null"}`;
-            console.log(message);
+            mcpLog(message);
             for (const pending of runtime.pendingRequests.values()) {
                 clearTimeout(pending.timer);
                 pending.reject(new Error(message));
@@ -173,7 +194,7 @@ export class MCPClient {
             const line = runtime.buffer.slice(0, lineEnd).toString("utf8").replace(/\r$/, "");
             runtime.buffer = runtime.buffer.slice(lineEnd + 1);
             if (line.length > 0) {
-                console.log(`[MCP:${serverId}] Received: ${line.slice(0, 200)}`);
+                mcpLog(`[MCP:${serverId}] Received: ${line.slice(0, 200)}`);
                 this.handleJsonRpcMessage(serverId, line);
             }
         }

package/dist/core/mcp/mcp-config.js

@@ -24,13 +24,14 @@ const DEFAULT_MCP_CONFIG = {
             name: "Fetch (Web Scraper)",
             command: "npx",
             args: ["-y", "@kazuph/mcp-fetch"],
-            enabled: true,
+            enabled: false,
             transport: "stdio",
             toolTimeout: 30000,
         },
         {
             id: "puppeteer",
             name: "Puppeteer (Browser Automation)",
+            // 注意：此包已废弃 (DEPRECATED)，但仍可正常工作
             command: "npx",
             args: ["-y", "@modelcontextprotocol/server-puppeteer"],
             enabled: true,
@@ -60,7 +61,7 @@ const DEFAULT_MCP_CONFIG = {
             id: "sqlite",
             name: "SQLite (Database)",
             command: "npx",
-            args: ["-y", "@modelcontextprotocol/server-sqlite"],
+            args: ["-y", "mcp-server-sqlite"],
             enabled: false,
             transport: "stdio",
             toolTimeout: 30000,
@@ -95,7 +96,7 @@ const DEFAULT_MCP_CONFIG = {
             id: "git",
             name: "Git",
             command: "npx",
-            args: ["-y", "@executeautomation/server-git"],
+            args: ["-y", "@liangshanli/mcp-server-git"],
             enabled: false,
             transport: "stdio",
             toolTimeout: 30000,

package/dist/core/sdk.js

@@ -242,14 +242,29 @@ export async function createAgentSession(options = {}) {
             mcpTools.push(...mcpManager.getTools());
             time("mcp.initialize");
             const mcpStatus = mcpManager.getStatus();
-            if (mcpStatus.toolCount === 0) {
-                const failed = mcpStatus.failedServers.length > 0
-                    ? ` failed=${mcpStatus.failedServers.join(",")}`
-                    : "";
-                console.warn(`MCP enabled but no tools loaded (enabled=${mcpStatus.enabledServers.length}, started=${mcpStatus.startedServers.length}, tools=0).${failed}`);
+            const isProduction = process.env.NODE_ENV === "production";
+            if (isProduction) {
+                // Production mode: concise summary
+                const started = mcpStatus.startedServers;
+                const failed = mcpStatus.failedServers;
+                if (started.length > 0) {
+                    console.error(`MCP: ${started.length} server(s) ready (${started.join(", ")})`);
+                }
+                if (failed.length > 0) {
+                    console.error(`MCP: ${failed.length} failed (${failed.join(", ")})`);
+                }
             }
             else {
-                console.error(`MCP tools loaded: ${mcpStatus.toolCount}`);
+                // Dev mode: detailed info
+                if (mcpStatus.toolCount === 0) {
+                    const failed = mcpStatus.failedServers.length > 0
+                        ? ` failed=${mcpStatus.failedServers.join(",")}`
+                        : "";
+                    console.warn(`MCP enabled but no tools loaded (enabled=${mcpStatus.enabledServers.length}, started=${mcpStatus.startedServers.length}, tools=0).${failed}`);
+                }
+                else {
+                    console.error(`MCP tools loaded: ${mcpStatus.toolCount}`);
+                }
             }
             process.once("exit", () => mcpManager?.dispose());
         }

package/dist/core/settings-manager.d.ts

@@ -16,6 +16,7 @@ export interface RetrySettings {
 export interface TerminalSettings {
     showImages?: boolean;
     clearOnShrink?: boolean;
+    showTokenStats?: boolean;
 }
 export interface ImageSettings {
     autoResize?: boolean;
@@ -206,6 +207,8 @@ export declare class SettingsManager {
     setShowImages(show: boolean): void;
     getClearOnShrink(): boolean;
     setClearOnShrink(enabled: boolean): void;
+    getShowTokenStats(): boolean;
+    setShowTokenStats(enabled: boolean): void;
     getImageAutoResize(): boolean;
     setImageAutoResize(enabled: boolean): void;
     getBlockImages(): boolean;

package/dist/core/settings-manager.js

@@ -587,6 +587,17 @@ export class SettingsManager {
         this.markModified("terminal", "clearOnShrink");
         this.save();
     }
+    getShowTokenStats() {
+        return this.settings.terminal?.showTokenStats ?? true;
+    }
+    setShowTokenStats(enabled) {
+        if (!this.globalSettings.terminal) {
+            this.globalSettings.terminal = {};
+        }
+        this.globalSettings.terminal.showTokenStats = enabled;
+        this.markModified("terminal", "showTokenStats");
+        this.save();
+    }
     getImageAutoResize() {
         return this.settings.images?.autoResize ?? true;
     }

package/dist/core/slash-commands.js

@@ -17,6 +17,7 @@ export const BUILTIN_SLASH_COMMANDS = [
     { name: "copy", description: "Copy last agent message to clipboard" },
     { name: "name", description: "Set session display name" },
     { name: "session", description: "Show session info and stats" },
+    { name: "usage", description: "Show token usage and cost stats" },
     { name: "changelog", description: "Show changelog entries" },
     { name: "hotkeys", description: "Show all keyboard shortcuts" },
     { name: "fork", description: "Create a new fork from a previous message" },

package/dist/main.js

@@ -617,8 +617,8 @@ export async function main(args) {
         sessionManager = SessionManager.open(selectedPath);
     }
     const { options: sessionOptions, cliThinkingFromModel } = buildSessionOptions(parsed, scopedModels, sessionManager, modelRegistry, settingsManager);
-    // NanoPencil 默认启用 MCP；离线模式下关闭以避免启动阻塞。
-    sessionOptions.enableMCP = APP_NAME === "nanopencil" && !offlineMode;
+    // NanoPencil 默认启用 MCP；离线模式或 --no-mcp 参数下关闭
+    sessionOptions.enableMCP = APP_NAME === "nanopencil" && !offlineMode && !parsed.noMcp;
     sessionOptions.authStorage = authStorage;
     sessionOptions.modelRegistry = modelRegistry;
     sessionOptions.resourceLoader = resourceLoader;

package/dist/modes/interactive/components/footer.d.ts

@@ -9,8 +9,10 @@ export declare class FooterComponent implements Component {
     private session;
     private footerData;
     private autoCompactEnabled;
-    constructor(session: AgentSession, footerData: ReadonlyFooterDataProvider);
+    private showTokenStats;
+    constructor(session: AgentSession, footerData: ReadonlyFooterDataProvider, showTokenStats?: boolean);
     setAutoCompactEnabled(enabled: boolean): void;
+    setShowTokenStats(enabled: boolean): void;
     /**
      * No-op: git branch caching now handled by provider.
      * Kept for compatibility with existing call sites in interactive-mode.

package/dist/modes/interactive/components/footer.js

@@ -33,13 +33,18 @@ export class FooterComponent {
     session;
     footerData;
     autoCompactEnabled = true;
-    constructor(session, footerData) {
+    showTokenStats = true;
+    constructor(session, footerData, showTokenStats = true) {
         this.session = session;
         this.footerData = footerData;
+        this.showTokenStats = showTokenStats;
     }
     setAutoCompactEnabled(enabled) {
         this.autoCompactEnabled = enabled;
     }
+    setShowTokenStats(enabled) {
+        this.showTokenStats = enabled;
+    }
     /**
      * No-op: git branch caching now handled by provider.
      * Kept for compatibility with existing call sites in interactive-mode.
@@ -107,26 +112,31 @@ export class FooterComponent {
         }
         // Build stats line
         const statsParts = [];
-        if (totalInput)
-            statsParts.push(`↑${formatTokens(totalInput)}`);
-        if (totalOutput)
-            statsParts.push(`↓${formatTokens(totalOutput)}`);
-        if (totalCacheRead)
-            statsParts.push(`R${formatTokens(totalCacheRead)}`);
-        if (totalCacheWrite)
-            statsParts.push(`W${formatTokens(totalCacheWrite)}`);
-        // Show cost with "(sub)" indicator if using OAuth subscription
-        const usingSubscription = state.model ? this.session.modelRegistry.isUsingOAuth(state.model) : false;
-        if (totalCost || usingSubscription) {
-            const costStr = `$${totalCost.toFixed(3)}${usingSubscription ? " (sub)" : ""}`;
-            statsParts.push(costStr);
+        // Token stats (can be hidden via showTokenStats setting)
+        if (this.showTokenStats) {
+            if (totalInput)
+                statsParts.push(`↑${formatTokens(totalInput)}`);
+            if (totalOutput)
+                statsParts.push(`↓${formatTokens(totalOutput)}`);
+            if (totalCacheRead)
+                statsParts.push(`R${formatTokens(totalCacheRead)}`);
+            if (totalCacheWrite)
+                statsParts.push(`W${formatTokens(totalCacheWrite)}`);
+            // Show cost with "(sub)" indicator if using OAuth subscription
+            const usingSubscription = state.model ? this.session.modelRegistry.isUsingOAuth(state.model) : false;
+            if (totalCost || usingSubscription) {
+                const costStr = `$${totalCost.toFixed(3)}${usingSubscription ? " (sub)" : ""}`;
+                statsParts.push(costStr);
+            }
         }
-        // Colorize context percentage based on usage
+        // Context percentage (always shown - it's useful)
         let contextPercentStr;
         const autoIndicator = this.autoCompactEnabled ? " (auto)" : "";
+        // Show both percentage and absolute tokens used
+        const totalUsed = totalInput + totalOutput + totalCacheRead + totalCacheWrite;
         const contextPercentDisplay = contextPercent === "?"
             ? `?/${formatTokens(contextWindow)}${autoIndicator}`
-            : `${contextPercent}%/${formatTokens(contextWindow)}${autoIndicator}`;
+            : `${contextPercent}% ${formatTokens(totalUsed)}/${formatTokens(contextWindow)}${autoIndicator}`;
         if (contextPercentValue > 90) {
             contextPercentStr = theme.fg("error", contextPercentDisplay);
         }

package/dist/modes/interactive/components/settings-selector.d.ts

@@ -22,6 +22,7 @@ export interface SettingsConfig {
     autocompleteMaxVisible: number;
     quietStartup: boolean;
     clearOnShrink: boolean;
+    showTokenStats: boolean;
 }
 export interface SettingsCallbacks {
     onAutoCompactChange: (enabled: boolean) => void;
@@ -43,6 +44,7 @@ export interface SettingsCallbacks {
     onAutocompleteMaxVisibleChange: (maxVisible: number) => void;
     onQuietStartupChange: (enabled: boolean) => void;
     onClearOnShrinkChange: (enabled: boolean) => void;
+    onShowTokenStatsChange: (enabled: boolean) => void;
     onCancel: () => void;
 }
 /**

package/dist/modes/interactive/components/settings-selector.js

@@ -223,6 +223,13 @@ export class SettingsSelectorComponent extends Container {
             currentValue: config.clearOnShrink ? "true" : "false",
             values: ["true", "false"],
         });
+        items.splice(autocompleteIndex + 2, 0, {
+            id: "show-token-stats",
+            label: "Show token stats",
+            description: "Show token usage in footer (input, output, cost)",
+            currentValue: config.showTokenStats ? "true" : "false",
+            values: ["true", "false"],
+        });
         // Add borders
         this.addChild(new DynamicBorder());
         this.settingsList = new SettingsList(items, 10, getSettingsListTheme(), (id, newValue) => {
@@ -275,6 +282,9 @@ export class SettingsSelectorComponent extends Container {
                 case "clear-on-shrink":
                     callbacks.onClearOnShrinkChange(newValue === "true");
                     break;
+                case "show-token-stats":
+                    callbacks.onShowTokenStatsChange(newValue === "true");
+                    break;
             }
         }, callbacks.onCancel, { enableSearch: true });
         this.addChild(this.settingsList);

package/dist/modes/interactive/interactive-mode.d.ts

@@ -300,6 +300,10 @@ export declare class InteractiveMode {
     private handleExportCommand;
     private handleShareCommand;
     private handleCopyCommand;
+    /**
+     * Handle /usage command - show token usage statistics
+     */
+    private handleUsageCommand;
     private handleNameCommand;
     private handleSessionCommand;
     private handleChangelogCommand;

package/dist/modes/interactive/interactive-mode.js

@@ -168,7 +168,7 @@ export class InteractiveMode {
         this.editorContainer = new Container();
         this.editorContainer.addChild(this.editor);
         this.footerDataProvider = new FooterDataProvider();
-        this.footer = new FooterComponent(session, this.footerDataProvider);
+        this.footer = new FooterComponent(session, this.footerDataProvider, this.settingsManager.getShowTokenStats());
         this.footer.setAutoCompactEnabled(session.autoCompactionEnabled);
         // Load hide thinking block setting
         this.hideThinkingBlock = this.settingsManager.getHideThinkingBlock();
@@ -1569,6 +1569,11 @@ export class InteractiveMode {
                 this.editor.setText("");
                 return;
             }
+            if (text === "/usage") {
+                await this.handleUsageCommand();
+                this.editor.setText("");
+                return;
+            }
             if (text === "/name" || text.startsWith("/name ")) {
                 this.handleNameCommand(text);
                 this.editor.setText("");
@@ -2714,6 +2719,7 @@ export class InteractiveMode {
                 autocompleteMaxVisible: this.settingsManager.getAutocompleteMaxVisible(),
                 quietStartup: this.settingsManager.getQuietStartup(),
                 clearOnShrink: this.settingsManager.getClearOnShrink(),
+                showTokenStats: this.settingsManager.getShowTokenStats(),
             }, {
                 onAutoCompactChange: (enabled) => {
                     this.session.setAutoCompactionEnabled(enabled);
@@ -2811,6 +2817,11 @@ export class InteractiveMode {
                     this.settingsManager.setClearOnShrink(enabled);
                     this.ui.setClearOnShrink(enabled);
                 },
+                onShowTokenStatsChange: (enabled) => {
+                    this.settingsManager.setShowTokenStats(enabled);
+                    this.footer.setShowTokenStats(enabled);
+                    this.ui.requestRender();
+                },
                 onCancel: () => {
                     done();
                     this.ui.requestRender();
@@ -3541,6 +3552,101 @@ export class InteractiveMode {
             this.showError(error instanceof Error ? error.message : String(error));
         }
     }
+    /**
+     * Handle /usage command - show token usage statistics
+     */
+    async handleUsageCommand() {
+        // Group usage by model
+        const modelUsage = new Map();
+        let totalInput = 0;
+        let totalOutput = 0;
+        let totalCacheRead = 0;
+        let totalCacheWrite = 0;
+        let totalCost = 0;
+        let totalTokens = 0;
+        let requestCount = 0;
+        // Aggregate usage by model
+        for (const entry of this.sessionManager.getEntries()) {
+            if (entry.type === "message" && entry.message.role === "assistant") {
+                const msg = entry.message;
+                const modelId = msg.model || "unknown";
+                if (!modelUsage.has(modelId)) {
+                    modelUsage.set(modelId, {
+                        input: 0,
+                        output: 0,
+                        cacheRead: 0,
+                        cacheWrite: 0,
+                        totalTokens: 0,
+                        cost: 0,
+                        requestCount: 0,
+                    });
+                }
+                const stats = modelUsage.get(modelId);
+                stats.input += msg.usage.input;
+                stats.output += msg.usage.output;
+                stats.cacheRead += msg.usage.cacheRead;
+                stats.cacheWrite += msg.usage.cacheWrite;
+                stats.totalTokens += msg.usage.totalTokens;
+                stats.cost += msg.usage.cost.total;
+                stats.requestCount++;
+                totalInput += msg.usage.input;
+                totalOutput += msg.usage.output;
+                totalCacheRead += msg.usage.cacheRead;
+                totalCacheWrite += msg.usage.cacheWrite;
+                totalTokens += msg.usage.totalTokens;
+                totalCost += msg.usage.cost.total;
+                requestCount++;
+            }
+        }
+        // Get context usage
+        const contextUsage = this.session.getContextUsage();
+        const contextWindow = contextUsage?.contextWindow ?? 0;
+        const contextPercent = contextUsage?.percent ?? 0;
+        // Format numbers
+        const fmt = (n) => n.toLocaleString();
+        const fmtCost = (n) => `$${n.toFixed(4)}`;
+        // Build output
+        const lines = [];
+        lines.push(theme.bold(theme.fg("accent", "═══ Token Usage ═══")));
+        lines.push("");
+        // Show usage by model
+        if (modelUsage.size > 0) {
+            for (const [modelId, stats] of modelUsage) {
+                lines.push(theme.fg("accent", `┌─ ${modelId} ─`));
+                lines.push("");
+                lines.push(`│ Requests:   ${stats.requestCount}`);
+                lines.push(`│ Input:     ${fmt(stats.input)} tokens`);
+                lines.push(`│ Output:    ${fmt(stats.output)} tokens`);
+                lines.push(`│ Cache:     ${fmt(stats.cacheRead + stats.cacheWrite)} tokens`);
+                lines.push(`│ Total:     ${fmt(stats.totalTokens)} tokens`);
+                lines.push(`│ Cost:      ${fmtCost(stats.cost)}`);
+                lines.push(theme.fg("accent", `└${"─".repeat(Math.min(50, modelId.length + 4))}`));
+                lines.push("");
+            }
+        }
+        // Total
+        lines.push(theme.bold("  ─────────── Total ───────────"));
+        lines.push(`  Requests:     ${requestCount}`);
+        lines.push(`  Input:       ${fmt(totalInput)} tokens`);
+        lines.push(`  Output:      ${fmt(totalOutput)} tokens`);
+        lines.push(`  Cache:       ${fmt(totalCacheRead + totalCacheWrite)} tokens`);
+        lines.push(`  Total:       ${fmt(totalTokens)} tokens`);
+        lines.push(`  Cost:        ${fmtCost(totalCost)}`);
+        lines.push("");
+        lines.push(`  Context:     ${contextPercent.toFixed(1)}% / ${fmt(contextWindow)} tokens`);
+        // Show current model info
+        const state = this.session.state;
+        if (state.model) {
+            lines.push(`  Current:     ${state.model.id}`);
+        }
+        lines.push("");
+        lines.push(theme.fg("dim", "  Tip: Use /settings → Terminal → Show token stats to toggle footer display"));
+        // Display in chat
+        for (const line of lines) {
+            this.chatContainer.addChild(new Spacer(1));
+            this.chatContainer.addChild(new Text(line, 1, 0));
+        }
+    }
     handleNameCommand(text) {
         const name = text.replace(/^\/name\s*/, "").trim();
         if (!name) {

package/node_modules/@types/node/README.md

@@ -5,11 +5,11 @@
 This package contains type definitions for node (https://nodejs.org/).
 
 # Details
-Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node/v20.
+Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
 
 ### Additional Details
- * Last updated: Thu, 26 Feb 2026 18:47:04 GMT
+ * Last updated: Fri, 06 Mar 2026 00:57:44 GMT
  * Dependencies: [undici-types](https://npmjs.com/package/undici-types)
 
 # Credits
-These definitions were written by [Microsoft TypeScript](https://github.com/Microsoft), [Alberto Schiabel](https://github.com/jkomyno), [Andrew Makarov](https://github.com/r3nya), [Benjamin Toueg](https://github.com/btoueg), [David Junger](https://github.com/touffy), [Mohsen Azimi](https://github.com/mohsen1), [Nikita Galkin](https://github.com/galkin), [Sebastian Silbermann](https://github.com/eps1lon), [Wilco Bakker](https://github.com/WilcoBakker), [Marcin Kopacz](https://github.com/chyzwar), [Trivikram Kamat](https://github.com/trivikr), [Junxiao Shi](https://github.com/yoursunny), [Ilia Baryshnikov](https://github.com/qwelias), [ExE Boss](https://github.com/ExE-Boss), [Piotr Błażejewicz](https://github.com/peterblazejewicz), [Anna Henningsen](https://github.com/addaleax), [Victor Perin](https://github.com/victorperin), [NodeJS Contributors](https://github.com/NodeJS), [Linus Unnebäck](https://github.com/LinusU), [wafuwafu13](https://github.com/wafuwafu13), [Matteo Collina](https://github.com/mcollina), and [Dmitry Semigradsky](https://github.com/Semigradsky).
+These definitions were written by [Microsoft TypeScript](https://github.com/Microsoft), [Alberto Schiabel](https://github.com/jkomyno), [Andrew Makarov](https://github.com/r3nya), [Benjamin Toueg](https://github.com/btoueg), [David Junger](https://github.com/touffy), [Mohsen Azimi](https://github.com/mohsen1), [Nikita Galkin](https://github.com/galkin), [Sebastian Silbermann](https://github.com/eps1lon), [Wilco Bakker](https://github.com/WilcoBakker), [Marcin Kopacz](https://github.com/chyzwar), [Trivikram Kamat](https://github.com/trivikr), [Junxiao Shi](https://github.com/yoursunny), [Ilia Baryshnikov](https://github.com/qwelias), [ExE Boss](https://github.com/ExE-Boss), [Piotr Błażejewicz](https://github.com/peterblazejewicz), [Anna Henningsen](https://github.com/addaleax), [Victor Perin](https://github.com/victorperin), [NodeJS Contributors](https://github.com/NodeJS), [Linus Unnebäck](https://github.com/LinusU), [wafuwafu13](https://github.com/wafuwafu13), [Matteo Collina](https://github.com/mcollina), [Dmitry Semigradsky](https://github.com/Semigradsky), [René](https://github.com/Renegade334), and [Yagiz Nizipli](https://github.com/anonrig).

package/node_modules/@types/node/assert/strict.d.ts

@@ -1,8 +1,105 @@
-declare module "assert/strict" {
-    import { strict } from "node:assert";
+/**
+ * In strict assertion mode, non-strict methods behave like their corresponding
+ * strict methods. For example, `assert.deepEqual()` will behave like
+ * `assert.deepStrictEqual()`.
+ *
+ * In strict assertion mode, error messages for objects display a diff. In legacy
+ * assertion mode, error messages for objects display the objects, often truncated.
+ *
+ * To use strict assertion mode:
+ *
+ * ```js
+ * import { strict as assert } from 'node:assert';
+ * ```
+ *
+ * ```js
+ * import assert from 'node:assert/strict';
+ * ```
+ *
+ * Example error diff:
+ *
+ * ```js
+ * import { strict as assert } from 'node:assert';
+ *
+ * assert.deepEqual([[[1, 2, 3]], 4, 5], [[[1, 2, '3']], 4, 5]);
+ * // AssertionError: Expected inputs to be strictly deep-equal:
+ * // + actual - expected ... Lines skipped
+ * //
+ * //   [
+ * //     [
+ * // ...
+ * //       2,
+ * // +     3
+ * // -     '3'
+ * //     ],
+ * // ...
+ * //     5
+ * //   ]
+ * ```
+ *
+ * To deactivate the colors, use the `NO_COLOR` or `NODE_DISABLE_COLORS`
+ * environment variables. This will also deactivate the colors in the REPL. For
+ * more on color support in terminal environments, read the tty
+ * [`getColorDepth()`](https://nodejs.org/docs/latest-v25.x/api/tty.html#writestreamgetcolordepthenv) documentation.
+ * @since v15.0.0
+ * @see [source](https://github.com/nodejs/node/blob/v25.x/lib/assert/strict.js)
+ */
+declare module "node:assert/strict" {
+    import {
+        Assert,
+        AssertionError,
+        AssertionErrorOptions,
+        AssertOptions,
+        AssertPredicate,
+        AssertStrict,
+        deepStrictEqual,
+        doesNotMatch,
+        doesNotReject,
+        doesNotThrow,
+        fail,
+        ifError,
+        match,
+        notDeepStrictEqual,
+        notStrictEqual,
+        ok,
+        partialDeepStrictEqual,
+        rejects,
+        strictEqual,
+        throws,
+    } from "node:assert";
+    function strict(value: unknown, message?: string | Error): asserts value;
+    namespace strict {
+        export {
+            Assert,
+            AssertionError,
+            AssertionErrorOptions,
+            AssertOptions,
+            AssertPredicate,
+            AssertStrict,
+            deepStrictEqual,
+            deepStrictEqual as deepEqual,
+            doesNotMatch,
+            doesNotReject,
+            doesNotThrow,
+            fail,
+            ifError,
+            match,
+            notDeepStrictEqual,
+            notDeepStrictEqual as notDeepEqual,
+            notStrictEqual,
+            notStrictEqual as notEqual,
+            ok,
+            partialDeepStrictEqual,
+            rejects,
+            strict,
+            strictEqual,
+            strictEqual as equal,
+            throws,
+        };
+    }
     export = strict;
 }
-declare module "node:assert/strict" {
-    import { strict } from "node:assert";
+declare module "assert/strict" {
+    import strict = require("node:assert/strict");
     export = strict;
 }