@dsh-cove/dsh-web-all 0.0.0-stage → 0.4.4

package/lib/types/core/schedule-mode/native.js

@@ -0,0 +1,82 @@
+function str(value) {
+    return typeof value === 'string' && value !== '' ? value : undefined;
+}
+function num(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+/** 从一条原生任务记录解出计时规则；无法识别返回 undefined（调用方跳过该条）。 */
+export function ruleFromRecord(record) {
+    if (record === null || typeof record !== 'object')
+        return undefined;
+    const value = record;
+    const scheduledAt = str(value.scheduledAt);
+    switch (value.kind) {
+        case 'after': {
+            const afterSeconds = num(value.afterSeconds);
+            return afterSeconds === undefined ? undefined : { kind: 'after', afterSeconds };
+        }
+        case 'at':
+            return scheduledAt === undefined ? undefined : { kind: 'at', at: scheduledAt };
+        case 'every': {
+            const everySeconds = num(value.everySeconds);
+            return everySeconds === undefined ? undefined : { kind: 'every', everySeconds };
+        }
+        case 'daily': {
+            const time = str(value.time);
+            const timeZone = str(value.timeZone);
+            return time === undefined || timeZone === undefined ? undefined : { kind: 'daily', time, timeZone };
+        }
+        case 'weekly': {
+            const time = str(value.time);
+            const timeZone = str(value.timeZone);
+            const weekdays = Array.isArray(value.weekdays)
+                ? value.weekdays.filter((day) => typeof day === 'number' && Number.isInteger(day))
+                : [];
+            return time === undefined || timeZone === undefined || weekdays.length === 0
+                ? undefined
+                : { kind: 'weekly', time, timeZone, weekdays };
+        }
+        case 'cron': {
+            const expression = str(value.expression);
+            const timeZone = str(value.timeZone);
+            return expression === undefined || timeZone === undefined ? undefined : { kind: 'cron', expression, timeZone };
+        }
+        default:
+            return undefined;
+    }
+}
+/**
+ * 把原生 `catalog()` 条目解码成 `NativeTaskView`。
+ * 结构不符的条目（例如未来新增的规则种类）返回 undefined，由调用方忽略，
+ * 保证本能力不会因为原生形态演进整块失效。
+ */
+export function nativeTaskView(entry) {
+    if (entry === null || typeof entry !== 'object')
+        return undefined;
+    const value = entry;
+    const sessionId = str(value.sessionId);
+    const id = str(value.id);
+    const title = str(value.title);
+    const prompt = str(value.prompt);
+    const scheduledAt = str(value.scheduledAt);
+    if (sessionId === undefined || id === undefined || title === undefined || prompt === undefined || scheduledAt === undefined)
+        return undefined;
+    if (value.status !== 'active' && value.status !== 'inactive')
+        throw new Error('native schedule catalog contains an unsupported task status');
+    const rule = ruleFromRecord(value);
+    if (rule === undefined)
+        return undefined;
+    const delivery = value.lastDelivery;
+    const lastDelivery = delivery !== null && typeof delivery === 'object'
+        ? (() => {
+            const record = delivery;
+            const scheduled = str(record.scheduledAt);
+            const delivered = str(record.deliveredAt);
+            return scheduled === undefined || delivered === undefined ? undefined : { scheduledAt: scheduled, deliveredAt: delivered };
+        })()
+        : undefined;
+    return {
+        sessionId, id, status: value.status, title, prompt, scheduledAt, rule,
+        ...(lastDelivery === undefined ? {} : { lastDelivery }),
+    };
+}

package/lib/types/core/schedule-mode/types.d.ts

@@ -0,0 +1,177 @@
+/**
+ * 自动化任务「会话模式」纯逻辑（host + client 共享）。
+ *
+ * 背景：DSH 原生 `@deepseek-ai/dsh-schedule` 把任务绑定在创建它的会话上，
+ * 到期后就地投递到该会话（`resolveAgent(sessionId)` + `followup`）。原生服务
+ * 不提供「每次运行新建会话」的选择，也不允许跨会话投递。
+ *
+ * 本能力在原任务之上加一层**运行目标策略**，不复制原生调度引擎：
+ *   - `original`（默认）：不建策略，完全走原生投递，行为零变化。
+ *   - `new`：把原生任务「轮转」到一条运行会话上——策略保存原任务的规则，
+ *     用原生 `schedule.create` 在一条新建的运行会话上挂一把同规则的运行副本，
+ *     并删除原会话上的那行；每次副本投递完成后，再新建下一条运行会话并把
+ *     副本轮转过去。原会话因此永远不再是投递目标，每次运行都落在一条全新会话。
+ *
+ * 轮转复用原生计时：副本自身按原规则推进 `scheduledAt`，到点由原生运行时投递，
+ * 因此本层不需要自己实现 cron / 每日 / 每周的时点计算。
+ *
+ * 本文件只有类型与纯函数，两侧 program 共同编译。
+ */
+/** 任务的运行目标：绑定原会话，或每次运行新建会话。 */
+export type ScheduleSessionMode = 'original' | 'new';
+/**
+ * 从原生任务记录归一化出来的计时规则；`timingArgs()` 可逆转回
+ * `schedule.create` / `schedule.update` 的 selector 参数。
+ */
+export type ScheduleModeRule = {
+    readonly kind: 'after';
+    readonly afterSeconds: number;
+} | {
+    readonly kind: 'at';
+    readonly at: string;
+} | {
+    readonly kind: 'every';
+    readonly everySeconds: number;
+} | {
+    readonly kind: 'daily';
+    readonly time: string;
+    readonly timeZone: string;
+} | {
+    readonly kind: 'weekly';
+    readonly time: string;
+    readonly timeZone: string;
+    readonly weekdays: readonly number[];
+} | {
+    readonly kind: 'cron';
+    readonly expression: string;
+    readonly timeZone: string;
+};
+/** 传给原生 `schedule.create` 的 selector 参数（恰好一个键）。 */
+export type NativeTimingArgs = {
+    readonly after_seconds: number;
+} | {
+    readonly at: string;
+} | {
+    readonly every_seconds: number;
+} | {
+    readonly daily: {
+        readonly time: string;
+        readonly time_zone: string;
+    };
+} | {
+    readonly weekly: {
+        readonly time: string;
+        readonly time_zone: string;
+        readonly weekdays: readonly number[];
+    };
+} | {
+    readonly cron: {
+        readonly expression: string;
+        readonly time_zone: string;
+    };
+};
+/** 原生 `schedule.create` 的最小请求面（prompt/title 由策略提供）。 */
+export interface NativeCreateRequest {
+    readonly prompt: string;
+    readonly title: string;
+    readonly selector: NativeTimingArgs;
+}
+/** 一次「新会话运行」记录。 */
+export interface ScheduleModeRun {
+    /** 该次发生的计划时点（UTC RFC 3339）。 */
+    readonly scheduledAt: string;
+    /** 原生确认投递的时间。 */
+    readonly deliveredAt: string;
+    /** 承载该次运行的会话。 */
+    readonly sessionId: string;
+    /** 该次运行使用的原生任务 id（轮转副本）。 */
+    readonly taskId: string;
+}
+/** A precise native row association; titles are never recovery identifiers. */
+export interface ScheduleModeTaskRef {
+    readonly sessionId: string;
+    readonly id: string;
+}
+/**
+ * Write-ahead transition journal. A persisted create intent without a returned ID
+ * is ambiguous: the external port has no idempotency key or transactional lookup.
+ * Recovery must stop rather than repeat that create.
+ */
+export interface ScheduleModeTransition {
+    readonly kind: 'new' | 'original' | 'rotate' | 'stop' | 'delete' | 'complete';
+    readonly phase: 'deleting' | 'prepare' | 'creating-session' | 'creating-task' | 'created' | 'recovery-required';
+    readonly deleteTasks: readonly ScheduleModeTaskRef[];
+    readonly sessionId?: string;
+    readonly created?: ScheduleModeTaskRef & {
+        readonly scheduledAt: string;
+    };
+    readonly reason?: string;
+}
+/**
+ * 「每次新建会话」策略。存在且 `active` 即表示该任务处于 `new` 模式；
+ * 任务回到 `original` 后策略保留为历史（`active: false`）。
+ */
+export interface ScheduleModePolicy {
+    /** 稳定键：`<原会话 id>\u0000<逻辑任务 id>`。 */
+    readonly key: string;
+    /** 原会话（任务的创建会话）。 */
+    readonly sourceSessionId: string;
+    /** 逻辑任务 id：用户最初创建的那条原生任务 id，轮转不改变它。 */
+    readonly logicalId: string;
+    readonly title: string;
+    readonly prompt: string;
+    /** 原任务的计时规则；轮转始终按它重建副本。 */
+    readonly rule: ScheduleModeRule;
+    /** 原会话的 cwd / preset，用于新建运行会话时继承。 */
+    readonly cwd?: string;
+    readonly agentPreset?: string;
+    /** 当前挂着的轮转副本（原生任务 id）。 */
+    readonly armedTaskId?: string;
+    /** 最近一次运行所在的会话。 */
+    readonly runSessionId?: string;
+    /** 下一次运行的计划时点（用于展示与缺失副本时的重建）。 */
+    readonly nextScheduledAt?: string;
+    /** 最近一次已记录运行的原生投递时间（幂等水位）。 */
+    readonly lastDeliveredAt?: string;
+    readonly runs: readonly ScheduleModeRun[];
+    /** 策略是否仍在生效。 */
+    readonly active: boolean;
+    /**
+     * 一次任务结束原因：`completed`（一次性任务已跑完）/ `ended`（用户切回原会话或被归档停止）/
+     * `deleted`（用户在原生自动化页删掉了轮转副本，策略随之退役且不再重建）。
+     */
+    readonly endedReason?: 'completed' | 'ended' | 'deleted';
+    /**
+     * Legacy v1 interrupted rotation marker, retained for decoding compatibility.
+     * It lacks create-result association and requested direction; recovery must
+     * mark it recovery-required rather than recreate an unidentifiable task.
+     */
+    readonly rotationInFlight?: boolean;
+    readonly transition?: ScheduleModeTransition;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+}
+/** 每次运行新建会话标题前缀的最大长度（原生标题上限 120）。 */
+export declare const RUN_TITLE_MAX = 120;
+/** 默认保留的运行记录条数。 */
+export declare const DEFAULT_RUN_HISTORY_LIMIT = 50;
+/** 稳定策略键。 */
+export declare function policyKey(sourceSessionId: string, logicalId: string): string;
+/** 周期重复的规则种类。 */
+export type RecurringScheduleModeRule = Extract<ScheduleModeRule, {
+    kind: 'every' | 'daily' | 'weekly' | 'cron';
+}>;
+/** 规则是否周期重复（一次性规则跑完即结束）。 */
+export declare function isRecurringRule(rule: ScheduleModeRule): rule is RecurringScheduleModeRule;
+/** 规则到原生 selector 参数的映射。 */
+export declare function timingArgs(rule: ScheduleModeRule): NativeTimingArgs;
+/**
+ * 一次性规则在给定时刻之后是否还有目标。
+ * 周期规则总是可重建（相位按原生 `create` 语义从保存时刻起算）。
+ */
+export declare function ruleCanArm(rule: ScheduleModeRule, now: number): boolean;
+/** 新运行会话的标题：`<任务名> · 第 N 次运行`，裁剪到原生上限。 */
+export declare function runSessionTitle(title: string, runNumber: number): string;
+/** 追加一条运行记录并按上限裁剪（新记录优先保留）。 */
+export declare function appendRun(runs: readonly ScheduleModeRun[], run: ScheduleModeRun, limit?: number): ScheduleModeRun[];
+//# sourceMappingURL=types.d.ts.map

package/lib/types/core/schedule-mode/types.d.ts.map

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

package/lib/types/core/schedule-mode/types.js

@@ -0,0 +1,65 @@
+/**
+ * 自动化任务「会话模式」纯逻辑（host + client 共享）。
+ *
+ * 背景：DSH 原生 `@deepseek-ai/dsh-schedule` 把任务绑定在创建它的会话上，
+ * 到期后就地投递到该会话（`resolveAgent(sessionId)` + `followup`）。原生服务
+ * 不提供「每次运行新建会话」的选择，也不允许跨会话投递。
+ *
+ * 本能力在原任务之上加一层**运行目标策略**，不复制原生调度引擎：
+ *   - `original`（默认）：不建策略，完全走原生投递，行为零变化。
+ *   - `new`：把原生任务「轮转」到一条运行会话上——策略保存原任务的规则，
+ *     用原生 `schedule.create` 在一条新建的运行会话上挂一把同规则的运行副本，
+ *     并删除原会话上的那行；每次副本投递完成后，再新建下一条运行会话并把
+ *     副本轮转过去。原会话因此永远不再是投递目标，每次运行都落在一条全新会话。
+ *
+ * 轮转复用原生计时：副本自身按原规则推进 `scheduledAt`，到点由原生运行时投递，
+ * 因此本层不需要自己实现 cron / 每日 / 每周的时点计算。
+ *
+ * 本文件只有类型与纯函数，两侧 program 共同编译。
+ */
+/** 每次运行新建会话标题前缀的最大长度（原生标题上限 120）。 */
+export const RUN_TITLE_MAX = 120;
+/** 默认保留的运行记录条数。 */
+export const DEFAULT_RUN_HISTORY_LIMIT = 50;
+/** 稳定策略键。 */
+export function policyKey(sourceSessionId, logicalId) {
+    return `${sourceSessionId}\u0000${logicalId}`;
+}
+/** 规则是否周期重复（一次性规则跑完即结束）。 */
+export function isRecurringRule(rule) {
+    return rule.kind === 'every' || rule.kind === 'daily' || rule.kind === 'weekly' || rule.kind === 'cron';
+}
+/** 规则到原生 selector 参数的映射。 */
+export function timingArgs(rule) {
+    switch (rule.kind) {
+        case 'after': return { after_seconds: rule.afterSeconds };
+        case 'at': return { at: rule.at };
+        case 'every': return { every_seconds: rule.everySeconds };
+        case 'daily': return { daily: { time: rule.time, time_zone: rule.timeZone } };
+        case 'weekly': return { weekly: { time: rule.time, time_zone: rule.timeZone, weekdays: [...rule.weekdays] } };
+        case 'cron': return { cron: { expression: rule.expression, time_zone: rule.timeZone } };
+    }
+}
+/**
+ * 一次性规则在给定时刻之后是否还有目标。
+ * 周期规则总是可重建（相位按原生 `create` 语义从保存时刻起算）。
+ */
+export function ruleCanArm(rule, now) {
+    if (isRecurringRule(rule))
+        return true;
+    if (rule.kind === 'after')
+        return true;
+    return Number.isFinite(Date.parse(rule.at)) && Date.parse(rule.at) > now;
+}
+/** 新运行会话的标题：`<任务名> · 第 N 次运行`，裁剪到原生上限。 */
+export function runSessionTitle(title, runNumber) {
+    const suffix = ` · #${runNumber}`;
+    const room = RUN_TITLE_MAX - suffix.length;
+    const base = title.length > room ? title.slice(0, Math.max(0, room)) : title;
+    return `${base}${suffix}`;
+}
+/** 追加一条运行记录并按上限裁剪（新记录优先保留）。 */
+export function appendRun(runs, run, limit = DEFAULT_RUN_HISTORY_LIMIT) {
+    const budget = Number.isFinite(limit) && limit > 0 ? Math.trunc(limit) : DEFAULT_RUN_HISTORY_LIMIT;
+    return [...runs, run].slice(-budget);
+}

package/lib/types/core/schedule-mode/view.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 面板/Host 之间的 wire 视图（host 与 browser 共享）。
+ *
+ * 面板只读这一份形状：Host 把「原生任务」与「会话模式策略」合并成一条
+ * 逻辑任务，客户端不接触原生 schedule 的目录细节。
+ */
+import type { ScheduleModeRule, ScheduleModeRun, ScheduleSessionMode } from './types.ts';
+export type { ScheduleModeRule, ScheduleModeRun, ScheduleSessionMode } from './types.ts';
+/** 一条逻辑任务的合并视图。 */
+export interface ScheduleModeTaskView {
+    /** 任务的原会话（原始对话）。 */
+    readonly sessionId: string;
+    /** 稳定的逻辑任务 id（`new` 模式下与当前副本 id 不同）。 */
+    readonly id: string;
+    /** 当前挂着的原生任务 id（`new` 模式下是轮转副本）。 */
+    readonly activeTaskId?: string;
+    readonly title: string;
+    readonly prompt: string;
+    readonly mode: ScheduleSessionMode;
+    /** `inactive`：原生一次性任务已跑完；`ended`：策略已停止。 */
+    readonly status: 'active' | 'inactive' | 'ended';
+    readonly rule: ScheduleModeRule;
+    /** 下一次运行的计划时点（UTC）；已结束或不可知时缺省。 */
+    readonly scheduledAt?: string;
+    /** 最近一次运行所在的会话（`new` 模式）。 */
+    readonly runSessionId?: string;
+    readonly lastDeliveredAt?: string;
+    /** 运行记录，最新在后。 */
+    readonly runs: readonly ScheduleModeRun[];
+    /** Interrupted journal state; no exactly-once guarantee is implied. */
+    readonly recovery?: {
+        readonly phase: string;
+        readonly reason?: string;
+    };
+    readonly updatedAt: number;
+}
+/** `GET /tasks` 的 value。 */
+export interface ScheduleModeListValue {
+    readonly tasks: readonly ScheduleModeTaskView[];
+    /** 原生 schedule 服务是否可用；不可用时列表为空。 */
+    readonly available: boolean;
+}
+/** `POST /mode` 的请求体。 */
+export interface ScheduleModeSetRequest {
+    readonly sessionId: string;
+    readonly id: string;
+    readonly mode: ScheduleSessionMode;
+}
+/** `POST /mode` 的 value。 */
+export interface ScheduleModeSetValue {
+    readonly task: ScheduleModeTaskView;
+}
+/** `POST /delete` 的请求体。 */
+export interface ScheduleModeDeleteRequest {
+    readonly sessionId: string;
+    readonly id: string;
+}
+/** 路由前缀（面板 API）。 */
+export declare const SCHEDULE_MODE_API_PREFIX = "/api/schedule-mode";
+/** 面板的语义属性标记。 */
+export declare const SCHEDULE_MODE_PLUGIN = "schedule-mode";
+//# sourceMappingURL=view.d.ts.map

package/lib/types/core/schedule-mode/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../../src/core/schedule-mode/view.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAExF,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAExF,mBAAmB;AACnB,MAAM,WAAW,oBAAoB;IACnC,oBAAoB;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,oCAAoC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAA;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAA;IAChD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAA;IACzC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACxE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,4BAA4B;AAC5B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAA;IAC/C,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,yBAAyB;AACzB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAA;CACnC;AAED,4BAA4B;AAC5B,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;CACpC;AAED,2BAA2B;AAC3B,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAED,oBAAoB;AACpB,eAAO,MAAM,wBAAwB,uBAAuB,CAAA;AAE5D,iBAAiB;AACjB,eAAO,MAAM,oBAAoB,kBAAkB,CAAA"}

package/lib/types/core/schedule-mode/view.js

@@ -0,0 +1,4 @@
+/** 路由前缀（面板 API）。 */
+export const SCHEDULE_MODE_API_PREFIX = '/api/schedule-mode';
+/** 面板的语义属性标记。 */
+export const SCHEDULE_MODE_PLUGIN = 'schedule-mode';

package/lib/types/core/ssh/protocol.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Wire contract between the host half (routes.ts) and the browser half
+ * (client/api.ts). Pure types only — imported by both halves, bundled into
+ * each, no runtime identity to share.
+ */
+/** Authentication flavors a host entry may carry. */
+export type SshAuthKind = 'key' | 'password' | 'agent';
+/** Canonical OpenSSH SHA256 fingerprint (32 bytes, unpadded base64). */
+export declare function isHostKeyFingerprint(value: unknown): value is string;
+/** One stored host entry (the $DSH_HOME/dsh-ssh.json store shape). */
+export interface SshHostEntry {
+    /** Stable, user-chosen identifier used by every operation. */
+    alias: string;
+    /** Hostname or IP of the target. */
+    host: string;
+    /** Explicit, out-of-band verified SHA256 pin; otherwise use ~/.ssh/known_hosts. */
+    hostKeyFingerprint?: string;
+    /** SSH port (default 22). */
+    port: number;
+    /** Login user. */
+    user: string;
+    /** Authentication. */
+    auth: {
+        kind: SshAuthKind;
+        /** Absolute path to the private key for 'key' auth. */
+        keyPath?: string;
+        /** Passphrase for an encrypted key. */
+        passphrase?: string;
+        /** Password for 'password' auth. */
+        password?: string;
+        /**
+         * ssh-agent endpoint for 'agent' auth. A socket path, the special value
+         * 'pageant' (PuTTY Pageant on Windows), or undefined for auto-detect
+         * (SSH_AUTH_SOCK, then Pageant on Windows).
+         */
+        agentPath?: string;
+    };
+    /** Jump chain: local aliases connected through in order (ProxyJump). */
+    proxyJump: string[];
+    /** Free-form note. */
+    description?: string;
+    /** Deployment environment label (development / production / ...). */
+    environment?: string;
+    /** Free-form tags. */
+    tags: string[];
+    /** Physical location note. */
+    location?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+/** Public (secret-free) projection of an entry, safe for the browser/agent. */
+export interface SshHostSummary {
+    alias: string;
+    host: string;
+    /** Explicit, out-of-band verified SHA256 pin; otherwise use ~/.ssh/known_hosts. */
+    hostKeyFingerprint?: string;
+    port: number;
+    user: string;
+    auth: SshAuthKind;
+    /** Whether the key path exists on the host machine (key auth only). */
+    keyReady: boolean;
+    proxyJump: string[];
+    description?: string;
+    environment?: string;
+    tags: string[];
+    location?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+/** Result of one non-interactive command execution. */
+export interface ExecResult {
+    success: boolean;
+    /** Remote exit code, or null when the channel died without one. */
+    exitCode: number | null;
+    timedOut: boolean;
+    stdout: string;
+    stderr: string;
+    /** Wall-clock duration of the round trip in ms. */
+    durationMs: number;
+    /** Connection error message when the command never ran. */
+    error?: string;
+}
+/** One server entry in a cluster run. */
+export interface ClusterResult {
+    alias: string;
+    ok: boolean;
+    exitCode?: number | null;
+    timedOut?: boolean;
+    stdout?: string;
+    stderr?: string;
+    durationMs?: number;
+    error?: string;
+}
+/** SFTP transfer progress frame (upload stream). */
+export interface TransferProgress {
+    phase: 'connecting' | 'transferring' | 'done' | 'error';
+    file: string;
+    transferred: number;
+    total: number;
+    percent: number;
+    speedBps?: number;
+    error?: string;
+}
+/** One active local port-forward tunnel. */
+export interface TunnelInfo {
+    id: string;
+    alias: string;
+    localPort: number;
+    remoteHost: string;
+    remotePort: number;
+    state: 'forwarding' | 'connecting' | 'failed';
+    error?: string;
+    startedAt: number;
+}
+/** One directory listing entry (remote file browser). */
+export interface RemoteDirEntry {
+    name: string;
+    type: 'dir' | 'file' | 'other';
+    size: number;
+    mtimeMs: number;
+    mode?: number;
+}
+/** Test-connection outcome. */
+export interface TestResult {
+    ok: boolean;
+    latencyMs?: number;
+    error?: string;
+}
+/** Host edit payload (create/update); 'alias' comes from the URL for updates. */
+export interface HostPayload {
+    alias?: string;
+    host: string;
+    /** Explicit SHA256 pin; PATCH null clears it and returns to known_hosts. */
+    hostKeyFingerprint?: string | null;
+    port?: number;
+    user: string;
+    /**
+     * Authentication. Required on create; on update an omitted auth keeps the
+     * stored secrets (the browser never receives them back).
+     */
+    auth?: SshHostEntry['auth'];
+    proxyJump?: string[];
+    description?: string;
+    environment?: string;
+    tags?: string[];
+    location?: string;
+}
+/** Import outcome from ~/.ssh/config. */
+export interface ImportResult {
+    parsed: number;
+    added: number;
+    skipped: number;
+    /** Aliases that failed to map (wildcard patterns, missing HostName, ...). */
+    skippedNames: string[];
+}
+/** JSON error body used by every route. */
+export interface ApiErrorBody {
+    error: string;
+}
+/** WebSocket terminal protocol frames (host -> client and client -> host). */
+export type TerminalServerFrame = {
+    type: 'ready';
+    alias: string;
+} | {
+    type: 'output';
+    data: string;
+} | {
+    type: 'exit';
+    code: number | null;
+    error?: string;
+} | {
+    type: 'auth_prompt';
+    name: string;
+    instructions: string;
+    prompts: Array<{
+        prompt: string;
+        echo: boolean;
+    }>;
+};
+export type TerminalClientFrame = {
+    type: 'input';
+    data: string;
+} | {
+    type: 'resize';
+    cols: number;
+    rows: number;
+} | {
+    type: 'auth_response';
+    responses: string[];
+};
+/** Route paths the client calls (shared literals). */
+export declare const SSH_API_BASE: "/api/dsh-ssh";
+export declare const SSH_API: {
+    readonly hosts: string;
+    readonly importSshConfig: string;
+    readonly test: string;
+    readonly exec: string;
+    readonly cluster: string;
+    readonly upload: string;
+    readonly download: string;
+    readonly ls: string;
+    readonly tunnel: string;
+    readonly terminal: string;
+};
+/** NDJSON transfer stream line shapes (upload). */
+export type TransferStreamLine = {
+    type: 'progress';
+    progress: TransferProgress;
+} | {
+    type: 'result';
+    ok: boolean;
+    transferredBytes?: number;
+    error?: string;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/lib/types/core/ssh/protocol.d.ts.map

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

package/lib/types/core/ssh/protocol.js

@@ -0,0 +1,23 @@
+/**
+ * Wire contract between the host half (routes.ts) and the browser half
+ * (client/api.ts). Pure types only — imported by both halves, bundled into
+ * each, no runtime identity to share.
+ */
+/** Canonical OpenSSH SHA256 fingerprint (32 bytes, unpadded base64). */
+export function isHostKeyFingerprint(value) {
+    return typeof value === 'string' && /^SHA256:[A-Za-z0-9+/]{42}[AEIMQUYcgkosw048]$/.test(value);
+}
+/** Route paths the client calls (shared literals). */
+export const SSH_API_BASE = '/api/dsh-ssh';
+export const SSH_API = {
+    hosts: SSH_API_BASE + '/hosts',
+    importSshConfig: SSH_API_BASE + '/hosts/import-ssh-config',
+    test: SSH_API_BASE + '/test',
+    exec: SSH_API_BASE + '/exec',
+    cluster: SSH_API_BASE + '/cluster',
+    upload: SSH_API_BASE + '/upload',
+    download: SSH_API_BASE + '/download',
+    ls: SSH_API_BASE + '/ls',
+    tunnel: SSH_API_BASE + '/tunnel',
+    terminal: SSH_API_BASE + '/terminal',
+};