@agi-fans/oh-my-dsh 0.11.0 → 0.13.0

package/README.md

@@ -6,7 +6,7 @@
 
 **Into the Unknown**
 
-A focused, keyboard-first DeepSeek coding agent built on the plugin architecture of [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) and inspired by the interaction quality of [oh-my-pi](https://github.com/can1357/oh-my-pi) and the original [Pi](https://github.com/earendil-works/pi) agent harness.
+omdsh is a focused, keyboard-first DeepSeek coding agent built on the plugin architecture of [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) and inspired by the interaction quality of [oh-my-pi](https://github.com/can1357/oh-my-pi) and the original [Pi](https://github.com/earendil-works/pi) agent harness.
 
 [![CI](https://github.com/agi-fans/oh-my-dsh/actions/workflows/ci.yml/badge.svg)](https://github.com/agi-fans/oh-my-dsh/actions/workflows/ci.yml) [![npm version](https://img.shields.io/npm/v/%40agi-fans%2Foh-my-dsh?style=flat-square&logo=npm)](https://www.npmjs.com/package/@agi-fans/oh-my-dsh) [![npm downloads](https://img.shields.io/npm/dm/%40agi-fans%2Foh-my-dsh?style=flat-square&logo=npm)](https://www.npmjs.com/package/@agi-fans/oh-my-dsh) [![Node.js ^22.19 or >=24](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-339933?style=flat-square&logo=node.js)](https://nodejs.org/) [![MIT License](https://img.shields.io/npm/l/%40agi-fans%2Foh-my-dsh?style=flat-square)](https://github.com/agi-fans/oh-my-dsh/blob/main/LICENSE)
 
@@ -30,21 +30,22 @@ Run `/login` once inside omdsh to validate and save your DeepSeek API key, then
 ## Highlights
 
 - **Durable conversations:** search, pin, rename, and resume sessions in `/sessions`; rewind, retry, compact, and export complete transcripts as Markdown or standalone HTML.
-- **Four real session controls:** choose a Harness Agent preset (Standard, PTC, Minimal, or Cordis), Workflow (Default or Plan), tool presentation (Native, Code, or Both), and Access (Read only, Workspace write, or Full access).
+- **Three real session controls:** choose a Harness Agent preset (Standard, PTC, Minimal, or Cordis), Workflow (Default or Plan), and Access (Read only, Workspace write, or Full access). Each Agent preset owns its tool exposure; PTC uses the generated TypeScript SDK automatically.
 - **Rich terminal input:** mention project files and other sessions with `@`, paste clipboard images, reuse persistent prompt history, edit multiline prompts externally, and retrieve queued follow-ups.
 - **Readable tool activity:** follow streaming calls and live subagent progress, press Down on an empty composer then Enter (or use Alt+A directly) to select a child in the keyboard-driven Agent Hub, steer a continuable child from its transcript, inspect distinct Input and Output sections, expand long results, and keep domain-specific presentation owned by tool plugins.
-- **Live operational context:** see Agent, Workflow, Tools, Access, model, reasoning effort, workspace, Git state, context pressure, tokens, TTFT, throughput, cache, timings, turns, and steps without leaving the composer; use `/context` for an inline projection-backed breakdown that remains in the transcript.
+- **Live operational context:** see Agent, Workflow, Access, model, reasoning effort, workspace, Git state, context pressure, tokens, TTFT, throughput, cache, timings, turns, and steps without leaving the composer; use `/context` for an inline projection-backed breakdown that remains in the transcript.
 - **Responsive by design:** retain settled transcript layout, coalesce scroll updates, emit row-level terminal diffs, and preserve correct display-cell alignment for CJK text and emoji.
 
 ## Learn
 
 The full documentation is also published on the [official site](https://omdsh.agi.fans/).
 
-- [Tutorials](https://omdsh.agi.fans/docs/tutorials) — complete a first task, add precise context, guide queued work, recover long sessions, customize the environment, and write an installable plugin.
-- [Skills and MCP](https://omdsh.agi.fans/docs/skills-and-mcp) — extend a project with reusable instructions and external tools.
-- [User plugins](https://omdsh.agi.fans/docs/plugins) — install DSH bundles into the omdsh Profile with `omdsh plugin`.
-- [Architecture](https://omdsh.agi.fans/docs/architecture) — understand the plugin boundaries and runtime data flow.
-- [Performance](https://omdsh.agi.fans/docs/performance) — inspect the benchmarks, methodology, and rendering optimizations.
+- [Tutorials](https://omdsh.agi.fans/docs/tutorials/) — complete a first task, add precise context, guide queued work, recover long sessions, customize the environment, and write an installable plugin.
+- [Skills and MCP](https://omdsh.agi.fans/docs/skills-and-mcp/) — extend a project with reusable instructions and external tools.
+- [User plugins](https://omdsh.agi.fans/docs/plugins/) — install DSH bundles into the omdsh Profile with `omdsh plugin`.
+- [Architecture](https://omdsh.agi.fans/docs/architecture/) — understand the plugin boundaries and runtime data flow.
+- [Performance](https://omdsh.agi.fans/docs/performance/) — inspect the benchmarks, methodology, and rendering optimizations.
+- [Report a bug or request a feature](https://github.com/agi-fans/oh-my-dsh/issues/new/choose) — use a guided form to include the version, environment, reproduction steps, and sanitized context.
 
 ## Why oh-my-dsh
 
@@ -73,19 +74,19 @@ DeepSeek Harness plugins and services
   @agi-fans/oh-my-dsh — boot and plugin composition
 ```
 
-The TUI package is split into a service definition, local terminal Provider, session and interaction adapters, tool-presentation bridge, command contributions, and interactive Runner. This isolates terminal ownership from Harness domain state and exposes plugin seams only where a capability has an independent lifecycle or owner. See the [architecture overview](https://omdsh.agi.fans/docs/architecture) for the current boundaries and data flow.
+The TUI package is split into a service definition, local terminal Provider, session and interaction adapters, tool-presentation bridge, command contributions, and interactive Runner. This isolates terminal ownership from Harness domain state and exposes plugin seams only where a capability has an independent lifecycle or owner. See the [architecture overview](https://omdsh.agi.fans/docs/architecture/) for the current boundaries and data flow.
 
 ## Performance
 
 Performance is part of the TUI architecture: durable sessions replay in linear time, Harness Projections avoid repeated history scans, settled transcript blocks retain formatted layout, and the terminal writer emits row-level diffs. On the documented Apple M5 Pro environment, restoring 10,000 conversation turns takes a median 2.62 ms, 10,000 tool calls take 22.71 ms, and rendering cached frames over a 5,000-turn surface averages 0.35 ms per frame.
 
-See the reproducible [TUI performance report](https://omdsh.agi.fans/docs/performance) or run `pnpm benchmark:tui` locally.
+See the reproducible [TUI performance report](https://omdsh.agi.fans/docs/performance/) or run `pnpm benchmark:tui` locally.
 
 ## Configuration
 
 Run `/login` to configure a provider. DeepSeek still opens the official key dashboard, validates the key, and prefers the stored credential over an inherited `DEEPSEEK_API_KEY`. When a mounted provider registers a Harness authorization flow, `/login` lists that flow and its methods and the terminal only renders the notices and prompts the flow asks for. The same command can also activate a catalog API-key provider or add a custom provider with its own id, base URL, protocol, and model ids. `/model` then lists every live route. `/logout` removes an omdsh-managed choice and, for DeepSeek, falls back to the environment when available.
 
-Model settings can also come from `$DSH_HOME/settings.yaml`. Use `/model favorite` and `/model unfavorite` to maintain a small local cycle list, then use `Ctrl+P`/`Alt+P` to move through it and `Ctrl+T` to change reasoning effort. Skills and MCP configuration are documented in [Skills and MCP](https://omdsh.agi.fans/docs/skills-and-mcp).
+Model settings can also come from `$DSH_HOME/settings.yaml`. Use `/model favorite` and `/model unfavorite` to maintain a small local cycle list, then use `Ctrl+P`/`Alt+P` to move through it and `Ctrl+T` to change reasoning effort. Skills and MCP configuration are documented in [Skills and MCP](https://omdsh.agi.fans/docs/skills-and-mcp/).
 
 After an upgrade, omdsh can show release notes once at startup. Use `/changelog` for recent entries or `/changelog full` for the complete packaged history. A cached daily npm check reports newer versions without installing anything automatically; both behaviors can be customized in `/settings`. Terminal notifications for completed long turns and human prompts are also configured there and remain off by default.
 

package/config/agent-presets/minimal/agent.cordis.yml

@@ -1,7 +1,7 @@
 - id: persona
   name: '@deepseek-ai/dsh-persona'
   config:
-    text: You are a helpful software engineer assistant.
+    text: You are a helpful software engineer assistant.{{omdsh_agent_behavior}}
     complete: true
     includeRuntimeContext: false
 

package/config/cordis.yml

@@ -15,6 +15,10 @@
 
   - id: llm-deepseek
     name: '@deepseek-ai/dsh-llm-deepseek'
+    config:
+      # Current built-ins share this fallback. Exact catalog values still win,
+      # and omitting models keeps future adapter additions visible.
+      maxTokens: 384000
 
   - id: session
     name: '@deepseek-ai/dsh-session'
@@ -257,6 +261,9 @@
     config:
       model: !!js process.env.OMDSH_MODEL || 'deepseek-v4-flash'
 
+  - id: agent-behavior
+    name: '@agi-fans/oh-my-dsh/agent-behavior'
+
   - id: tui-tool-presentation
     name: '@agi-fans/dsh-tui/tool-presentation'
 

package/lib/agent-behavior.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Product-owned Agent behavior settings projected into the Harness system prompt.
+ * @module @agi-fans/oh-my-dsh/agent-behavior
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { AssembleContext } from '@deepseek-ai/dsh-system-prompt';
+import z from '@deepseek-ai/schemastery';
+import type { TuiAgentBehaviorSettings } from '@agi-fans/dsh-tui';
+export declare const name = "omdsh-agent-behavior";
+export declare const inject: string[];
+export declare const AGENT_BEHAVIOR_SETTINGS_NAMESPACE = "omdsh-agent";
+export declare const AGENT_BEHAVIOR_SECTION = "omdsh:agent-behavior";
+export declare const AGENT_BEHAVIOR_ORDER = 30;
+export declare const AGENT_BEHAVIOR_VARIABLE = "omdsh_agent_behavior";
+export declare const AGENT_LANGUAGES: readonly ["auto", "zh-CN", "en"];
+export type AgentLanguage = typeof AGENT_LANGUAGES[number];
+export interface AgentBehaviorSettings extends TuiAgentBehaviorSettings {
+    language: AgentLanguage;
+}
+export declare const AgentBehaviorSettingsSchema: z<AgentBehaviorSettings>;
+/** Stable model instruction for one accepted language setting. */
+export declare function agentLanguageFragment(language: AgentLanguage): string;
+/** Freeze live user settings at a turn boundary while keeping direct assemblies useful. */
+export declare class AgentBehaviorPrompt {
+    #private;
+    snapshot(agent: Agent, turn: number, language: AgentLanguage): void;
+    clear(agent: Agent): void;
+    fragment(context: AssembleContext, current: AgentLanguage): string;
+    variable(context: AssembleContext, current: AgentLanguage): string;
+}
+export declare function apply(ctx: Context): void;

package/lib/agent-behavior.js

@@ -0,0 +1,75 @@
+/**
+ * Product-owned Agent behavior settings projected into the Harness system prompt.
+ * @module @agi-fans/oh-my-dsh/agent-behavior
+ */
+import { settingsNamespace } from '@deepseek-ai/dsh-settings';
+import z from '@deepseek-ai/schemastery';
+export const name = 'omdsh-agent-behavior';
+export const inject = ['settings', 'systemPrompt'];
+export const AGENT_BEHAVIOR_SETTINGS_NAMESPACE = 'omdsh-agent';
+export const AGENT_BEHAVIOR_SECTION = 'omdsh:agent-behavior';
+export const AGENT_BEHAVIOR_ORDER = 30;
+export const AGENT_BEHAVIOR_VARIABLE = 'omdsh_agent_behavior';
+export const AGENT_LANGUAGES = ['auto', 'zh-CN', 'en'];
+export const AgentBehaviorSettingsSchema = z.object({
+    language: z.union([...AGENT_LANGUAGES]).default('auto'),
+});
+const LANGUAGE_FRAGMENTS = {
+    'zh-CN': '主要使用简体中文进行推理和面向用户的沟通，包括回复、提问、计划、待办文字和子 Agent 简报。代码、标识符、命令、Tool 参数、日志、引用、文件内容和惯用技术术语在准确性需要时保留原文或标准写法。项目指令中明确规定语言时，遵循项目指令；若用户明确要求当前任务使用其他语言，以该要求为准。',
+    en: 'Use English as the primary language for reasoning and user-facing communication, including replies, questions, plans, todo text, and subagent summaries. Preserve code, identifiers, commands, tool arguments, logs, quotations, file contents, and conventional technical terms in their original or standard form when accuracy requires. Follow explicit language requirements in project instructions; if the user explicitly requests another language for the current task, follow that request.',
+};
+/** Stable model instruction for one accepted language setting. */
+export function agentLanguageFragment(language) {
+    return language === 'auto' ? '' : LANGUAGE_FRAGMENTS[language];
+}
+/** Freeze live user settings at a turn boundary while keeping direct assemblies useful. */
+export class AgentBehaviorPrompt {
+    #snapshots = new WeakMap();
+    snapshot(agent, turn, language) {
+        const current = this.#snapshots.get(agent);
+        if (current?.turn === turn)
+            return;
+        this.#snapshots.set(agent, { turn, language });
+    }
+    clear(agent) {
+        this.#snapshots.delete(agent);
+    }
+    fragment(context, current) {
+        const language = context.agent === undefined
+            ? current
+            : this.#snapshots.get(context.agent)?.language ?? current;
+        return agentLanguageFragment(language);
+    }
+    variable(context, current) {
+        const fragment = this.fragment(context, current);
+        return fragment === '' ? '' : `\n\n${fragment}`;
+    }
+}
+export function apply(ctx) {
+    const scope = ctx.settings.register(settingsNamespace(AGENT_BEHAVIOR_SETTINGS_NAMESPACE), AgentBehaviorSettingsSchema, { applies: 'live' });
+    const prompt = new AgentBehaviorPrompt();
+    ctx.on('agent/pre-step', async (payload, next) => {
+        prompt.snapshot(payload.agent, payload.turn, scope.get().language);
+        return next();
+    });
+    ctx.on('agent/status', ({ agent, status }) => {
+        if (status === 'idle')
+            prompt.clear(agent);
+    });
+    ctx.on('agent/disposed', ({ agent }) => { prompt.clear(agent); });
+    ctx.effect(() => ctx.systemPrompt.section({
+        name: AGENT_BEHAVIOR_SECTION,
+        order: AGENT_BEHAVIOR_ORDER,
+        text: context => prompt.fragment(context, scope.get().language),
+    }), 'omdsh Agent behavior prompt section');
+    ctx.effect(() => ctx.systemPrompt.variable(AGENT_BEHAVIOR_VARIABLE, context => prompt.variable(context, scope.get().language)), 'omdsh Agent behavior prompt variable');
+    ctx.inject(['tui'], (tuiCtx) => {
+        const binding = {
+            get: () => scope.get(),
+            update: next => scope.update({ language: next.language }),
+            watch: listener => scope.watch(next => { listener(next); }),
+        };
+        tuiCtx.effect(() => tuiCtx.tui.bindAgentBehaviorSettings?.(binding) ?? (() => { }), 'bind Agent behavior settings to TUI');
+    });
+}
+//# sourceMappingURL=agent-behavior.js.map

package/package.json

@@ -1,8 +1,20 @@
 {
   "name": "@agi-fans/oh-my-dsh",
-  "description": "omdsh: TUI coding agent command over the DeepSeek Harness runtime",
-  "version": "0.11.0",
-  "homepage": "https://github.com/agi-fans/oh-my-dsh#readme",
+  "description": "omdsh: a keyboard-first DeepSeek TUI coding agent on the DeepSeek Harness runtime",
+  "version": "0.13.0",
+  "homepage": "https://omdsh.agi.fans/",
+  "keywords": [
+    "omdsh",
+    "oh-my-dsh",
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "plugin",
+    "dsh-plugin",
+    "tui",
+    "coding-agent",
+    "cli"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/agi-fans/oh-my-dsh.git",
@@ -15,6 +27,13 @@
   "bin": {
     "omdsh": "lib/bin.js"
   },
+  "exports": {
+    "./agent-behavior": {
+      "types": "./lib/agent-behavior.d.ts",
+      "default": "./lib/agent-behavior.js"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
     "lib/*.js",
     "lib/*.d.ts",
@@ -88,9 +107,12 @@
     "@deepseek-ai/dsh-user-questions": "0.1.1-rc.2",
     "@deepseek-ai/dsh-subprocess-local": "0.1.1-rc.2",
     "@deepseek-ai/dsh-settings-file": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.1-rc.2",
+    "@deepseek-ai/schemastery": "3.18.1",
     "@deepseek-ai/dsh-credentials-local": "0.1.1-rc.2",
     "@deepseek-ai/dsh-authorization": "0.1.1-rc.2",
-    "@agi-fans/dsh-tui": "^0.11.0"
+    "@agi-fans/dsh-tui": "^0.13.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1"