@pencil-agent/nano-pencil 1.14.1 → 1.14.3

package/dist/build-meta.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.14.1",
-  "commitHash": "b4f6f24",
+  "version": "1.14.3",
+  "commitHash": "1a4f55a",
   "branch": "main",
-  "builtAt": "2026-05-23T15:05:06.541Z"
+  "builtAt": "2026-05-27T01:43:40.032Z"
 }

package/dist/builtin-extensions.d.ts

@@ -4,6 +4,22 @@
  * [TO]: Consumed by main.ts, test files
  * [HERE]: builtin-extensions.ts - built-in extension registry for NanoPencil
  */
+export type BuiltinExtensionRiskLevel = "passive" | "command" | "tool" | "background" | "write-capable";
+export type BuiltinExtensionTestContract = "lifecycle" | "external-process" | "resource-discovery" | "write-guard";
+export interface BuiltinExtension {
+    id: string;
+    category: "default" | "optional" | "package";
+    defaultEnabled: boolean;
+    riskLevel: BuiltinExtensionRiskLevel;
+    requiresUI: boolean;
+    startsTimers: boolean;
+    writesWorkspace: boolean;
+    externalProcess: boolean;
+    resourceDiscovery?: boolean;
+    testContracts?: readonly BuiltinExtensionTestContract[];
+    testFiles?: readonly string[];
+}
+export declare const builtInExtensions: readonly BuiltinExtension[];
 /**
  * Get the list of built-in extension paths that NanoPencil loads by default
  *
@@ -14,7 +30,7 @@
  * - SecurityAudit (security audit)
  * - MCP (MCP protocol adapter)
  *
- * Optional extensions need to be enabled via configuration:
+ * Optional extensions need to be enabled via configuration or --extension:
  * - Simplify (code simplification) - extensions/optional/simplify/
  * - export-html (HTML export) - extensions/optional/export-html/
  */

package/dist/builtin-extensions.js

@@ -12,7 +12,6 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const require = createRequire(import.meta.url);
 /** Built-in extension paths */
 const BUNDLED_NANOMEM_EXTENSION_PACKAGES = join(__dirname, "packages", "mem-core", "extension.js");
-const BUNDLED_SIMPLIFY_EXTENSION = join(__dirname, "extensions", "optional", "simplify", "index.js");
 const BUNDLED_LINK_WORLD_EXTENSION = join(__dirname, "extensions", "defaults", "link-world", "index.js");
 const BUNDLED_BROWSER_EXTENSION = join(__dirname, "extensions", "defaults", "browser", "index.js");
 const BUNDLED_SECURITY_AUDIT_EXTENSION = join(__dirname, "extensions", "defaults", "security-audit", "index.js");
@@ -21,6 +20,7 @@ const BUNDLED_PRESENCE_EXTENSION = join(__dirname, "extensions", "defaults", "pr
 const BUNDLED_INTERVIEW_EXTENSION = join(__dirname, "extensions", "defaults", "interview", "index.js");
 const BUNDLED_LOOP_EXTENSION = join(__dirname, "extensions", "defaults", "loop", "index.js");
 const BUNDLED_PLAN_EXTENSION = join(__dirname, "extensions", "defaults", "plan", "index.js");
+const BUNDLED_DISCIPLINE_EXTENSION = join(__dirname, "extensions", "defaults", "discipline", "index.js");
 const BUNDLED_DIAGNOSTICS_EXTENSION = join(__dirname, "extensions", "defaults", "diagnostics", "index.js");
 const BUNDLED_SAL_EXTENSION = join(__dirname, "extensions", "defaults", "sal", "index.js");
 const BUNDLED_TOKEN_SAVE_EXTENSION = join(__dirname, "extensions", "defaults", "token-save", "index.js");
@@ -32,7 +32,31 @@ const BUNDLED_BTW_EXTENSION = join(__dirname, "extensions", "defaults", "btw", "
 const BUNDLED_RECAP_EXTENSION = join(__dirname, "extensions", "defaults", "recap", "index.js");
 const BUNDLED_DEBUG_EXTENSION = join(__dirname, "extensions", "defaults", "debug", "index.js");
 const BUNDLED_MCP_EXTENSION = join(__dirname, "extensions", "defaults", "mcp", "index.js");
-const BUNDLED_EXPORT_HTML_EXTENSION = join(__dirname, "extensions", "optional", "export-html", "index.js");
+export const builtInExtensions = [
+    { id: "diagnostics", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: true, writesWorkspace: false, externalProcess: false, testContracts: ["lifecycle"], testFiles: ["test/diagnostic-buffer-throttle.test.ts", "test/diagnostics-runtime.test.ts"] },
+    { id: "sal", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false, testContracts: ["lifecycle"], testFiles: ["test/sal-lifecycle.test.ts"] },
+    { id: "token-save", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "nanomem", category: "package", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false, testContracts: ["lifecycle"], testFiles: ["packages/mem-core/test/extension-commands.test.ts"] },
+    { id: "link-world", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true, resourceDiscovery: true, testContracts: ["external-process", "resource-discovery"], testFiles: ["test/link-world-extension-registration.test.ts"] },
+    { id: "browser", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true, resourceDiscovery: true, testContracts: ["external-process", "resource-discovery"], testFiles: ["test/browser-extension-registration.test.ts"] },
+    { id: "security-audit", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "soul", category: "default", defaultEnabled: true, riskLevel: "passive", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "presence", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: true, startsTimers: true, writesWorkspace: false, externalProcess: false, testContracts: ["lifecycle"], testFiles: ["test/presence-opening.test.ts", "test/presence-locale.test.ts"] },
+    { id: "interview", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "grub", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true, testContracts: ["lifecycle", "external-process"], testFiles: ["test/grub-controller.test.ts"] },
+    { id: "loop", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: true, writesWorkspace: false, externalProcess: false, testContracts: ["lifecycle"], testFiles: ["test/loop-lifecycle.test.ts"] },
+    { id: "plan", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "discipline", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false, resourceDiscovery: true, testContracts: ["resource-discovery"], testFiles: ["test/discipline-extension.test.ts", "test/extension-smoke.test.ts"] },
+    { id: "subagent", category: "default", defaultEnabled: true, riskLevel: "tool", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true, testContracts: ["external-process"], testFiles: ["test/subagent-parser.test.ts", "test/worktree-manager.test.ts"] },
+    { id: "team", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true, testContracts: ["lifecycle", "external-process"], testFiles: ["test/team-runtime.test.ts"] },
+    { id: "idle-think", category: "default", defaultEnabled: true, riskLevel: "background", requiresUI: true, startsTimers: true, writesWorkspace: false, externalProcess: true, testContracts: ["lifecycle", "external-process"], testFiles: ["test/idle-think-runtime.test.ts", "test/extension-smoke.test.ts"] },
+    { id: "btw", category: "default", defaultEnabled: true, riskLevel: "command", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "recap", category: "default", defaultEnabled: true, riskLevel: "command", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "debug", category: "default", defaultEnabled: true, riskLevel: "command", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: false },
+    { id: "mcp", category: "default", defaultEnabled: true, riskLevel: "command", requiresUI: false, startsTimers: false, writesWorkspace: false, externalProcess: true, resourceDiscovery: true, testContracts: ["external-process", "resource-discovery"], testFiles: ["test/resource-discovery-contract.test.ts"] },
+    { id: "simplify", category: "optional", defaultEnabled: false, riskLevel: "write-capable", requiresUI: false, startsTimers: false, writesWorkspace: true, externalProcess: true, testContracts: ["external-process", "write-guard"], testFiles: ["test/simplify-extension.test.ts"] },
+    { id: "export-html", category: "optional", defaultEnabled: false, riskLevel: "write-capable", requiresUI: false, startsTimers: false, writesWorkspace: true, externalProcess: false, testContracts: ["write-guard"], testFiles: ["test/extension-smoke.test.ts", "test/export-html-branch-navigation.test.ts"] },
+];
 /** Find package root from current module location (containing package.json with nano-pencil related name) */
 function findPackageRoot(startDir) {
     let dir = startDir;
@@ -66,7 +90,7 @@ function findPackageRoot(startDir) {
  * - SecurityAudit (security audit)
  * - MCP (MCP protocol adapter)
  *
- * Optional extensions need to be enabled via configuration:
+ * Optional extensions need to be enabled via configuration or --extension:
  * - Simplify (code simplification) - extensions/optional/simplify/
  * - export-html (HTML export) - extensions/optional/export-html/
  */
@@ -135,16 +159,6 @@ export function getBuiltinExtensionPaths() {
             }
         }
     }
-    // === Simplify extension (optional source, compiled to dist/extensions/optional/simplify) ===
-    if (existsSync(BUNDLED_SIMPLIFY_EXTENSION)) {
-        paths.push(BUNDLED_SIMPLIFY_EXTENSION);
-    }
-    else {
-        // Development mode: try .ts source file
-        const simplifyTs = join(__dirname, "extensions", "optional", "simplify", "index.ts");
-        if (existsSync(simplifyTs))
-            paths.push(simplifyTs);
-    }
     // === link-world extension (built-in source, compiled to dist/extensions/defaults/link-world) ===
     if (existsSync(BUNDLED_LINK_WORLD_EXTENSION)) {
         paths.push(BUNDLED_LINK_WORLD_EXTENSION);
@@ -226,7 +240,15 @@ export function getBuiltinExtensionPaths() {
         if (existsSync(planTs))
             paths.push(planTs);
     }
-    // === MCP extension (MCP tool protocol adapter) ===
+    // === Discipline extension (default engineering workflow skills and bootstrap) ===
+    if (existsSync(BUNDLED_DISCIPLINE_EXTENSION)) {
+        paths.push(BUNDLED_DISCIPLINE_EXTENSION);
+    }
+    else {
+        const disciplineTs = join(__dirname, "extensions", "defaults", "discipline", "index.ts");
+        if (existsSync(disciplineTs))
+            paths.push(disciplineTs);
+    }
     // Built-in SubAgent extension
     if (existsSync(BUNDLED_SUBAGENT_EXTENSION)) {
         paths.push(BUNDLED_SUBAGENT_EXTENSION);
@@ -290,15 +312,6 @@ export function getBuiltinExtensionPaths() {
         if (existsSync(mcpTs))
             paths.push(mcpTs);
     }
-    // === export-html extension (optional, HTML export functionality) ===
-    if (existsSync(BUNDLED_EXPORT_HTML_EXTENSION)) {
-        paths.push(BUNDLED_EXPORT_HTML_EXTENSION);
-    }
-    else {
-        const exportHtmlTs = join(__dirname, "extensions", "optional", "export-html", "index.ts");
-        if (existsSync(exportHtmlTs))
-            paths.push(exportHtmlTs);
-    }
     return paths;
 }
 /**

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

@@ -43,6 +43,9 @@ export interface MarkdownSettings {
     codeBlockIndent?: string;
 }
 export type TransportSetting = Transport;
+export type AgentLoopFrameworkSetting = "standard" | "weak-model-compatible";
+export type AgentLoopFrameworkSettingInput = AgentLoopFrameworkSetting | "high-intelligence" | "low-intelligence" | "structured-adaptive";
+export declare function normalizeAgentLoopFrameworkSetting(value: AgentLoopFrameworkSettingInput | undefined): AgentLoopFrameworkSetting | undefined;
 /**
  * Package source for npm/git packages.
  * - String form: load all resources from the package
@@ -61,6 +64,7 @@ export interface Settings {
     defaultProvider?: string;
     defaultModel?: string;
     defaultThinkingLevel?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    agentLoopFramework?: AgentLoopFrameworkSettingInput;
     transport?: TransportSetting;
     steeringMode?: "all" | "one-at-a-time";
     followUpMode?: "all" | "one-at-a-time";
@@ -213,6 +217,8 @@ export declare class SettingsManager {
     setTheme(theme: string): void;
     getDefaultThinkingLevel(): "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     setDefaultThinkingLevel(level: "off" | "minimal" | "low" | "medium" | "high" | "xhigh"): void;
+    getAgentLoopFramework(): AgentLoopFrameworkSetting | undefined;
+    setAgentLoopFramework(framework: AgentLoopFrameworkSettingInput | undefined): void;
     getTransport(): TransportSetting;
     setTransport(transport: TransportSetting): void;
     getCompactionEnabled(): boolean;

package/dist/core/config/settings-manager.js

@@ -4,6 +4,13 @@ import lockfile from "proper-lockfile";
 import { APP_NAME, CONFIG_DIR_NAME } from "../../config.js";
 import { defaultAgentDirContext } from "../agent-dir/agent-dir-context.js";
 import { readFile, writeFile, mkdir } from "node:fs/promises";
+export function normalizeAgentLoopFrameworkSetting(value) {
+    if (value === "high-intelligence")
+        return "standard";
+    if (value === "low-intelligence" || value === "structured-adaptive")
+        return "weak-model-compatible";
+    return value;
+}
 /** Deep merge settings: project/overrides take precedence, nested objects merge recursively */
 function deepMergeSettings(base, overrides) {
     const result = { ...base };
@@ -564,6 +571,20 @@ export class SettingsManager {
         this.markModified("defaultThinkingLevel");
         this.save();
     }
+    getAgentLoopFramework() {
+        return normalizeAgentLoopFrameworkSetting(this.settings.agentLoopFramework);
+    }
+    setAgentLoopFramework(framework) {
+        const normalized = normalizeAgentLoopFrameworkSetting(framework);
+        if (normalized === undefined) {
+            delete this.globalSettings.agentLoopFramework;
+        }
+        else {
+            this.globalSettings.agentLoopFramework = normalized;
+        }
+        this.markModified("agentLoopFramework");
+        this.save();
+    }
     getTransport() {
         return this.settings.transport ?? "sse";
     }

package/dist/core/extensions/runner.d.ts

@@ -81,6 +81,7 @@ export declare class ExtensionRunner {
     private getSystemPromptFn;
     private getSoulManagerFn;
     private getSettingsFn;
+    private getSkillsFn;
     private newSessionHandler;
     private forkHandler;
     private navigateTreeHandler;

package/dist/core/extensions/runner.js

@@ -99,6 +99,7 @@ export class ExtensionRunner {
     getSystemPromptFn = () => "";
     getSoulManagerFn = () => undefined;
     getSettingsFn = () => ({});
+    getSkillsFn = () => [];
     newSessionHandler = async () => ({ cancelled: false });
     forkHandler = async () => ({ cancelled: false });
     navigateTreeHandler = async () => ({ cancelled: false });
@@ -175,6 +176,7 @@ export class ExtensionRunner {
         this.getSystemPromptFn = contextActions.getSystemPrompt;
         this.getSoulManagerFn = contextActions.getSoulManager;
         this.getSettingsFn = contextActions.getSettings;
+        this.getSkillsFn = contextActions.getSkills;
         // Process provider registrations queued during extension loading
         for (const { name, config } of this.runtime.pendingProviderRegistrations) {
             this.modelRegistry.registerProvider(name, config);
@@ -413,6 +415,7 @@ export class ExtensionRunner {
             getSystemPrompt: () => this.getSystemPromptFn(),
             getSoulManager: () => this.getSoulManagerFn(),
             getSettings: () => this.getSettingsFn(),
+            getSkills: () => this.getSkillsFn(),
         };
     }
     createCommandContext() {

package/dist/core/extensions/types.d.ts

@@ -18,6 +18,7 @@ import type { KeybindingsManager } from "../keybindings.js";
 import type { CustomMessage } from "../messages.js";
 import type { ModelRegistry } from "../model-registry.js";
 import type { BranchSummaryEntry, CompactionEntry, ReadonlySessionManager, SessionEntry, SessionManager } from "../session/session-manager.js";
+import type { Skill } from "../skills.js";
 import type { SlashCommandInfo } from "../slash-commands.js";
 import type { BashOperations } from "../tools/bash.js";
 import type { EditToolDetails } from "../tools/edit.js";
@@ -232,6 +233,8 @@ export interface ExtensionContext {
     getSoulManager(): unknown | undefined;
     /** Get current merged settings (project overrides global). */
     getSettings(): import("../config/settings-manager.js").Settings;
+    /** Get currently loaded skills after user/project/default resource precedence is applied. */
+    getSkills(): readonly Skill[];
 }
 /**
  * Extended context for command handlers.
@@ -294,7 +297,7 @@ export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = un
     interruptBehavior?: "cancel" | "block";
     /** Optional semantic validation after schema validation and before execute. */
     validateInput?: (params: Static<TParams>) => void | string | Promise<void | string>;
-    /** Optional maximum text result size enforced by low-intelligence-adaptation tool orchestration. */
+    /** Optional maximum text result size enforced by weak-model-compatible tool orchestration. */
     maxResultSizeChars?: number;
     /** Usage guidance for system prompt (optional) */
     guidance?: string;
@@ -802,14 +805,14 @@ export interface ExtensionAPI {
      *   api: "anthropic-messages",
      *   models: [
      *     {
-     *       id: "high-intelligence-model",
-     *       name: "High Intelligence Model (proxy)",
+     *       id: "example-model",
+     *       name: "Example Model (proxy)",
      *       reasoning: false,
      *       input: ["text", "image"],
      *       cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
      *       contextWindow: 200000,
      *       maxTokens: 16384,
-     *       agentLoopFramework: "low-intelligence"
+     *       agentLoopFramework: "weak-model-compatible"
      *     }
      *   ]
      * });
@@ -870,9 +873,9 @@ export interface ProviderConfig {
 }
 /** Configuration for a model within a provider. */
 export interface ProviderModelConfig {
-    /** Model ID (e.g., "high-intelligence-model"). */
+    /** Model ID (e.g., "example-model"). */
     id: string;
-    /** Display name (e.g., "High Intelligence Model"). */
+    /** Display name (e.g., "Example Model"). */
     name: string;
     /** API type override for this model. */
     api?: Api;
@@ -994,6 +997,7 @@ export interface ExtensionContextActions {
     getSystemPrompt: () => string;
     getSoulManager: () => unknown | undefined;
     getSettings: () => import("../config/settings-manager.js").Settings;
+    getSkills: () => readonly Skill[];
 }
 /**
  * Actions for ExtensionCommandContext (ctx.* in command handlers).

package/dist/core/i18n/slash-commands.d.ts

@@ -5,6 +5,16 @@
  * [HERE]: core/i18n/slash-commands.ts - English slash command translations
  */
 export declare const slashCommands: {
+    categories: {
+        core: string;
+        model: string;
+        memory: string;
+        session: string;
+        workflow: string;
+        agents: string;
+        tools: string;
+        admin: string;
+    };
     settings: string;
     model: string;
     "agent-loop": string;
@@ -24,6 +34,7 @@ export declare const slashCommands: {
     usage: string;
     changelog: string;
     hotkeys: string;
+    resources: string;
     fork: string;
     tree: string;
     login: string;

package/dist/core/i18n/slash-commands.js

@@ -5,16 +5,26 @@
  * [HERE]: core/i18n/slash-commands.ts - English slash command translations
  */
 export const slashCommands = {
+    categories: {
+        core: "Core",
+        model: "Models",
+        memory: "Memory",
+        session: "Sessions",
+        workflow: "Workflows",
+        agents: "Agents",
+        tools: "Tools",
+        admin: "Admin",
+    },
     settings: "Open settings menu",
     model: "Select model (opens selector UI)",
-    "agent-loop": "Set high/low-intelligence agent loop adaptation for this session",
-    "scoped-models": "Enable/disable models for Ctrl+P cycling",
+    "agent-loop": "Choose how the agent keeps working through a task",
+    "scoped-models": "Choose which models appear in quick switching",
     apikey: "Update API key for current provider",
     mcp: "Manage MCP servers (list, enable, disable)",
     soul: "Show AI personality and stats (Soul)",
     persona: "Switch AI persona/personality pack",
     memory: "Show project memory and knowledge (NanoMem)",
-    dream: "Consolidate project memory (NanoMem)",
+    dream: "Refresh long-term project memory (NanoMem)",
     export: "Export session to HTML file",
     share: "Share session as a secret GitHub gist",
     copy: "Copy last agent message to clipboard",
@@ -24,6 +34,7 @@ export const slashCommands = {
     usage: "Show token usage and cost stats",
     changelog: "Show changelog entries",
     hotkeys: "Show all keyboard shortcuts",
+    resources: "Show loaded extensions, prompts, skills, and themes",
     fork: "Create a new fork from a previous message",
     tree: "Navigate session tree (switch branches)",
     login: "Login with OAuth provider",
@@ -34,7 +45,7 @@ export const slashCommands = {
     compact: "Manually compact the session context",
     resume: "Resume a different session",
     reload: "Reload extensions, skills, prompts, and themes",
-    "link-world": "Install link-world for internet access (Twitter, YouTube, etc.)",
+    "link-world": "Set up internet access tools",
     quit: "Quit NanoPencil",
     language: "Switch language (English/Chinese)",
 };

package/dist/core/i18n/slash-commands.zh.d.ts

@@ -5,6 +5,16 @@
  * [HERE]: core/i18n/slash-commands.zh.ts - Chinese slash command translations
  */
 export declare const slashCommands: {
+    categories: {
+        core: string;
+        model: string;
+        memory: string;
+        session: string;
+        workflow: string;
+        agents: string;
+        tools: string;
+        admin: string;
+    };
     settings: string;
     model: string;
     "agent-loop": string;
@@ -24,6 +34,7 @@ export declare const slashCommands: {
     usage: string;
     changelog: string;
     hotkeys: string;
+    resources: string;
     fork: string;
     tree: string;
     login: string;

package/dist/core/i18n/slash-commands.zh.js

@@ -5,16 +5,26 @@
  * [HERE]: core/i18n/slash-commands.zh.ts - Chinese slash command translations
  */
 export const slashCommands = {
+    categories: {
+        core: "核心",
+        model: "模型",
+        memory: "记忆",
+        session: "会话",
+        workflow: "工作流",
+        agents: "Agent",
+        tools: "工具",
+        admin: "管理",
+    },
     settings: "打开设置菜单",
     model: "选择模型（打开选择器界面）",
-    "agent-loop": "设置本会话的高智能/低智能 agent loop 适配",
-    "scoped-models": "启用/禁用 Ctrl+P 循环的模型",
+    "agent-loop": "选择 agent 推进任务的方式",
+    "scoped-models": "选择快速切换里出现的模型",
     apikey: "更新当前提供商的 API 密钥",
     mcp: "管理 MCP 服务器（列出、启用、禁用）",
     soul: "显示 AI 人格和统计（灵魂）",
     persona: "切换 AI 人格/个性包",
     memory: "显示项目记忆和知识（纳米记忆）",
-    dream: "整合项目记忆（纳米记忆）",
+    dream: "刷新长期项目记忆（纳米记忆）",
     export: "将会话导出为 HTML 文件",
     share: "将会话分享为保密的 GitHub gist",
     copy: "复制上一条 AI 消息到剪贴板",
@@ -24,6 +34,7 @@ export const slashCommands = {
     usage: "显示 token 使用量和费用统计",
     changelog: "显示更新日志条目",
     hotkeys: "显示所有键盘快捷键",
+    resources: "显示已加载的扩展、提示、技能和主题",
     fork: "从上一条消息创建新分支",
     tree: "导航会话树（切换分支）",
     login: "通过 OAuth 提供商登录",
@@ -34,7 +45,7 @@ export const slashCommands = {
     compact: "手动压缩会话上下文",
     resume: "恢复其他会话",
     reload: "重新加载扩展、技能、提示和主题",
-    "link-world": "安装 link-world 以获得互联网访问（Twitter、YouTube 等）",
+    "link-world": "设置联网访问工具",
     quit: "退出 NanoPencil",
     language: "切换语言（English/中文）",
 };

package/dist/core/model-registry.d.ts

@@ -7,8 +7,8 @@
 import { type Api, type AssistantMessageEventStream, type Context, type Model, type OAuthProviderInterface, type SimpleStreamOptions } from "@pencil-agent/ai";
 import type { AuthStorage } from "./config/auth-storage.js";
 import { clearConfigValueCache } from "./config/resolve-config-value.js";
-type AgentLoopFramework = "high-intelligence" | "low-intelligence";
-type AgentLoopFrameworkInput = AgentLoopFramework | "standard" | "structured-adaptive";
+type AgentLoopFramework = "standard" | "weak-model-compatible";
+type AgentLoopFrameworkInput = AgentLoopFramework | "high-intelligence" | "low-intelligence" | "structured-adaptive";
 /** Clear the config value command cache. Exported for testing. */
 export declare const clearApiKeyCache: typeof clearConfigValueCache;
 /**

package/dist/core/model-registry.js

@@ -42,9 +42,10 @@ const OpenAIResponsesCompatSchema = Type.Object({
 });
 const OpenAICompatSchema = Type.Union([OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema]);
 const AgentLoopFrameworkSchema = Type.Union([
+    Type.Literal("standard"),
+    Type.Literal("weak-model-compatible"),
     Type.Literal("high-intelligence"),
     Type.Literal("low-intelligence"),
-    Type.Literal("standard"),
     Type.Literal("structured-adaptive"),
 ]);
 // Schema for custom model definition
@@ -85,10 +86,10 @@ const ModelOverrideSchema = Type.Object({
     compat: Type.Optional(OpenAICompatSchema),
 });
 function normalizeAgentLoopFramework(value) {
-    if (value === "standard")
-        return "high-intelligence";
-    if (value === "structured-adaptive")
-        return "low-intelligence";
+    if (value === "high-intelligence")
+        return "standard";
+    if (value === "low-intelligence" || value === "structured-adaptive")
+        return "weak-model-compatible";
     return value;
 }
 const ProviderConfigSchema = Type.Object({

package/dist/core/runtime/agent-session.d.ts

@@ -24,7 +24,7 @@ import { AgentDirContext } from "../agent-dir/agent-dir-context.js";
 import type { BashOperations } from "../tools/bash.js";
 import { type SessionSlashCommandDescriptor } from "./slash-command-catalog.js";
 export type { SessionSlashCommandDescriptor } from "./slash-command-catalog.js";
-type AgentLoopFrameworkInput = AgentLoopFramework | "standard" | "structured-adaptive";
+type AgentLoopFrameworkInput = AgentLoopFramework | "high-intelligence" | "low-intelligence" | "structured-adaptive";
 /** Parsed skill block from a user message */
 export interface ParsedSkillBlock {
     name: string;

package/dist/core/runtime/extension-core-bindings.js

@@ -173,5 +173,6 @@ export function bindExtensionCore(runner, host) {
         },
         getSystemPrompt: () => host.systemPrompt,
         getSoulManager: () => host.soulManager,
+        getSkills: () => host.resourceLoader.getSkills().skills,
     });
 }

package/dist/core/runtime/sdk.js

@@ -247,6 +247,7 @@ export async function createAgentSession(options = {}) {
         steeringMode: settingsManager.getSteeringMode(),
         followUpMode: settingsManager.getFollowUpMode(),
         transport: settingsManager.getTransport(),
+        agentLoopFramework: settingsManager.getAgentLoopFramework(),
         thinkingBudgets: settingsManager.getThinkingBudgets(),
         maxRetryDelayMs: settingsManager.getRetrySettings().maxDelayMs,
         getApiKey: async (provider) => {

package/dist/core/runtime/slash-command-catalog.d.ts

@@ -7,11 +7,12 @@
 import type { ResourceLoader } from "../config/resource-loader.js";
 import type { ExtensionRunner } from "../extensions/index.js";
 import type { PromptTemplate } from "../prompt/prompt-templates.js";
-import { getLocalizedCommands, type SlashCommandInfo } from "../slash-commands.js";
+import { getLocalizedCommands, type SlashCommandInfo, type SlashCommandCategory } from "../slash-commands.js";
 export interface SessionSlashCommandDescriptor {
     name: string;
     description?: string;
     source: "builtin" | SlashCommandInfo["source"];
+    category?: SlashCommandCategory;
 }
 type Translate = Parameters<typeof getLocalizedCommands>[0];
 export interface SlashCommandCatalogSource {

package/dist/core/runtime/slash-command-catalog.js

@@ -1,4 +1,4 @@
-import { BUILTIN_SLASH_COMMANDS, getLocalizedCommands, } from "../slash-commands.js";
+import { BUILTIN_SLASH_COMMANDS, getLocalizedCommands, inferSlashCommandCategory, } from "../slash-commands.js";
 function normalizeLocation(source) {
     if (source === "user" || source === "project" || source === "path") {
         return source;
@@ -16,6 +16,7 @@ function getExtensionCommands(runner, reservedBuiltins) {
         name: command.name,
         description: command.description,
         path: extensionPath,
+        category: inferSlashCommandCategory(command.name, "extension"),
     })) ?? []);
 }
 export function buildSessionSlashCommands(source, translate) {
@@ -23,22 +24,26 @@ export function buildSessionSlashCommands(source, translate) {
         name: command.name,
         description: command.description,
         source: "builtin",
+        category: command.category,
     }));
     const reservedBuiltins = getReservedBuiltinNames();
     const extensionCommands = getExtensionCommands(source.extensionRunner, reservedBuiltins).map((command) => ({
         name: command.name,
         description: command.description,
         source: "extension",
+        category: command.category,
     }));
     const promptCommands = source.promptTemplates.map((template) => ({
         name: template.name,
         description: template.description,
         source: "prompt",
+        category: inferSlashCommandCategory(template.name, "prompt"),
     }));
     const skillCommands = source.resourceLoader.getSkills().skills.map((skill) => ({
         name: `skill:${skill.name}`,
         description: skill.description,
         source: "skill",
+        category: inferSlashCommandCategory(skill.name, "skill"),
     }));
     return [
         ...builtins,
@@ -53,12 +58,14 @@ export function buildExtensionSlashCommands(source) {
         name: command.name,
         description: command.description,
         source: "extension",
+        category: command.category,
         path: command.path,
     }));
     const templates = source.promptTemplates.map((template) => ({
         name: template.name,
         description: template.description,
         source: "prompt",
+        category: inferSlashCommandCategory(template.name, "prompt"),
         location: normalizeLocation(template.source),
         path: template.filePath,
     }));
@@ -68,6 +75,7 @@ export function buildExtensionSlashCommands(source) {
         name: `skill:${skill.name}`,
         description: skill.description,
         source: "skill",
+        category: inferSlashCommandCategory(skill.name, "skill"),
         location: normalizeLocation(skill.source),
         path: skill.filePath,
     }));

package/dist/core/slash-commands.d.ts

@@ -1,25 +1,33 @@
 /**
- * [WHO]: SlashCommandInfo, BuiltinSlashCommand, slashCommand definitions, getLocalizedCommands()
+ * [WHO]: SlashCommandInfo, BuiltinSlashCommand, slashCommand definitions, category helpers, getLocalizedCommands()
  * [FROM]: No external dependencies
  * [TO]: Consumed by modes/interactive/interactive-mode.ts, modes/acp/acp-mode.ts
  * [HERE]: core/slash-commands.ts - slash command types and registry
  */
 export type SlashCommandSource = "extension" | "prompt" | "skill";
 export type SlashCommandLocation = "user" | "project" | "path";
+export type SlashCommandCategory = "core" | "model" | "memory" | "session" | "workflow" | "agents" | "tools" | "admin";
 export interface SlashCommandInfo {
     name: string;
     description?: string;
     source: SlashCommandSource;
+    category?: SlashCommandCategory;
     location?: SlashCommandLocation;
     path?: string;
 }
 export interface BuiltinSlashCommand {
     name: string;
     descriptionKey: string;
+    category: SlashCommandCategory;
 }
 export declare const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand>;
+export declare function inferSlashCommandCategory(name: string, source?: SlashCommandSource): SlashCommandCategory;
+export declare function getSlashCommandCategoryLabel(category: SlashCommandCategory, t: (key: string) => string): string;
+export declare function formatSlashCommandDescription(description: string | undefined, category: SlashCommandCategory | undefined, t: (key: string) => string): string | undefined;
 export interface LocalizedSlashCommand {
     name: string;
     description: string;
+    category: SlashCommandCategory;
+    categoryLabel: string;
 }
 export declare function getLocalizedCommands(t: (key: string) => string): LocalizedSlashCommand[];