@barryfan2045/dsh-matrix 0.1.0

package/dist/cli/systemd.d.ts

@@ -0,0 +1,32 @@
+/**
+ * systemd user unit 生成(纯函数)+ homeserver→NO_PROXY 提取。
+ *
+ * 移植自 pi-courier src/cli.ts 的 buildUnit(111-142 行),语义改为:
+ * ExecStart 不再是本包 dist,而是当前 node bin 目录里的 dsh 启动器
+ * (`<nodeBin> <dshBin> --profile <name>`),并把 nvm bin 目录置于 PATH 首位
+ * (systemd 默认 PATH 会找到旧版系统 node——pi-courier 实测坑)。
+ * NO_PROXY 从配置 homeserver 提取 host(主会话实测:坏代理会卡死桥连接)。
+ */
+export interface UnitInput {
+    /** process.execPath,例如 ~/.nvm/versions/node/v24.20.0/bin/node。 */
+    nodeBin: string;
+    /** dsh 启动器的绝对路径(node 可直接执行)。 */
+    dshBin: string;
+    /** dsh profile 名(实例名),如 "matrix"。 */
+    profile: string;
+    /**
+     * 桥所在的 dsh 家目录(绝对路径)。**必须写进 unit**:systemd user 管理器的
+     * 环境里没有 DSH_HOME,dsh 会回落到 ~/.dsh —— 用自定义家目录的人会看到服务
+     * 反复 exit 1 重启(journal 里是 `profile "x" does not exist`)。
+     */
+    dshHome?: string;
+    /** 提取好的 homeserver host;undefined = 不写 NO_PROXY。 */
+    noProxyHost?: string;
+    /** unit 文件名(不含 .service),默认 "dsh-matrix"。 */
+    serviceName?: string;
+}
+/** 从 homeserver URL 提取 NO_PROXY 主机名;解析失败返回 null。 */
+export declare function homeserverProxyHost(homeserver: string | undefined): string | null;
+/** 生成 systemd user unit 文本(确定性输出,便于快照测试)。 */
+export declare function buildUserUnit(input: UnitInput): string;
+//# sourceMappingURL=systemd.d.ts.map

package/dist/cli/systemd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemd.d.ts","sourceRoot":"","sources":["../../src/cli/systemd.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,SAAS;IACxB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAA;IACf,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAID,oDAAoD;AACpD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CASjF;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CA8BtD"}

package/dist/cli/systemd.js

@@ -0,0 +1,58 @@
+/**
+ * systemd user unit 生成(纯函数)+ homeserver→NO_PROXY 提取。
+ *
+ * 移植自 pi-courier src/cli.ts 的 buildUnit(111-142 行),语义改为:
+ * ExecStart 不再是本包 dist,而是当前 node bin 目录里的 dsh 启动器
+ * (`<nodeBin> <dshBin> --profile <name>`),并把 nvm bin 目录置于 PATH 首位
+ * (systemd 默认 PATH 会找到旧版系统 node——pi-courier 实测坑)。
+ * NO_PROXY 从配置 homeserver 提取 host(主会话实测:坏代理会卡死桥连接)。
+ */
+const SYSTEM_PATHS = '/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin';
+/** 从 homeserver URL 提取 NO_PROXY 主机名;解析失败返回 null。 */
+export function homeserverProxyHost(homeserver) {
+    if (!homeserver)
+        return null;
+    try {
+        const url = new URL(homeserver);
+        if (!url.hostname)
+            return null;
+        return url.hostname.toLowerCase();
+    }
+    catch {
+        return null;
+    }
+}
+/** 生成 systemd user unit 文本(确定性输出,便于快照测试)。 */
+export function buildUserUnit(input) {
+    const serviceName = input.serviceName ?? 'dsh-matrix';
+    const nodeDir = input.nodeBin.replace(/[/\\][^/\\]*$/, '');
+    const noProxy = input.noProxyHost
+        ? `localhost,127.0.0.1,${input.noProxyHost}`
+        : undefined;
+    const envLines = [`Environment=PATH=${nodeDir}:${SYSTEM_PATHS}`];
+    // profile 装在 $DSH_HOME 下,而 systemd user 管理器不带 DSH_HOME:
+    // 不显式写死,dsh 会去找 ~/.dsh,自定义家目录下服务会反复 exit 1 重启。
+    if (input.dshHome)
+        envLines.push(`Environment=DSH_HOME=${input.dshHome}`);
+    if (noProxy) {
+        envLines.push(`Environment=NO_PROXY=${noProxy}`);
+        envLines.push(`Environment=no_proxy=${noProxy}`);
+    }
+    return `[Unit]
+Description=dsh-matrix (Matrix chat -> DSH agent sessions, profile ${input.profile})
+After=default.target
+
+[Service]
+Type=simple
+${envLines.join('\n')}
+ExecStart=${input.nodeBin} ${input.dshBin} --profile ${input.profile}
+Restart=on-failure
+RestartSec=5
+NoNewPrivileges=true
+PrivateTmp=true
+
+[Install]
+WantedBy=default.target
+`;
+}
+//# sourceMappingURL=systemd.js.map

package/dist/cli/systemd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemd.js","sourceRoot":"","sources":["../../src/cli/systemd.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqBH,MAAM,YAAY,GAAG,8DAA8D,CAAA;AAEnF,oDAAoD;AACpD,MAAM,UAAU,mBAAmB,CAAC,UAA8B;IAChE,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAA;QAC/B,IAAI,CAAC,GAAG,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QAC9B,OAAO,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC5C,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,YAAY,CAAA;IACrD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAA;IAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW;QAC/B,CAAC,CAAC,uBAAuB,KAAK,CAAC,WAAW,EAAE;QAC5C,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,QAAQ,GAAG,CAAC,oBAAoB,OAAO,IAAI,YAAY,EAAE,CAAC,CAAA;IAChE,wDAAwD;IACxD,+CAA+C;IAC/C,IAAI,KAAK,CAAC,OAAO;QAAE,QAAQ,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IACzE,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,IAAI,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAA;QAChD,QAAQ,CAAC,IAAI,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAA;IAClD,CAAC;IACD,OAAO;qEAC4D,KAAK,CAAC,OAAO;;;;;EAKhF,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YACT,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,cAAc,KAAK,CAAC,OAAO;;;;;;;;CAQnE,CAAA;AACD,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,54 @@
+export type LogLevelName = 'debug' | 'info' | 'warn' | 'error';
+export interface BridgeConfig {
+    homeserver: string;
+    username?: string;
+    password?: string;
+    accessToken?: string;
+    trustedUsers: string[];
+    workdir: string;
+    logLevel: LogLevelName;
+    /** Runtime auth persistence (T2). trustedUsers stays a boot snapshot. */
+    auth: {
+        storePath: string;
+    };
+    /** Fixed provider/model route; omitted → deployment default at create time. */
+    provider?: string;
+    model?: string;
+    /** true = edit one message as the turn streams (ticket T7). */
+    streamReplies?: boolean;
+    maxChunkChars?: number;
+    /** E2EE 默认开;false 强制明文。 */
+    encryption?: boolean;
+    /** Matrix 状态目录(sync store + crypto keys);默认由入口给 ~/.dsh/dsh-matrix。 */
+    dataDir?: string;
+    /** T6 附件策略(US28/41):单附件上限 MB(默认 10);dir 为桥的兜底落盘目录。 */
+    attachments: {
+        maxMb: number;
+        dir?: string;
+    };
+    /** 一个项目的房间映射条目:cwd + 展示名(US34)。 */
+    projects?: Record<string, {
+        name?: string;
+        workdir: string;
+    }>;
+    /** true = 多项目模式(pipeline 装配时组合 ProjectMap 提供 resolveCwd)。 */
+    multiProject: boolean;
+    /** 管理房间持久层在 ProjectMap 存储里;config 值仅作 boot 种子(T12 空间票再扩)。 */
+    managementRooms?: string[];
+    /** 实例名(管理房间文案 + /pmctl 建房房名);缺省由入口给 os.hostname()。 */
+    instanceName?: string;
+    /**
+     * T12 空间与头像(US38)。`enabled` 打开后,桥把它建的管理房与项目房都归进一个
+     * 私有 space(`π <实例名>`),并按名字哈希给每个房间挂内置头像池里的图。
+     * `roomId` 是已认领的 space(自愈时复用,不重复建);`avatarPoolVersion` 是
+     * 已铺过的头像池版本,落后于 AVATAR_POOL_VERSION 时启动自愈会重铺一次。
+     */
+    space?: SpaceConfig;
+}
+export interface SpaceConfig {
+    enabled: boolean;
+    roomId?: string;
+    avatarPoolVersion?: number;
+}
+export declare function loadConfig(row: Record<string, unknown>, env?: NodeJS.ProcessEnv): BridgeConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE9D,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,YAAY,CAAA;IACtB,yEAAyE;IACzE,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sDAAsD;IACtD,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC7D,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAA;IACrB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,WAAW,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAwCD,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,YAAY,CAgEd"}

package/dist/config.js

@@ -0,0 +1,107 @@
+/**
+ * T1 config resolution: row config (from the cordis patch, overridable per
+ * profile layer) merged with environment overrides. Pure function - the
+ * on-disk ConfigStore (~/.dsh/dsh-matrix.json) arrives with the ops ticket.
+ */
+import { DEFAULT_AUTH_STORE_PATH } from "./auth/store.js";
+/** T12: 逐项校验 space 配置 —— enabled 必须是布尔;roomId/版本可选。 */
+function parseSpace(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return undefined;
+    const row = value;
+    if (typeof row.enabled !== 'boolean')
+        return undefined;
+    const out = { enabled: row.enabled };
+    if (typeof row.roomId === 'string' && row.roomId)
+        out.roomId = row.roomId;
+    if (typeof row.avatarPoolVersion === 'number' && Number.isFinite(row.avatarPoolVersion)) {
+        out.avatarPoolVersion = row.avatarPoolVersion;
+    }
+    return out;
+}
+function isLogLevel(value) {
+    return value === 'debug' || value === 'info' || value === 'warn' || value === 'error';
+}
+/** T9: 逐项校验项目映射 —— workdir 必须是非空字符串;name 可选字符串。 */
+function parseProjects(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return undefined;
+    const out = {};
+    for (const [roomId, raw] of Object.entries(value)) {
+        if (typeof raw !== 'object' || raw === null)
+            continue;
+        const entry = raw;
+        if (typeof entry.workdir !== 'string' || !entry.workdir)
+            continue;
+        out[roomId] = typeof entry.name === 'string' && entry.name
+            ? { name: entry.name, workdir: entry.workdir }
+            : { workdir: entry.workdir };
+    }
+    return out;
+}
+function parseStringList(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const out = value.filter((x) => typeof x === 'string' && x.length > 0);
+    return out.length > 0 ? out : undefined;
+}
+export function loadConfig(row, env = process.env) {
+    const homeserver = env.PI_MATRIX_HOMESERVER ?? row.homeserver;
+    const rowToken = row.accessToken;
+    const accessToken = env.PI_MATRIX_ACCESS_TOKEN ?? rowToken;
+    const username = row.username;
+    const password = row.password;
+    const trustedRaw = env.PI_MATRIX_TRUSTED_USERS ?? row.trustedUsers;
+    const trustedUsers = typeof trustedRaw === 'string'
+        ? trustedRaw.split(',').map((s) => s.trim()).filter(Boolean)
+        : Array.isArray(trustedRaw) ? trustedRaw.map(String) : [];
+    const logLevelEnv = env.PI_LOG_LEVEL;
+    const logLevel = isLogLevel(logLevelEnv) ? logLevelEnv : isLogLevel(row.logLevel) ? row.logLevel : 'info';
+    const workdir = env.PI_WORKDIR ?? row.workdir ?? '~';
+    const rowAuth = typeof row.auth === 'object' && row.auth !== null ? row.auth : {};
+    const authStorePath = env.PI_MATRIX_AUTH_STORE
+        ?? (typeof rowAuth.storePath === 'string' && rowAuth.storePath ? rowAuth.storePath : undefined)
+        ?? DEFAULT_AUTH_STORE_PATH;
+    // T6 attachments: nested row object; env wins over the row; junk falls back
+    // to the 10 MB default rather than throwing at boot.
+    const rowAtt = typeof row.attachments === 'object' && row.attachments !== null ? row.attachments : {};
+    const envMaxMb = env.PI_MATRIX_ATTACH_MAX_MB !== undefined ? Number(env.PI_MATRIX_ATTACH_MAX_MB) : Number.NaN;
+    const maxMb = Number.isFinite(envMaxMb) && envMaxMb > 0
+        ? envMaxMb
+        : (typeof rowAtt.maxMb === 'number' && rowAtt.maxMb > 0 ? rowAtt.maxMb : 10);
+    const attachDir = typeof rowAtt.dir === 'string' && rowAtt.dir ? rowAtt.dir : undefined;
+    const missing = [];
+    if (!homeserver)
+        missing.push('homeserver');
+    if (!accessToken && !(username && password))
+        missing.push('accessToken(或 username+password)');
+    if (missing.length > 0) {
+        throw new Error(`dsh-matrix 配置缺少: ${missing.join('、')}(用 dsh plugin add 后在 profile 的 cordis.patch.yml 按 id matrix-bridge 覆盖 config)`);
+    }
+    const parsedProjects = parseProjects(row.projects);
+    const parsedManagementRooms = parseStringList(row.managementRooms);
+    const parsedSpace = parseSpace(row.space);
+    return {
+        homeserver: String(homeserver),
+        ...(username ? { username: String(username) } : {}),
+        ...(password ? { password: String(password) } : {}),
+        ...(accessToken ? { accessToken: String(accessToken) } : {}),
+        trustedUsers,
+        workdir: String(workdir),
+        logLevel,
+        auth: { storePath: authStorePath },
+        ...(typeof row.provider === 'string' && row.provider ? { provider: row.provider } : {}),
+        ...(typeof row.model === 'string' && row.model ? { model: row.model } : {}),
+        ...(typeof row.streamReplies === 'boolean' ? { streamReplies: row.streamReplies } : {}),
+        ...(typeof row.maxChunkChars === 'number' ? { maxChunkChars: row.maxChunkChars } : {}),
+        ...(typeof row.encryption === 'boolean' ? { encryption: row.encryption } : {}),
+        ...(typeof row.dataDir === 'string' && row.dataDir ? { dataDir: row.dataDir } : {}),
+        attachments: { maxMb, ...(attachDir ? { dir: attachDir } : {}) },
+        ...(parsedProjects ? { projects: parsedProjects } : {}),
+        multiProject: row.multiProject === true,
+        ...(parsedManagementRooms ? { managementRooms: parsedManagementRooms } : {}),
+        ...(typeof row.instanceName === 'string' && row.instanceName ? { instanceName: row.instanceName } : {}),
+        ...(parsedSpace ? { space: parsedSpace } : {}),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/dsh/backend.d.ts

@@ -0,0 +1,110 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { Backend, ModelInfo, ModelSelection, PassthroughCommandInfo, SessionHandle, SessionListEntry, ThinkingEffort } from '../ports/backend.ts';
+import type { Logger } from '../types.ts';
+interface UserMessageLike {
+    content?: unknown[];
+}
+/** Structural view of dsh-agent's public `Inbox` (nextTurn/nextStep pending). */
+interface InboxLike {
+    readonly nextTurn?: readonly UserMessageLike[];
+    readonly nextStep?: readonly UserMessageLike[];
+}
+interface AgentLike {
+    readonly session: {
+        id: string;
+        snapshotEvents(): readonly unknown[];
+    };
+    readonly status: string;
+    /** Durable pending work; present with the default loop driver, absent-safe. */
+    readonly inbox?: InboxLike;
+    /** Live route of this agent (dsh-agent runtime-types Agent.options). */
+    readonly options?: {
+        provider?: string;
+        model?: string;
+        reasoningEffort?: string;
+    };
+    followup(message: unknown): void;
+    steer(message: unknown): void;
+    inject(message: unknown): void;
+    whenIdle(): Promise<void>;
+    cancel(cause: unknown, options?: {
+        keepInbox?: boolean;
+    }): void;
+}
+interface AgentHandleLike {
+    readonly agent: AgentLike;
+    dispose(): Promise<void> | void;
+}
+interface AgentsServiceLike {
+    create(options: {
+        sessionId: string;
+        meta?: Record<string, unknown>;
+        agentOptions?: Record<string, unknown>;
+        setup?: (agentCtx: unknown, agent: AgentLike) => unknown;
+    }): Promise<AgentHandleLike>;
+    /** Resume one persisted session (room sessions survive bridge restarts).
+     * NOTE: Cordis service proxies prepend the caller context automatically -
+     * call sites pass ONLY the options object (verified against dsh-acp callers). */
+    resume(options: {
+        resumeSessionId: string;
+        agentOptions?: Record<string, unknown>;
+    }): Promise<AgentHandleLike>;
+    get(id: string): AgentLike | undefined;
+}
+/** 房间 ID → 安全子目录名(pi-courier sanitizeRoomKey 同式)。 */
+export declare function sanitizeRoomDir(roomId: string): string;
+/** 文件名消毒:去路径分隔符与控制字符,限长;空回退 attachment。 */
+export declare function safeFileName(name: string | undefined): string;
+/** Structural slice of the host context this adapter consumes. */
+export interface DshContext {
+    agents: AgentsServiceLike;
+    get?(name: string): unknown;
+}
+export interface DshBackendOptions {
+    logger: Logger;
+    /** Provider/model route; omitted → the deployment's current default. */
+    provider?: string;
+    model?: string;
+    /** T6: 附件服务不可用时的兜底落盘目录(config attachments.dir ?? <dataDir>/attachments)。 */
+    attachmentsDir?: string;
+}
+export declare class DshBackend implements Backend {
+    private readonly opts;
+    private readonly handles;
+    private readonly sessions;
+    /** sessionId → roomId 归属表:T5 interactions 用它判定"这是不是桥的会话"。 */
+    private readonly sessionRoom;
+    private readonly ctx;
+    constructor(ctx: Context, opts: DshBackendOptions);
+    /** Stable, idempotent session id for a Matrix room id. */
+    static sessionIdFor(roomId: string): string;
+    /** Late-read the attachments service (profile may mount it after us). */
+    private attachmentsService;
+    private makeSession;
+    executeCommand(roomId: string, line: string): Promise<string | undefined>;
+    listPassthroughCommands(roomId: string): Promise<PassthroughCommandInfo[]>;
+    getSession(roomId: string, cwd: string): Promise<SessionHandle>;
+    peekSession(roomId: string): SessionHandle | undefined;
+    /**
+     * T11(/sessions):本进程已知的房间↔会话绑定,只读。
+     * 归属表是新增会话时写进去的(T5 也用它判定"这是不是桥的会话"),这里按
+     * roomId 排序输出,保证同一状态下列表稳定(便于人读与测试)。
+     */
+    listSessions(): Promise<SessionListEntry[]>;
+    /**
+     * T9: 放掉房间的会话句柄(dispose + 清 map),持久会话数据保留(US35)。
+     * 幂等:未开过的房间直接返回。
+     */
+    dropRoomSession(roomId: string): Promise<void>;
+    private llmService;
+    listModels(): Promise<ModelInfo[]>;
+    currentModel(roomId: string): Promise<ModelSelection | undefined>;
+    selectModel(roomId: string, provider: string, model: string, reasoningEffort?: string): Promise<ModelSelection>;
+    renameSession(roomId: string, title: string): Promise<void>;
+    listThinkingEfforts(provider: string, model: string): Promise<ThinkingEffort[]>;
+    /** 反查:该桥会话 id 属于哪个房间?非桥会话返回 undefined。(T5 归属判定) */
+    roomIdForSession(sessionId: string): string | undefined;
+    dispose(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=backend.d.ts.map

package/dist/dsh/backend.d.ts.map

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