@nexus-aethra/dshell-commands 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nexus Aethra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/host-locales.js

@@ -0,0 +1,28 @@
+/**
+ * `dshell-commands`'s HOST dictionaries — the copy this package's `/new`
+ * command composes that a reader sees.
+ *
+ * A command result renders in dsh's command-result surface, so its language has
+ * to match the screen even though the host writes it. `ctx.dshellHostCopy`
+ * answers which language that is (see the std contract); these dictionaries are
+ * what it binds. The model-facing half of this package — every tool
+ * description, parameter description and `execute` return line — is deliberately
+ * absent: the model reads those, not the user, and they stay in their source
+ * language.
+ *
+ * The browser face keeps its own dictionaries elsewhere: the two sets are
+ * disjoint by construction, and only this file is reachable from the host half.
+ */
+/** Simplified Chinese dictionary and key-set source of truth. */
+export const zh = {
+    'command.new.created': '新会话已创建:{id}',
+    'command.new.failed': '创建会话失败:{message}',
+};
+/** English dictionary, checked complete against the Chinese key set. */
+export const en = {
+    'command.new.created': 'New session created: {id}',
+    'command.new.failed': 'Failed to create a session: {message}',
+};
+/** The pair `ctx.dshellHostCopy.bind()` takes. */
+export const hostCopy = { zh, en };
+//# sourceMappingURL=host-locales.js.map

package/lib/host-locales.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-locales.js","sourceRoot":"","sources":["../src/host-locales.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,iEAAiE;AACjE,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB,qBAAqB,EAAE,aAAa;IACpC,oBAAoB,EAAE,kBAAkB;CACR,CAAA;AAKlC,wEAAwE;AACxE,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB,qBAAqB,EAAE,2BAA2B;IAClD,oBAAoB,EAAE,uCAAuC;CACd,CAAA;AAEjD,kDAAkD;AAClD,MAAM,CAAC,MAAM,QAAQ,GAAgD,EAAE,EAAE,EAAE,EAAE,EAAE,CAAA"}

package/lib/index.js

@@ -0,0 +1,281 @@
+/**
+ * dshell-commands host face — Phases 6/8.
+ *
+ * `/new` creates a fresh session with the invoking session's cwd (the dock
+ * additionally intercepts `/new` client-side, because the "current session"
+ * selection is client-only state no host command can switch). `/compact` is
+ * dsh's own `command-compact` — dshell must not re-register it; the dock
+ * routes it to the stock executor.
+ * `dshell_get_agent_terminal` hands the agent the addressable
+ * `TerminalSessionId` of its OWN shell — the PTY the bridge spawns for it,
+ * separate from the one the user types into.
+ * `dshell_terminal_read` reads the USER's shell (read-only) at command
+ * granularity — incremental since an opaque cursor, or the latest commands.
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { hostCopy } from './host-locales.js';
+export const name = '@nexus-aethra/dshell-commands';
+// `dshellHostCopy` is what the `/new` command's result lines are localized
+// through, and `sessionController` is what creates the session the command
+// reports on — both are accessors this module reads, so both have to be
+// declared here or the handler throws "cannot get property … without inject".
+export const inject = [
+    'commands', 'tools', 'dshellTerminalBridge', 'dshellHostCopy', 'sessionController',
+];
+/** Bytes one `dshell_terminal_output` call returns by default. */
+const DEFAULT_OUTPUT_SLICE_BYTES = 2 * 1024;
+/**
+ * Ceiling on one slice.
+ *
+ * The point of the tool is that reading is bounded: a caller must not be able to
+ * pull a command's output in one gulp and blow up the context the tool exists to
+ * protect.
+ */
+const MAX_OUTPUT_SLICE_BYTES = 8 * 1024;
+/**
+ * UTF-8 byte length of a string.
+ *
+ * The offsets this tool speaks are bytes, while `String.length` counts UTF-16
+ * units. Counted here rather than with `Buffer` so this host-only package stays
+ * free of Node types for one arithmetic call.
+ */
+function utf8Bytes(text) {
+    let bytes = 0;
+    for (const character of text) {
+        const code = character.codePointAt(0) ?? 0;
+        bytes += code < 0x80 ? 1 : code < 0x800 ? 2 : code < 0x1_0000 ? 3 : 4;
+    }
+    return bytes;
+}
+/** Render one command record for the model. */
+function formatCommand(record, includeOutput) {
+    const name = record.command.length > 0 ? record.command : '(未跟踪的命令)';
+    const exit = record.exitCode === null ? '' : `  exit ${String(record.exitCode)}`;
+    // The seq travels with the line: it is the key dshell_terminal_output takes to
+    // read more of this command's output.
+    const head = `$ ${name}${exit}  · seq=${String(record.seq)}`;
+    const output = record.output.trim();
+    if (!includeOutput || output.length === 0)
+        return head;
+    return `${head}\n${output}`;
+}
+export function apply(ctx) {
+    const bridge = ctx.dshellTerminalBridge;
+    // Structural read, as this repo reads dshell services whose accessor
+    // declaration lives with the PROVIDER (dshell-terminal-bridge): a consumer's tsc program
+    // does not include that package's source, and the `inject` list above is what
+    // guarantees the service is there. Bound once, read at call time, so a
+    // language switch reaches the next `/new` result without re-binding.
+    const copy = ctx.get('dshellHostCopy');
+    const t = copy.bind(hostCopy);
+    ctx.commands.register({
+        name: 'new',
+        description: 'Create a new dshell session inheriting the current working directory.',
+        handler: async (invocation) => {
+            try {
+                const cwd = invocation.agent.session?.header?.cwd;
+                const created = await ctx.sessionController.create(cwd === undefined ? {} : { cwd });
+                return { kind: 'success', text: t('command.new.created', { id: String(created.sessionId) }) };
+            }
+            catch (error) {
+                return {
+                    kind: 'error',
+                    text: t('command.new.failed', {
+                        message: error instanceof Error ? error.message : String(error),
+                    }),
+                };
+            }
+        },
+    });
+    ctx.tools.register(defineTool({
+        name: 'dshell_get_agent_terminal',
+        description: 'Return the terminal session id of YOUR OWN shell — a PTY spawned for you, '
+            + 'starting in the directory the user\'s shell is in. Pass it to terminal_send / '
+            + 'terminal_read / terminal_signal to run commands. It is a separate shell from the one '
+            + 'the user types into, so your commands and theirs never block each other, and the user '
+            + 'can watch yours live in the task card. The user\'s own shell is only readable, via '
+            + 'dshell_terminal_read.',
+        parameters: {},
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: { sessionId: { type: 'string', required: true } },
+            },
+            render: (_args, value) => [{ type: 'text', text: value.sessionId }],
+        },
+        async execute(_args, exec) {
+            const agent = exec.agent;
+            if (agent === undefined)
+                throw new Error('dshell_get_agent_terminal requires an agent context');
+            return { sessionId: String(await bridge.agentTerminalId(String(agent.id))) };
+        },
+        presentCall: () => ({ card: 'generic', title: '获取 AI 终端', kind: 'read' }),
+    }));
+    ctx.tools.register(defineTool({
+        name: 'dshell_terminal_read',
+        description: 'Read the USER\'s terminal — the shell they are typing into — at command '
+            + 'granularity, read-only. Without a cursor it lists the most recent commands; with the '
+            + 'cursor a previous call returned, it reports only what happened since — the way to catch '
+            + 'up on what the user has been doing without asking them. Output is stripped of terminal '
+            + 'control codes. Run your own commands in the shell from '
+            + 'dshell_get_agent_terminal instead: typing into the user\'s terminal takes the foreground '
+            + 'away from them.',
+        parameters: {
+            cursor: {
+                type: 'string',
+                description: 'Opaque cursor from a previous call. Omit to list the most recent commands.',
+            },
+            limit: {
+                type: 'integer',
+                description: 'Without a cursor: how many recent commands to list (default 20).',
+            },
+            includeOutput: {
+                type: 'boolean',
+                description: 'Without a cursor: include each command\'s output (default true).',
+            },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    text: { type: 'string', required: true },
+                    cursor: { type: 'string', required: true },
+                },
+            },
+            render: (_args, value) => [{
+                    type: 'text',
+                    text: value.cursor.length > 0 ? `${value.text}\n\ncursor: ${value.cursor}` : value.text,
+                }],
+        },
+        async execute(args, exec) {
+            const agent = exec.agent;
+            if (agent === undefined)
+                throw new Error('dshell_terminal_read requires an agent context');
+            const sessionId = String(agent.id);
+            const NO_SHELL = '主终端尚未打开：用户还没有打开这个会话的终端。';
+            if (args.cursor !== undefined && args.cursor.length > 0) {
+                const delta = bridge.since(sessionId, args.cursor);
+                if (delta === undefined)
+                    return { text: NO_SHELL, cursor: '' };
+                const lines = [];
+                if (delta.cleared) {
+                    lines.push('终端已重启，游标已失效；下面是新终端的状态。');
+                }
+                if (delta.newCommandCount > 0) {
+                    lines.push(`完成 ${String(delta.newCommandCount)} 条命令：`);
+                    for (const command of delta.commands)
+                        lines.push(formatCommand(command, true));
+                }
+                const text = delta.text.trim();
+                if (text.length > 0)
+                    lines.push('输出：', text);
+                if (delta.dropped)
+                    lines.push('…(更早的输出已滚出终端缓冲区)');
+                if (lines.length === 0)
+                    lines.push('自游标以来没有新的终端活动。');
+                return { text: lines.join('\n'), cursor: delta.cursor };
+            }
+            const history = bridge.history(sessionId, args.limit ?? 20);
+            if (history === undefined)
+                return { text: NO_SHELL, cursor: '' };
+            const lines = history.commands.length === 0
+                ? ['主终端还没有执行过可识别的命令。']
+                : history.commands.map(command => formatCommand(command, args.includeOutput !== false));
+            return { text: lines.join('\n'), cursor: history.cursor };
+        },
+        presentCall: args => ({
+            card: 'generic',
+            title: args.cursor === undefined ? '读取主终端历史' : '读取主终端增量',
+            kind: 'read',
+        }),
+    }));
+    ctx.tools.register(defineTool({
+        name: 'dshell_terminal_output',
+        description: 'Read one command\'s output from the USER\'s terminal in slices — the way to look '
+            + 'at a command whose output was too long to be injected whole. Pass the `cursor` from the '
+            + 'terminal block that was injected into your context (or from a previous call) and the '
+            + 'command\'s `seq`; `offset` and `limit` are bytes into the retained output. Output is kept '
+            + 'for the newest commands of the session, at most 64 KiB each, and the *tail* is what '
+            + 'survives: when `dropped` is larger than zero that many bytes are missing from the front, so '
+            + 'offset 0 is not the beginning of the output. List commands with dshell_terminal_read, then '
+            + 'come here for the parts you actually need.',
+        parameters: {
+            cursor: {
+                type: 'string',
+                description: 'Session cursor from the injected terminal block or a previous call. Required: '
+                    + 'it pins the shell generation, so a respawned shell is reported as stale rather than '
+                    + 'read at the wrong seq.',
+                required: true,
+            },
+            seq: {
+                type: 'integer',
+                description: 'The command whose output to read, as listed by dshell_terminal_read.',
+                required: true,
+            },
+            offset: {
+                type: 'integer',
+                description: `Byte offset into the retained output (default 0).`,
+            },
+            limit: {
+                type: 'integer',
+                description: `Bytes to return (default ${String(DEFAULT_OUTPUT_SLICE_BYTES)}, at most ${String(MAX_OUTPUT_SLICE_BYTES)}).`,
+            },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    text: { type: 'string', required: true },
+                    cursor: { type: 'string', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: value.text }],
+        },
+        async execute(args, exec) {
+            const agent = exec.agent;
+            if (agent === undefined)
+                throw new Error('dshell_terminal_output requires an agent context');
+            const offset = Math.max(0, Math.trunc(args.offset ?? 0));
+            const limit = Math.max(1, Math.min(Math.trunc(args.limit ?? DEFAULT_OUTPUT_SLICE_BYTES), MAX_OUTPUT_SLICE_BYTES));
+            const answer = bridge.commandOutput(String(agent.id), args.cursor, Math.trunc(args.seq), offset, limit);
+            if (answer === undefined) {
+                return { text: '主终端尚未打开：用户还没有打开这个会话的终端。', cursor: '' };
+            }
+            if (answer.stale) {
+                return {
+                    text: `游标来自已被替换的 shell，seq ${String(args.seq)} 可能指向别的命令。`
+                        + '请重新读取终端历史（dshell_terminal_read），用新的游标和 seq 再试。',
+                    cursor: answer.cursor,
+                };
+            }
+            if (!answer.retained || answer.output === null) {
+                return {
+                    text: `seq ${String(args.seq)} 的输出未保留（已被保留期裁掉，或写入早于输出持久化）。`,
+                    cursor: answer.cursor,
+                };
+            }
+            const slice = answer.output;
+            const sliceBytes = utf8Bytes(slice.text);
+            const head = `$ ${answer.command ?? '(未跟踪的命令)'}`
+                + (answer.exitCode === null ? '' : `  exit ${String(answer.exitCode)}`);
+            const meta = `[保留 ${String(slice.total)} 字节, 原输出 ${String(slice.bytes)} 字节`
+                + (slice.dropped > 0 ? `, 前 ${String(slice.dropped)} 字节已丢弃` : '')
+                + `; 本次 offset ${String(slice.offset)}`
+                + (slice.truncated ? ` -> ${String(slice.offset + sliceBytes)}` : ' -> 末尾')
+                + ']';
+            const next = slice.truncated
+                ? `\n\n(next offset: ${String(slice.offset + sliceBytes)})`
+                : '';
+            return {
+                text: `${head}\n${meta}\n${slice.text}${next}\n\ncursor: ${answer.cursor}`,
+                cursor: answer.cursor,
+            };
+        },
+        presentCall: () => ({ card: 'generic', title: '读取命令输出', kind: 'read' }),
+    }));
+}
+export default { name, inject, apply };
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/types/host-locales.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `dshell-commands`'s HOST dictionaries — the copy this package's `/new`
+ * command composes that a reader sees.
+ *
+ * A command result renders in dsh's command-result surface, so its language has
+ * to match the screen even though the host writes it. `ctx.dshellHostCopy`
+ * answers which language that is (see the std contract); these dictionaries are
+ * what it binds. The model-facing half of this package — every tool
+ * description, parameter description and `execute` return line — is deliberately
+ * absent: the model reads those, not the user, and they stay in their source
+ * language.
+ *
+ * The browser face keeps its own dictionaries elsewhere: the two sets are
+ * disjoint by construction, and only this file is reachable from the host half.
+ */
+import type { HostCopyDictionaries } from '@nexus-aethra/dshell-std';
+/** Simplified Chinese dictionary and key-set source of truth. */
+export declare const zh: {
+    'command.new.created': string;
+    'command.new.failed': string;
+};
+/** Host dictionary key union. */
+export type DshellCommandsHostKey = keyof typeof zh;
+/** English dictionary, checked complete against the Chinese key set. */
+export declare const en: {
+    'command.new.created': string;
+    'command.new.failed': string;
+};
+/** The pair `ctx.dshellHostCopy.bind()` takes. */
+export declare const hostCopy: HostCopyDictionaries<DshellCommandsHostKey>;
+//# sourceMappingURL=host-locales.d.ts.map

package/lib/types/host-locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-locales.d.ts","sourceRoot":"","sources":["../../src/host-locales.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAEpE,iEAAiE;AACjE,eAAO,MAAM,EAAE;;;CAGmB,CAAA;AAElC,iCAAiC;AACjC,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,EAAE,CAAA;AAEnD,wEAAwE;AACxE,eAAO,MAAM,EAAE;;;CAGkC,CAAA;AAEjD,kDAAkD;AAClD,eAAO,MAAM,QAAQ,EAAE,oBAAoB,CAAC,qBAAqB,CAAc,CAAA"}

package/lib/types/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * dshell-commands host face — Phases 6/8.
+ *
+ * `/new` creates a fresh session with the invoking session's cwd (the dock
+ * additionally intercepts `/new` client-side, because the "current session"
+ * selection is client-only state no host command can switch). `/compact` is
+ * dsh's own `command-compact` — dshell must not re-register it; the dock
+ * routes it to the stock executor.
+ * `dshell_get_agent_terminal` hands the agent the addressable
+ * `TerminalSessionId` of its OWN shell — the PTY the bridge spawns for it,
+ * separate from the one the user types into.
+ * `dshell_terminal_read` reads the USER's shell (read-only) at command
+ * granularity — incremental since an opaque cursor, or the latest commands.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "@nexus-aethra/dshell-commands";
+export declare const inject: readonly ["commands", "tools", "dshellTerminalBridge", "dshellHostCopy", "sessionController"];
+export declare function apply(ctx: Context): void;
+declare const _default: {
+    name: string;
+    inject: readonly ["commands", "tools", "dshellTerminalBridge", "dshellHostCopy", "sessionController"];
+    apply: typeof apply;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAYlD,eAAO,MAAM,IAAI,kCAAkC,CAAA;AAMnD,eAAO,MAAM,MAAM,+FAET,CAAA;AA0CV,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAsNxC;;;;;;AAED,wBAAsC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@nexus-aethra/dshell-commands",
+  "version": "0.1.0",
+  "description": "dshell commands and tools: /new on ctx.commands, plus the model-facing dshell_get_agent_terminal tool that hands the agent its own shell, and dshell_terminal_read / dshell_terminal_output for reading the user's shell (read-only).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nexus-Aethra/Nexus-Terminal.git",
+    "directory": "packages/dshell/commands"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@nexus-aethra/dshell-std": "^0.1.0",
+    "@nexus-aethra/dshell-terminal-bridge": "^0.1.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-commands": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.5-rc.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-commands": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.5-rc.2",
+    "tsdown": "^0.22.14",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json --emitDeclarationOnly false",
+    "build:host": "tsc -p tsconfig.json --emitDeclarationOnly false"
+  }
+}