@lemoncat7/dsh-ssh 0.1.0-alpha.15

package/lib/terminal.js

@@ -0,0 +1,384 @@
+import { randomUUID } from 'node:crypto';
+import { directoryPrelude } from './exec.js';
+const MAX_SCROLLBACK_CHARS = 256_000;
+export class SshTerminalBackend {
+    connector;
+    store;
+    type = 'ssh';
+    constructor(connector, store) {
+        this.connector = connector;
+        this.store = store;
+    }
+    async spawn(spec) {
+        const profileId = spec.cwd?.trim();
+        if (!profileId)
+            throw new Error('SSH terminal backend requires the injected profile id as cwd');
+        const injection = this.store.injection(spec.owner.session.id);
+        if (injection === undefined || !injection.profileIds.includes(profileId))
+            throw new Error('This SSH profile is not injected into the current DSH session');
+        if (injection.permission !== 'terminal')
+            throw new Error('This SSH injection allows one-shot commands only');
+        const connection = await this.connector.connect(profileId, spec.signal);
+        try {
+            const channel = await openShell(connection, 120, 32);
+            return new SshTerminalSession(connection, channel, `Connected to ${connection.profile.name} (${connection.profile.username}@${connection.profile.host})`);
+        }
+        catch (error) {
+            connection.close();
+            throw error;
+        }
+    }
+}
+export class SshTerminalSession {
+    connection;
+    channel;
+    motd;
+    scrollback = '';
+    terminalStatus = { kind: 'running' };
+    active;
+    closing;
+    constructor(connection, channel, motd) {
+        this.connection = connection;
+        this.channel = channel;
+        this.motd = motd;
+        channel.setEncoding('utf8');
+        channel.on('data', (chunk) => this.receive(String(chunk)));
+        channel.stderr?.setEncoding('utf8');
+        channel.stderr?.on('data', (chunk) => this.receive(String(chunk)));
+        channel.on('exit', (code, signal) => {
+            this.terminalStatus = { kind: 'exited', exitCode: code ?? null, signal: normalizeSignal(signal) };
+            this.active?.settle('session_exit');
+        });
+        channel.on('close', () => {
+            if (this.terminalStatus.kind === 'running')
+                this.terminalStatus = { kind: 'exited', exitCode: null, signal: null };
+            this.active?.settle('session_exit');
+            connection.close();
+        });
+    }
+    startSend(request) {
+        if (this.terminalStatus.kind === 'exited')
+            throw new Error('SSH terminal has exited');
+        if (this.active !== undefined)
+            throw new Error('SSH terminal already has an active send');
+        const operation = new SendOperation(this, request);
+        this.active = operation;
+        operation.done.finally(() => { if (this.active === operation)
+            this.active = undefined; }).catch(() => { });
+        this.channel.write(request.submit ? `${request.text}\n` : request.text);
+        return operation;
+    }
+    read(request) {
+        const lines = this.scrollback.split(/\r?\n/);
+        const totalLines = lines.length;
+        const offset = clamp(request.offset ?? 0, 0, totalLines);
+        const count = clamp(request.count ?? 200, 1, 2000);
+        const lineEnd = totalLines - offset;
+        const lineBegin = Math.max(0, lineEnd - count);
+        return {
+            text: lines.slice(lineBegin, lineEnd).join('\n'),
+            totalLines,
+            lineBegin,
+            lineEnd,
+            truncated: this.scrollback.length >= MAX_SCROLLBACK_CHARS || lineBegin > 0,
+        };
+    }
+    write(text) {
+        if (this.terminalStatus.kind === 'exited')
+            throw new Error('SSH terminal has exited');
+        this.channel.write(text);
+    }
+    resize(cols, rows) {
+        if (this.terminalStatus.kind === 'exited')
+            return;
+        this.channel.setWindow(rows, cols, 0, 0);
+    }
+    async signal(signal) {
+        this.channel.signal(signal.replace(/^SIG/, ''));
+        return { delivered: true, targetPgid: 0 };
+    }
+    status() { return this.terminalStatus; }
+    close(_reason) {
+        if (this.closing !== undefined)
+            return this.closing;
+        this.closing = new Promise(resolve => {
+            if (this.terminalStatus.kind === 'exited') {
+                this.connection.close();
+                return resolve();
+            }
+            const timer = setTimeout(() => { this.channel.destroy(); this.connection.close(); resolve(); }, 1500);
+            this.channel.once('close', () => { clearTimeout(timer); this.connection.close(); resolve(); });
+            this.channel.end();
+        });
+        return this.closing;
+    }
+    receive(text) {
+        this.scrollback = `${this.scrollback}${text}`.slice(-MAX_SCROLLBACK_CHARS);
+        this.active?.push(text);
+    }
+    snapshotStatus() { return this.terminalStatus; }
+}
+class SendOperation {
+    session;
+    done;
+    resolveDone;
+    buffer = '';
+    unread = '';
+    truncated = false;
+    settled = false;
+    idleTimer;
+    timeoutTimer;
+    constructor(session, request) {
+        this.session = session;
+        this.done = new Promise(resolve => { this.resolveDone = resolve; });
+        this.timeoutTimer = setTimeout(() => this.settle('timeout'), 30_000);
+        request.signal?.addEventListener('abort', () => { void session.signal('SIGINT').catch(() => { }); this.settle('timeout'); }, { once: true });
+        this.armIdle();
+    }
+    readOutput() {
+        const delta = this.unread;
+        this.unread = '';
+        return { delta, truncated: this.truncated };
+    }
+    cancel() {
+        if (this.settled)
+            return false;
+        void this.session.signal('SIGINT').catch(() => { });
+        this.settle('inferred_idle');
+        return true;
+    }
+    push(text) {
+        if (this.settled)
+            return;
+        this.buffer += text;
+        this.unread += text;
+        if (this.buffer.length > 64_000) {
+            this.buffer = this.buffer.slice(-64_000);
+            this.truncated = true;
+        }
+        if (this.unread.length > 64_000) {
+            this.unread = this.unread.slice(-64_000);
+            this.truncated = true;
+        }
+        this.armIdle();
+    }
+    settle(reason) {
+        if (this.settled)
+            return;
+        this.settled = true;
+        if (this.idleTimer !== undefined)
+            clearTimeout(this.idleTimer);
+        if (this.timeoutTimer !== undefined)
+            clearTimeout(this.timeoutTimer);
+        this.resolveDone({
+            viewport: this.buffer,
+            waitReason: reason,
+            sessionStatus: this.session.snapshotStatus(),
+            truncated: this.truncated,
+        });
+    }
+    armIdle() {
+        if (this.idleTimer !== undefined)
+            clearTimeout(this.idleTimer);
+        this.idleTimer = setTimeout(() => this.settle('inferred_idle'), 700);
+    }
+}
+export class BrowserTerminalManager {
+    connector;
+    sessions = new Map();
+    constructor(connector) {
+        this.connector = connector;
+    }
+    async create(profileId, cols, rows, signal) {
+        const connection = await this.connector.connect(profileId, signal);
+        try {
+            const channel = await openShell(connection, clamp(cols, 20, 400), clamp(rows, 5, 200));
+            const terminal = new BrowserTerminal(randomUUID(), profileId, connection, channel, () => this.sessions.delete(terminal.id));
+            this.sessions.set(terminal.id, terminal);
+            return { id: terminal.id, profileId };
+        }
+        catch (error) {
+            connection.close();
+            throw error;
+        }
+    }
+    get(id) {
+        const terminal = this.sessions.get(id);
+        if (terminal === undefined)
+            throw Object.assign(new Error('browser terminal was not found'), { status: 404 });
+        return terminal;
+    }
+    async closeAll() {
+        await Promise.all([...this.sessions.values()].map(terminal => terminal.close()));
+        this.sessions.clear();
+    }
+}
+/** Owner-scoped AI terminals for Web profiles, whose official Terminal service lives inside each Agent preset realm. */
+export class AiTerminalManager {
+    connector;
+    sessions = new Map();
+    constructor(connector) {
+        this.connector = connector;
+    }
+    async create(ownerId, profileId, cwd, name, signal) {
+        const connection = await this.connector.connect(profileId, signal);
+        try {
+            const channel = await openShell(connection, 120, 32);
+            const terminalId = randomUUID();
+            const session = new SshTerminalSession(connection, channel, `Connected to ${connection.profile.name} (${connection.profile.username}@${connection.profile.host})`);
+            const record = {
+                terminalId,
+                profileId,
+                name: name?.trim() || connection.profile.name,
+                cwd,
+                createdAt: Date.now(),
+                session,
+                commands: [],
+            };
+            const owned = this.sessions.get(ownerId) ?? new Map();
+            owned.set(terminalId, record);
+            this.sessions.set(ownerId, owned);
+            channel.write(`${directoryPrelude(cwd)}\n`);
+            return { terminalId, profileId, cwd, motd: session.motd };
+        }
+        catch (error) {
+            connection.close();
+            throw error;
+        }
+    }
+    get(ownerId, terminalId) {
+        const record = this.sessions.get(ownerId)?.get(terminalId);
+        if (record === undefined)
+            throw new Error('SSH terminal was not found in the current DSH session');
+        return record.session;
+    }
+    list(ownerId) {
+        return [...(this.sessions.get(ownerId) ?? new Map()).values()].map(record => ({ terminalId: record.terminalId, status: record.session.status() }));
+    }
+    async send(ownerId, terminalId, request) {
+        const record = this.sessions.get(ownerId)?.get(terminalId);
+        if (record === undefined)
+            throw new Error('SSH terminal was not found in the current DSH session');
+        const startedAt = Date.now();
+        const result = await record.session.startSend(request).done;
+        record.commands.push({
+            id: randomUUID(),
+            command: request.text,
+            submitted: request.submit !== false,
+            startedAt,
+            completedAt: Date.now(),
+            output: result.viewport.slice(-64_000),
+            waitReason: result.waitReason,
+            truncated: result.truncated || result.viewport.length > 64_000,
+        });
+        if (record.commands.length > 80)
+            record.commands.splice(0, record.commands.length - 80);
+        return result;
+    }
+    write(ownerId, terminalId, text) {
+        this.get(ownerId, terminalId).write(text);
+    }
+    resize(ownerId, terminalId, cols, rows) {
+        this.get(ownerId, terminalId).resize(cols, rows);
+    }
+    activity(ownerId) {
+        return [...(this.sessions.get(ownerId) ?? new Map()).values()].map(record => {
+            const scrollback = record.session.read({ count: 500 }).text;
+            return {
+                terminalId: record.terminalId,
+                profileId: record.profileId,
+                name: record.name,
+                cwd: record.cwd,
+                createdAt: record.createdAt,
+                status: record.session.status(),
+                scrollback: scrollback.slice(-96_000),
+                commands: structuredClone(record.commands),
+            };
+        });
+    }
+    async close(ownerId, terminalId) {
+        const owned = this.sessions.get(ownerId);
+        const record = owned?.get(terminalId);
+        if (record === undefined)
+            return false;
+        owned.delete(terminalId);
+        if (owned.size === 0)
+            this.sessions.delete(ownerId);
+        await record.session.close('closed by owner');
+        return true;
+    }
+    async closeAll() {
+        const sessions = [...this.sessions.values()].flatMap(owned => [...owned.values()].map(record => record.session));
+        this.sessions.clear();
+        await Promise.all(sessions.map(session => session.close('dsh-ssh disposed').catch(() => { })));
+    }
+}
+export class BrowserTerminal {
+    id;
+    profileId;
+    connection;
+    channel;
+    onClose;
+    output = '';
+    baseCursor = 0;
+    closed = false;
+    idleTimer;
+    constructor(id, profileId, connection, channel, onClose) {
+        this.id = id;
+        this.profileId = profileId;
+        this.connection = connection;
+        this.channel = channel;
+        this.onClose = onClose;
+        this.idleTimer = setTimeout(() => { void this.close(); }, 30 * 60_000);
+        channel.setEncoding('utf8');
+        channel.on('data', (chunk) => this.append(String(chunk)));
+        channel.stderr?.setEncoding('utf8');
+        channel.stderr?.on('data', (chunk) => this.append(String(chunk)));
+        channel.once('close', () => { this.closed = true; connection.close(); onClose(); });
+    }
+    write(text) { this.touch(); if (this.closed)
+        throw new Error('terminal is closed'); this.channel.write(text); }
+    resize(cols, rows) { this.touch(); this.channel.setWindow(clamp(rows, 5, 200), clamp(cols, 20, 400), 0, 0); }
+    read(cursor) {
+        this.touch();
+        const safeCursor = Math.max(cursor, this.baseCursor);
+        const index = safeCursor - this.baseCursor;
+        return { data: this.output.slice(index), cursor: this.baseCursor + this.output.length, truncated: cursor < this.baseCursor, closed: this.closed };
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        clearTimeout(this.idleTimer);
+        this.channel.end();
+        this.connection.close();
+        this.onClose();
+    }
+    append(text) {
+        this.output += text;
+        if (this.output.length > 1_000_000) {
+            const removed = this.output.length - 750_000;
+            this.output = this.output.slice(removed);
+            this.baseCursor += removed;
+        }
+    }
+    touch() {
+        clearTimeout(this.idleTimer);
+        this.idleTimer = setTimeout(() => { void this.close(); }, 30 * 60_000);
+    }
+}
+function openShell(connection, cols, rows) {
+    return new Promise((resolve, reject) => {
+        connection.client.shell({ term: connection.profile.terminalType, cols, rows }, (error, channel) => error ? reject(error) : resolve(channel));
+    });
+}
+function normalizeSignal(signal) {
+    if (signal === undefined)
+        return null;
+    const normalized = signal.startsWith('SIG') ? signal : `SIG${signal}`;
+    return normalized;
+}
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, Number.isFinite(value) ? Math.floor(value) : min));
+}
+//# sourceMappingURL=terminal.js.map

package/lib/terminal.js.map

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

package/lib/tools.d.ts

@@ -0,0 +1,7 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { ForwardManager } from './forwards.js';
+import { SshConnector } from './connector.js';
+import { SshStore } from './store.js';
+import { AiTerminalManager } from './terminal.js';
+export declare function registerSshTools(ctx: Context, store: SshStore, connector: SshConnector, forwards: ForwardManager, terminals: AiTerminalManager): void;
+//# sourceMappingURL=tools.d.ts.map

package/lib/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AASjD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAwBrJ"}

package/lib/tools.js

@@ -0,0 +1,237 @@
+import { executeSshCommand } from './exec.js';
+import { sessionDirectory, setSessionDirectory } from './directory.js';
+const textOutput = {
+    schema: { type: 'string' },
+    render: (_args, value) => [{ type: 'text', text: String(value) }],
+};
+const APPROVAL_TOOLS = new Set(['ssh_exec', 'ssh_terminal_open', 'ssh_terminal_send', 'ssh_terminal_signal', 'ssh_forward_start', 'ssh_forward_stop']);
+export function registerSshTools(ctx, store, connector, forwards, terminals) {
+    const tools = [
+        listTool(store),
+        cwdTool(store, connector),
+        execTool(store, connector),
+        terminalOpenTool(store, terminals),
+        terminalSendTool(store, terminals),
+        terminalReadTool(store, terminals),
+        terminalSignalTool(store, terminals),
+        terminalCloseTool(store, terminals),
+        forwardListTool(store, forwards),
+        forwardStartTool(store, forwards),
+        forwardStopTool(store, forwards),
+    ];
+    for (const tool of tools)
+        ctx.tools.register(tool);
+    ctx.on('tools/pre-execute', async (exec, next) => {
+        if (!APPROVAL_TOOLS.has(exec.name))
+            return next();
+        const sessionId = exec.agent?.session.id;
+        if (sessionId === undefined)
+            return next();
+        const injection = store.injection(sessionId);
+        if (injection?.requireCommandApproval !== true)
+            return next();
+        return { kind: 'ask', reason: `SSH access to an injected remote host was requested by ${exec.name}.` };
+    });
+}
+function listTool(store) {
+    return tool('ssh_list', 'List SSH connections explicitly injected into this DSH conversation. It never reveals credentials or non-injected hosts.', {}, async (_args, exec) => {
+        const injection = requireInjection(store, exec);
+        const profiles = injection.profileIds.map(id => store.profile(id)).filter(item => item !== undefined).map(profile => ({
+            id: profile.id, name: profile.name, host: profile.host, port: profile.port, username: profile.username,
+            ...(profile.group === undefined ? {} : { group: profile.group }),
+            tags: profile.tags, permission: injection.permission, cwd: sessionDirectory(injection, profile.id),
+        }));
+        return json({ sessionId: injection.sessionId, profiles });
+    }, true);
+}
+function cwdTool(store, connector) {
+    return tool('ssh_set_cwd', 'Set and verify the working directory used by subsequent ssh_exec and ssh_terminal_open calls for one injected connection in this conversation.', {
+        profileId: { type: 'string', required: true, description: 'Exact injected profile id returned by ssh_list.' },
+        cwd: { type: 'string', required: true, description: 'Remote directory path. Supports absolute paths and paths under ~.' },
+    }, async (raw, exec) => {
+        const args = object(raw);
+        const profileId = string(args.profileId, 'profileId', 100);
+        requireProfile(store, exec, profileId, 'exec');
+        const sessionId = exec.agent.session.id;
+        const cwd = await setSessionDirectory(store, connector, sessionId, profileId, rawString(args.cwd, 'cwd', 4096), exec.signal);
+        return json({ profileId, cwd });
+    });
+}
+function execTool(store, connector) {
+    return tool('ssh_exec', 'Run one non-interactive command on an SSH connection injected into this conversation. Use ssh_list first and pass an exact profile id. Output is bounded.', {
+        profileId: { type: 'string', required: true, description: 'Exact injected profile id returned by ssh_list.' },
+        command: { type: 'string', required: true, description: 'Command to execute on the remote host.' },
+        timeoutMs: { type: 'integer', description: 'Optional timeout between 1000 and 300000 milliseconds.' },
+    }, async (raw, exec) => {
+        const args = object(raw);
+        const profileId = string(args.profileId, 'profileId', 100);
+        const injection = requireInjection(store, exec);
+        requireProfile(store, exec, profileId, 'exec');
+        const settings = store.settings();
+        const timeout = optionalInteger(args.timeoutMs, 'timeoutMs', 1000, 300_000) ?? settings.defaultCommandTimeoutMs;
+        return json(await executeSshCommand(connector, profileId, string(args.command, 'command', 100_000), timeout, settings.maxOutputChars, exec.signal, sessionDirectory(injection, profileId)));
+    });
+}
+function terminalOpenTool(store, terminals) {
+    return tool('ssh_terminal_open', 'Open an interactive terminal on an SSH connection injected with terminal permission. Returns an owner-scoped terminal id.', {
+        profileId: { type: 'string', required: true, description: 'Exact injected profile id returned by ssh_list.' },
+        name: { type: 'string', description: 'Optional terminal display name.' },
+    }, async (raw, exec) => {
+        const args = object(raw);
+        const profileId = string(args.profileId, 'profileId', 100);
+        const injection = requireInjection(store, exec);
+        const owner = requireProfile(store, exec, profileId, 'terminal');
+        const name = args.name === undefined ? undefined : string(args.name, 'name', 80);
+        return json(await terminals.create(owner.session.id, profileId, sessionDirectory(injection, profileId), name, exec.signal));
+    });
+}
+function terminalSendTool(store, terminals) {
+    return tool('ssh_terminal_send', 'Send text to an owned SSH terminal and wait until output becomes idle, the command exits, or timeout is reached.', {
+        terminalId: { type: 'string', required: true },
+        text: { type: 'string', required: true },
+        submit: { type: 'boolean', description: 'Append Enter after text. Defaults to true.' },
+    }, async (raw, exec) => {
+        const args = object(raw);
+        const owner = requireAnyInjection(store, exec);
+        return json(await terminals.send(owner.session.id, string(args.terminalId, 'terminalId', 200), {
+            text: rawString(args.text, 'text', 100_000), submit: args.submit !== false, signal: exec.signal,
+        }));
+    });
+}
+function terminalReadTool(store, terminals) {
+    return tool('ssh_terminal_read', 'Read bounded scrollback from an owned SSH terminal.', {
+        terminalId: { type: 'string', required: true },
+        offset: { type: 'integer' },
+        count: { type: 'integer' },
+    }, async (raw, exec) => {
+        const args = object(raw);
+        const owner = requireAnyInjection(store, exec);
+        return json(terminals.get(owner.session.id, string(args.terminalId, 'terminalId', 200)).read({
+            ...args.offset === undefined ? {} : { offset: integer(args.offset, 'offset', 0, 1_000_000) },
+            ...args.count === undefined ? {} : { count: integer(args.count, 'count', 1, 2000) },
+        }));
+    }, true);
+}
+function terminalSignalTool(store, terminals) {
+    return tool('ssh_terminal_signal', 'Send an allowed POSIX signal to an owned SSH terminal.', {
+        terminalId: { type: 'string', required: true },
+        signal: { type: 'string', required: true, enum: ['SIGINT', 'SIGTERM', 'SIGKILL', 'SIGTSTP', 'SIGHUP'] },
+    }, async (raw, exec) => {
+        const args = object(raw);
+        const owner = requireAnyInjection(store, exec);
+        const signal = string(args.signal, 'signal', 16);
+        return json(await terminals.get(owner.session.id, string(args.terminalId, 'terminalId', 200)).signal(signal));
+    });
+}
+function terminalCloseTool(store, terminals) {
+    return tool('ssh_terminal_close', 'Close an owned SSH terminal.', { terminalId: { type: 'string', required: true } }, async (raw, exec) => {
+        const owner = requireAnyInjection(store, exec);
+        const args = object(raw);
+        return json({ closed: await terminals.close(owner.session.id, string(args.terminalId, 'terminalId', 200)) });
+    });
+}
+function forwardListTool(store, forwards) {
+    return tool('ssh_forward_list', 'List port-forward rules belonging to SSH connections injected into this conversation.', {}, async (_raw, exec) => {
+        const injection = requireInjection(store, exec);
+        const statuses = new Map(forwards.list().map(item => [item.ruleId, item]));
+        const rules = store.forwards().filter(rule => injection.profileIds.includes(rule.profileId)).map(rule => ({ ...rule, status: statuses.get(rule.id) }));
+        return json({ rules });
+    }, true);
+}
+function forwardStartTool(store, forwards) {
+    return tool('ssh_forward_start', 'Start an existing port-forward rule whose SSH profile is injected into this conversation. Public binds remain subject to plugin policy.', {
+        ruleId: { type: 'string', required: true },
+    }, async (raw, exec) => {
+        const ruleId = string(object(raw).ruleId, 'ruleId', 100);
+        requireForward(store, exec, ruleId);
+        return json(await forwards.start(ruleId));
+    });
+}
+function forwardStopTool(store, forwards) {
+    return tool('ssh_forward_stop', 'Stop a running port-forward rule whose SSH profile is injected into this conversation.', {
+        ruleId: { type: 'string', required: true },
+    }, async (raw, exec) => {
+        const ruleId = string(object(raw).ruleId, 'ruleId', 100);
+        requireForward(store, exec, ruleId);
+        return json(await forwards.stop(ruleId));
+    });
+}
+function tool(name, description, properties, execute, concurrencySafe = false) {
+    const required = Object.entries(properties).filter(([, value]) => value.required === true).map(([key]) => key);
+    const schemaProperties = Object.fromEntries(Object.entries(properties).map(([key, value]) => {
+        const { required: _required, ...schema } = value;
+        return [key, schema];
+    }));
+    return {
+        name, description,
+        parameters: { type: 'object', additionalProperties: false, properties: schemaProperties, required },
+        output: textOutput,
+        execute,
+        isConcurrencySafe: () => concurrencySafe,
+        presentCall: args => ({ card: 'terminal', title: presentTitle(name, args) }),
+    };
+}
+function presentTitle(name, value) {
+    const args = typeof value === 'object' && value !== null ? value : {};
+    if (name === 'ssh_exec' && typeof args.command === 'string')
+        return args.command;
+    if (typeof args.profileId === 'string')
+        return `${name} · ${args.profileId}`;
+    return name;
+}
+function requireInjection(store, exec) {
+    const sessionId = exec.agent?.session.id;
+    if (sessionId === undefined)
+        throw new Error('SSH tools require an owning DSH session');
+    const injection = store.injection(sessionId);
+    if (injection === undefined || injection.profileIds.length === 0)
+        throw new Error('No SSH connection is injected into this DSH session. Ask the user to open 远端 and inject one.');
+    return injection;
+}
+function requireAnyInjection(store, exec) {
+    requireInjection(store, exec);
+    if (exec.agent === undefined)
+        throw new Error('SSH tools require an owning agent');
+    return exec.agent;
+}
+function requireProfile(store, exec, profileId, permission) {
+    const injection = requireInjection(store, exec);
+    if (!injection.profileIds.includes(profileId))
+        throw new Error('The requested SSH profile is not injected into this DSH session');
+    if (permission === 'terminal' && injection.permission !== 'terminal')
+        throw new Error('This session injection permits one-shot commands but not interactive terminals');
+    if (exec.agent === undefined)
+        throw new Error('SSH tools require an owning agent');
+    return exec.agent;
+}
+function requireForward(store, exec, ruleId) {
+    const rule = store.forward(ruleId);
+    if (rule === undefined)
+        throw new Error('Port-forward rule was not found');
+    requireProfile(store, exec, rule.profileId, 'terminal');
+}
+function object(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        throw new Error('arguments must be an object');
+    return value;
+}
+function string(value, name, max) {
+    if (typeof value !== 'string' || value.trim().length === 0 || value.length > max)
+        throw new Error(`${name} must be a non-empty string with at most ${max} characters`);
+    return value.trim();
+}
+function rawString(value, name, max) {
+    if (typeof value !== 'string' || value.length > max)
+        throw new Error(`${name} must be a string with at most ${max} characters`);
+    return value;
+}
+function integer(value, name, min, max) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < min || value > max)
+        throw new Error(`${name} must be an integer between ${min} and ${max}`);
+    return value;
+}
+function optionalInteger(value, name, min, max) {
+    return value === undefined ? undefined : integer(value, name, min, max);
+}
+function json(value) { return JSON.stringify(value, null, 2); }
+//# sourceMappingURL=tools.js.map