@aiwayds/dsh-tui-pi 0.1.1 → 0.4.0

package/lib/agent-manager.js

@@ -0,0 +1,298 @@
+/**
+ * Agent definitions as markdown files — the dsh terminal counterpart of the
+ * pi fun-agent / zcode "one file per agent" convention.
+ *
+ * An agent is a `<agents-dir>/<name>.md` file with a `---` frontmatter block
+ * and a markdown body that doubles as the agent's system prompt:
+ *
+ *   ---
+ *   name: oldfox
+ *   display_name: 老法师
+ *   description: "顾问角色：review、挑刺、保证健壮性。"
+ *   color: red
+ *   model: volc-ark-plan/glm-5.3
+ *   thinking: high
+ *   deep: 1
+ *   ---
+ *   You are 老法师 — 顾问…
+ *
+ * Frontmatter keys are parsed loosely (`key: value`, optional surrounding
+ * quotes); `name` is required, `description` feeds the picker subtitle,
+ * `model` is a dsh `provider/model` route (the picker rewrites it), and
+ * `deep` caps how many levels of subagents this agent may spawn (default 1,
+ * 0 = never, no unlimited — there is no spelling for unbounded depth).
+ * The body is kept verbatim.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, join } from 'node:path';
+/** The dsh agents directory (`~/.dsh/agents`, under the dsh home). */
+export function agentsDir() {
+    return join(homedir(), '.dsh', 'agents');
+}
+/**
+ * The legacy agents directory from the first shipped layout (`~/dsh/agents`,
+ * no dot). Kept only for one-time migration — see `migrateLegacyAgentsDir`.
+ */
+export function legacyAgentsDir() {
+    return join(homedir(), 'dsh', 'agents');
+}
+/**
+ * One-time migration from the legacy `~/dsh/agents` layout into
+ * `~/.dsh/agents`: when the target directory holds no agents but the legacy
+ * one does, every legacy file is copied over. Idempotent.
+ */
+export function migrateLegacyAgentsDir(targetDir = agentsDir(), legacyDir = legacyAgentsDir()) {
+    const { agents } = listAgentFiles(targetDir);
+    if (agents.length > 0)
+        return 0;
+    if (!existsSync(legacyDir))
+        return 0;
+    let migrated = 0;
+    for (const entry of readdirSync(legacyDir, { withFileTypes: true })) {
+        if (!entry.isFile() || !entry.name.endsWith('.md'))
+            continue;
+        mkdirSync(targetDir, { recursive: true });
+        writeFileSync(join(targetDir, entry.name), readFileSync(join(legacyDir, entry.name)));
+        migrated++;
+    }
+    return migrated;
+}
+/** zcode agent files are the one-time seeding source (model converted). */
+export function zcodeAgentsDir() {
+    return join(homedir(), '.zcode', 'agents');
+}
+const FRONTMATTER_FENCE = '---';
+/** Frontmatter key pattern (same loose shape fun-agent / zcode accept). */
+const KEY_LINE = /^([A-Za-z_][A-Za-z0-9_]*)\s*:\s*(.*)$/;
+/** Strip one pair of matching surrounding quotes, if present. */
+function stripQuotes(value) {
+    if (value.length >= 2) {
+        const first = value[0];
+        const last = value[value.length - 1];
+        if ((first === '"' && last === '"') || (first === "'" && last === "'"))
+            return value.slice(1, -1);
+    }
+    return value;
+}
+/** Find the closing fence line index of a frontmatter starting at line 0. */
+function frontmatterBounds(lines) {
+    if (lines[0]?.trim() !== FRONTMATTER_FENCE)
+        return undefined;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === FRONTMATTER_FENCE)
+            return { close: i };
+    }
+    return undefined;
+}
+/** Parse a loose `key: value` frontmatter block (lines 1..close-1). */
+function parseFrontmatterValues(lines, close) {
+    const values = {};
+    for (let i = 1; i < close; i++) {
+        const match = KEY_LINE.exec(lines[i]);
+        if (match === null)
+            continue;
+        values[match[1]] = stripQuotes(match[2].trim());
+    }
+    return values;
+}
+/**
+ * Parse one agent markdown file. Tolerates CRLF, quotes, and non-key lines
+ * inside the frontmatter; `name` is required, `deep` must be a non-negative
+ * integer when present (absent defaults to 1).
+ */
+export function parseAgentMarkdown(text, path) {
+    const lines = text.split(/\r?\n/);
+    const bounds = frontmatterBounds(lines);
+    if (bounds === undefined) {
+        return { ok: false, error: 'missing frontmatter (file must start with `---`)' };
+    }
+    const values = parseFrontmatterValues(lines, bounds.close);
+    const name = values['name']?.trim();
+    if (name === undefined || name === '')
+        return { ok: false, error: 'missing required frontmatter key `name`' };
+    let deep = 1;
+    if (values['deep'] !== undefined) {
+        const raw = values['deep'].trim();
+        if (!/^\d+$/.test(raw)) {
+            return { ok: false, error: `invalid \`deep\`: expected a non-negative integer, got "${raw}"` };
+        }
+        deep = Number(raw);
+    }
+    const body = lines.slice(bounds.close + 1).join('\n').replace(/^\n+/, '').trimEnd();
+    const meta = { name, deep };
+    const displayName = values['display_name']?.trim();
+    if (displayName !== undefined && displayName !== '')
+        meta.displayName = displayName;
+    const description = values['description']?.trim();
+    if (description !== undefined && description !== '')
+        meta.description = description;
+    const color = values['color']?.trim();
+    if (color !== undefined && color !== '')
+        meta.color = color;
+    const model = values['model']?.trim();
+    if (model !== undefined && model !== '')
+        meta.model = model;
+    const thinking = values['thinking']?.trim();
+    if (thinking !== undefined && thinking !== '')
+        meta.thinking = thinking;
+    return { ok: true, agent: { path, meta, body } };
+}
+/** Render an agent back to markdown (frontmatter + blank line + body). */
+export function renderAgentMarkdown(meta, body) {
+    const lines = ['---'];
+    lines.push(`name: ${meta.name}`);
+    if (meta.displayName !== undefined)
+        lines.push(`display_name: ${meta.displayName}`);
+    if (meta.description !== undefined)
+        lines.push(`description: ${JSON.stringify(meta.description)}`);
+    if (meta.color !== undefined)
+        lines.push(`color: ${meta.color}`);
+    if (meta.model !== undefined)
+        lines.push(`model: ${meta.model}`);
+    if (meta.thinking !== undefined)
+        lines.push(`thinking: ${meta.thinking}`);
+    lines.push(`deep: ${meta.deep}`);
+    lines.push('---');
+    if (body !== '')
+        lines.push('', body);
+    return lines.join('\n') + '\n';
+}
+/** List agents under `dir` (top level only), broken files reported aside. */
+export function listAgentFiles(dir) {
+    const agents = [];
+    const broken = [];
+    if (!existsSync(dir))
+        return { agents, broken };
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (!entry.isFile() || !entry.name.endsWith('.md'))
+            continue;
+        const path = join(dir, entry.name);
+        const result = parseAgentMarkdown(readFileSync(path, 'utf8'), path);
+        if (result.ok)
+            agents.push(result.agent);
+        else
+            broken.push({ path, error: result.error });
+    }
+    agents.sort((a, b) => a.meta.name.localeCompare(b.meta.name));
+    return { agents, broken };
+}
+/**
+ * Apply frontmatter updates in place: existing lines are rewritten in place,
+ * missing keys are inserted before the closing fence, `null` removes the
+ * line. CRLF is preserved; a no-op returns without touching the file.
+ * Resolves with an error message, or `undefined` on success.
+ */
+export function updateAgentFrontmatter(path, updates) {
+    const text = readFileSync(path, 'utf8');
+    const eol = text.includes('\r\n') ? '\r\n' : '\n';
+    const lines = text.split(/\r?\n/);
+    const bounds = frontmatterBounds(lines);
+    if (bounds === undefined)
+        return 'missing frontmatter (file must start with `---`)';
+    const pending = [];
+    if (updates.model !== undefined)
+        pending.push(['model', updates.model]);
+    if (updates.thinking !== undefined)
+        pending.push(['thinking', updates.thinking]);
+    if (updates.deep !== undefined)
+        pending.push(['deep', updates.deep === null ? null : String(updates.deep)]);
+    let changed = false;
+    let close = bounds.close;
+    for (const [key, value] of pending) {
+        let found = -1;
+        for (let i = 1; i < close; i++) {
+            if (KEY_LINE.test(lines[i]) && lines[i].trimStart().startsWith(`${key}:`)) {
+                found = i;
+                break;
+            }
+        }
+        const rendered = value === null ? null : `${key}: ${value}`;
+        if (found >= 0) {
+            if (rendered === null) {
+                lines.splice(found, 1);
+                close--;
+                changed = true;
+            }
+            else if (lines[found] !== rendered) {
+                lines[found] = rendered;
+                changed = true;
+            }
+        }
+        else if (rendered !== null) {
+            lines.splice(close, 0, rendered);
+            close++;
+            changed = true;
+        }
+    }
+    if (!changed)
+        return undefined;
+    writeFileSync(path, lines.join(eol));
+    return undefined;
+}
+/**
+ * Convert a zcode `custom:<uri-encoded providerId>:<modelName>` model value
+ * to a dsh `provider/model` route for providers we know. Unknown providers
+ * return `undefined` (caller keeps the original line); a value without the
+ * `custom:` prefix is assumed to be dsh format already.
+ */
+export function convertZcodeModel(model) {
+    if (!model.startsWith('custom:'))
+        return model;
+    const rest = model.slice('custom:'.length);
+    const colon = rest.indexOf(':');
+    if (colon < 0)
+        return undefined;
+    const providerId = decodeURIComponent(rest.slice(0, colon));
+    const modelName = decodeURIComponent(rest.slice(colon + 1));
+    switch (providerId) {
+        case 'builtin:bigmodel':
+            // bigmodel's GLM family maps onto the volc-ark-plan route's glm-5.3.
+            return modelName === 'GLM-5.3' ? 'volc-ark-plan/glm-5.3' : undefined;
+        case '9524bbc9-01a6-4e24-9ea2-a0a076ef518b': // zcode provider "Opencode-Go"
+            return `opencode-go/${modelName}`;
+        case 'd7ef608b-857f-4960-9a4f-380e851fdedb': // zcode provider "minimax"
+            return `minimax-cn/${modelName}`;
+        default:
+            return undefined;
+    }
+}
+/**
+ * One-time seeding: when `targetDir` holds no agents yet, copy every
+ * parseable zcode agent into it with the model converted to a dsh route.
+ * Idempotent — once any agent exists, nothing is written.
+ */
+export function seedFromZcode(targetDir, sourceDir = zcodeAgentsDir()) {
+    mkdirSync(targetDir, { recursive: true });
+    const { agents } = listAgentFiles(targetDir);
+    if (agents.length > 0)
+        return { seeded: 0, errors: [] };
+    if (!existsSync(sourceDir))
+        return { seeded: 0, errors: [] };
+    let seeded = 0;
+    const errors = [];
+    for (const entry of readdirSync(sourceDir, { withFileTypes: true })) {
+        if (!entry.isFile() || !entry.name.endsWith('.md'))
+            continue;
+        const sourcePath = join(sourceDir, entry.name);
+        const result = parseAgentMarkdown(readFileSync(sourcePath, 'utf8'), sourcePath);
+        if (!result.ok) {
+            errors.push({ file: entry.name, error: result.error });
+            continue;
+        }
+        const agent = result.agent;
+        if (agent.meta.model !== undefined) {
+            const converted = convertZcodeModel(agent.meta.model);
+            if (converted !== undefined)
+                agent.meta.model = converted;
+        }
+        writeFileSync(join(targetDir, `${agent.meta.name}.md`), renderAgentMarkdown(agent.meta, agent.body));
+        seeded++;
+    }
+    return { seeded, errors };
+}
+/** Short file label for diagnostics (kept importable for callers). */
+export function agentFileLabel(path) {
+    return basename(path);
+}
+//# sourceMappingURL=agent-manager.js.map

package/lib/agent-manager.js.map

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

package/lib/agents.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `/agents` — manage agent definition markdown files (the dsh terminal
+ * counterpart of pi's fun-agent `/fun-agent-cfg` and zcode's subagents page).
+ *
+ * Two layers, both built on the select-panel framework (src/panels.ts):
+ *
+ *   1. agent table (TablePanel) — one row per agent, four columns
+ *      (name | model | deep | description), ↑↓/PgUp/PgDn navigate, Enter
+ *      opens the agent.
+ *   2. agent fields window (FieldPanel) — title (display name + id), the
+ *      full description, and the editable field rows model / thinking /
+ *      deep. Enter edits the selected row (or m/t/d shortcuts), v opens the
+ *      full system-prompt body (ViewerPanel), Esc returns to the table.
+ *   3. subagent-limits panel (FieldPanel, `l` from the table) — the live
+ *      `maxAgents` / `maxRounds` caps, editable and written straight to the
+ *      `dsh-tui` settings namespace. Also the initial view when no agent
+ *      files exist yet, so the caps stay configurable before any agent.
+ *
+ * Edits go straight to the frontmatter of the agent's markdown file and
+ * take effect the next time the agent is spawned.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type TUI } from '@earendil-works/pi-tui';
+import { type TuiTheme } from './theme/index.ts';
+/**
+ * Open the `/agents` manager. Resolves with a summary text when the user
+ * made changes (or seeded agents) and exits, or `undefined` when nothing
+ * changed. `preselect` jumps straight into one agent's fields window.
+ */
+export declare function openAgentManager(ctx: Context, tui: TUI, theme: TuiTheme, restoreFocus: () => void, preselect?: string): Promise<string | undefined>;