@morlay/dsh-session-mode 0.0.1 → 0.0.3

package/src/client/SessionModeSeat.tsx

@@ -1,14 +1,6 @@
-/**
- * composer 里的模式 chip：**本包在会话里唯一的面**（点开是 coding / chat 两项）。
- *
- * 选择只在会话开始**之前**有效——一旦跑过 turn，那段历史是在某个模式的工具与提示词下产生的。所以 chip 在
- * 会话里有两个形态：空白期是选择器，开过 turn 之后**只读**（只写当前模式，点不动）。判据是 host 的投影
- * `sessionModeEditable`（`turn/start` 一落库就为 `false`），与服务端拒绝切换读的是同一份事实。
- *
- * 它挂在 composer 上：新会话屏也是一个 blank session 的 composer，选择正好发生在那里；会话头部则没有它的
- * 位置——头部只在"跑起来之后"值得看，而那时的 chip 已经把当前模式写在脸上，再挂一个只读标签就是同一句话的
- * 复读。
- */
+// composer 里的模式 chip：本包在会话里唯一的面（点开是 coding / chat 两项）。
+// 选择只在会话开始**之前**有效（那段历史属于某个模式的工具与提示词），所以 chip 有两个形态：空白期是选择器，
+// 开过 turn 之后只读。判据是 host 的投影 `sessionModeEditable`，与服务端拒绝切换读的是同一份事实。
 
 import { useState } from "react";
 import {
@@ -25,20 +17,12 @@ import { selectMode } from "./api.ts";
 import { useRoster } from "./use-roster.ts";
 import css from "./SessionModeSeat.module.css";
 
-/** 完整 props：composer 工具行左侧槽位的运行时 props + 本包的字典。 */
+// 完整 props：composer 工具行左侧槽位的运行时 props + 本包的字典。
 export type SessionModeSeatProps = PropsRuntime<"conversation.input.left"> &
   PropsLocale<"session-mode">;
 
-/**
- * 渲染 composer 里的模式切换 chip。
- *
- * 为什么在 composer（`conversation.input.left`）：**新会话屏也是一个 blank session 的 composer**，选择正好
- * 发生在那里；会话头部槽位在新会话屏根本不存在，而会话跑起来之后头部也不该重复说一遍 chip 已经写着的事。
- * 官方 roster 那个座位（`conversation.hero.agentPreset`）是单注册槽位、已被官方占了，所以用自己的 list 槽位
- * 并存。
- * @param props - 槽位合成的 props。
- * @returns chip；清单没读到、或会话未知时返回 null。
- */
+// 渲染 composer 里的模式切换 chip：新会话屏也是 blank session 的 composer，选择正好发生在那里；官方 roster 占了
+// 单注册槽位 `conversation.hero.agentPreset`，所以这里用自己的 list 槽位并存。清单没读到时会话未知时返回 null。
 export function SessionModeSeat({ sessionId, useSessions, t }: SessionModeSeatProps) {
   const roster = useRoster();
   const selected = useSessions((state) => {
@@ -63,8 +47,7 @@ export function SessionModeSeat({ sessionId, useSessions, t }: SessionModeSeatPr
   const chosen = roster.modes.find((mode) => mode.id === current);
   const label = chosen?.name ?? current;
 
-  // 开过 turn 的会话**只读**：chip 只写当前模式，点不动也不给清单。判据与 host 拒绝切换读的是同一个投影
-  // （`sessionModeEditable`），所以不会出现"看起来能选、点了报错"。
+  // 开过 turn 的会话只读：chip 只写当前模式、点不动（判据与 host 拒绝切换读的是同一个投影）。
   if (editable === false) {
     return (
       <button type="button" className={css.seat} disabled title={t("lockedHint")}>

package/src/client/api.ts

@@ -1,9 +1,5 @@
-/**
- * client 半与 host 的**唯一**通路：模式清单（`GET`）与切换（`POST`）。
- *
- * 当前模式不走这里——它是一条会话投影（`sessionMode`），随会话列表一起到页面，组件用 `useSessions`
- * 读它。于是这里只剩两件事：拉清单、发一次切换。
- */
+// client 半与 host 的**唯一**通路：模式清单（`GET`）与切换（`POST`）。当前模式是会话投影（`sessionMode`），
+// 随会话列表一起到页面，不走这里。
 
 import {
   SESSION_MODE_PATH,
@@ -11,7 +7,7 @@ import {
   type SessionModeSelectResult,
 } from "../shared.ts";
 
-/** 读一次模式清单；清单在页面生命周期里是静态的（装配事实），调用方自己缓存。 */
+// 读一次模式清单；清单在页面生命周期里是静态的（装配事实），调用方自己缓存。
 export async function fetchRoster(): Promise<SessionModeRoster> {
   const response = await fetch(SESSION_MODE_PATH, {
     method: "GET",
@@ -21,13 +17,7 @@ export async function fetchRoster(): Promise<SessionModeRoster> {
   return (await response.json()) as SessionModeRoster;
 }
 
-/**
- * 把某个空白会话切到某个模式。
- * @param sessionId - 目标会话。
- * @param mode - 目标模式 id。
- * @returns 提交后的模式 id。
- * @throws 会话已开始、模式不存在、会话不存在——host 给的中文原因。
- */
+// 把某个空白会话切到某个模式；失败抛 host 给的中文原因（会话已开始 / 模式不存在 / 会话不存在）。
 export async function selectMode(sessionId: string, mode: string): Promise<string> {
   const response = await fetch(SESSION_MODE_PATH, {
     method: "POST",

package/src/client/index.ts

@@ -1,49 +1,40 @@
-/**
- * client 半：会话里那一个面（模式 chip）+ 设置页里那张「会话模式」卡片。
- *
- * | 槽位                      | 呈现                                                |
- * | ------------------------- | --------------------------------------------------- |
- * | `conversation.input.left` | chip——点开就是切换列表（新会话屏也是一个 composer）  |
- *
- * 官方 `@deepseek-ai/dsh-client-ui-agent-preset` 保留（它提供 preset 的选择面与设置页 roster）：官方管"挂哪套
- * 行"，我们管"会话级扩展"，两套入口并存、互不遮挡。
- *
- * 头部的只读标签**没有**：chip 本来就把当前模式写在脸上（会话与新会话屏都有 composer），右上角再写一遍是
- * 同一句话的复读。
- *
- * 本行的配置页（各模式的默认模型 `config.models`）不再由本包画：那个字段是 volatile 的，页面由
- * `@morlay/dsh-client-ui-primitives` 按 schema 自动生成（它注册到本行的配置入口 `plugins.row.config`，
- * key = `<bundle 包名>#<行 id>`）。本包只管会话里那一个面。
- */
+// client 半：会话里那一个面（模式 chip，槽位 `conversation.input.left`，list + session scope）+ 配置页字段文案。
+// 官方 `@deepseek-ai/dsh-client-ui-agent-preset` 保留（官方管"挂哪套行"，我们管"会话级扩展"，两套入口并存）；
+// 本行的配置页由 `@morlay/dsh-client-ui-primitives` 按 schema 自动生成，key = `<bundle 包名>#<行 id>`。
 
 import type { Context } from "@deepseek-ai/cordis";
 // Type-only：`ctx.remote` 的合并面（选模型的候选来自 LLM 目录）。
 import type {} from "@deepseek-ai/dsh-api-remotes/client";
 import type {} from "@deepseek-ai/dsh-client-locale/client";
 import type {} from "@deepseek-ai/dsh-client-ui-slots";
-
 // Type-only：槽位声明与 standard props（session / session-maybe / global）。
 import type {} from "@morlay/dsh-client-ui-conversation/client";
+import { POLICY_NAMES } from "../shared.ts";
 import { SessionModeSeat } from "./SessionModeSeat.tsx";
 import { en, zh, type SessionModeLocaleKey } from "./locales.ts";
 
 declare module "@deepseek-ai/dsh-client-ui-slots" {
   interface LocaleNamespaceMap {
-    /** 会话里两个面的文案（配置页文案在通用 schema 表单的字典里）。 */
+    // 会话里两个面的文案（配置页文案在通用 schema 表单的字典里）。
     "session-mode": SessionModeLocaleKey;
   }
 }
 
-/** 浏览器半插件的字典命名空间。 */
+// 浏览器半插件的字典命名空间。
 const NS = "session-mode";
 
-/** 这一行里需要中文文案的字段（都在 `modes.<模式>.defaultModel` 里，所以按模板路径注册一次）。 */
+// 这一行里需要中文文案的字段（都在 `modes.<模式>.defaultModel` 里，所以按模板路径注册一次）。
 const FIELDS = ["provider", "model", "reasoningEffort"] as const;
 
-/** 动态键的占位段（与通用表单的字段树同一约定）。 */
+// 两份 policy 名单的字段名（`modes.<模式>.<字段>`）：它们在 schema 上是**字符串数组**（`z.array(z.string())`，没有
+// enum），候选值由本文件登记的封闭名单 `POLICY_NAMES` 给（见下面 `hints.select` 那一段）——所以两条已知 policy
+// 都以"未配置"的形态各占一项可选，页面把每一项画成选择器。
+const POLICY_FIELDS = ["allowPolicies", "denyPolicies"] as const;
+
+// 动态键的占位段（与通用表单的字段树同一约定）。
 const DYNAMIC = "*";
 
-/** 一个可配置 provider 的候选信息：显示名 + 它的配置在哪（模型清单从那份配置里读）。 */
+// 一个可配置 provider 的候选信息：显示名 + 它的配置在哪（模型清单从那份配置里读）。
 interface ProviderEntry {
   value: string;
   label: string;
@@ -54,13 +45,13 @@ interface ProviderEntry {
 export type { SessionModeSeatProps } from "./SessionModeSeat.tsx";
 export type { SessionModeLocaleKey } from "./locales.ts";
 
-/** 需要的服务：槽位与字典（会话列表经槽位的标准 props 到达组件，不必自己 inject）。 */
+// 需要的服务：槽位与字典（会话列表经槽位的标准 props 到达组件，不必自己 inject）。
 export const inject = ["slots", "locale"];
 
-/** 本包 host 行 id：行配置页读的就是这个命名空间。 */
+// 本包 host 行 id：行配置页读的就是这个命名空间。
 export const SESSION_MODE_NS = "session-mode";
 
-/** 按路径读一段配置里的值（本包只读 provider 档案里的模型清单）。 */
+// 按路径读一段配置里的值（本包只读 provider 档案里的模型清单）。
 function readAt(root: unknown, path: readonly string[]): unknown {
   return path.reduce<unknown>((node, segment) => {
     if (Array.isArray(node)) return node[Number(segment)];
@@ -69,11 +60,7 @@ function readAt(root: unknown, path: readonly string[]): unknown {
   }, root);
 }
 
-/**
- * 装上会话里的两个面，以及本行配置页的字段文案。
- *
- * @param ctx - 浏览器插件上下文。
- */
+// 装上会话里的那一个面，以及本行配置页的字段文案。
 export function apply(ctx: Context): void {
   const t = ctx.locale.bind(NS);
   ctx.effect(() => ctx.locale.register(NS, { zh, en }), "session-mode: dictionaries");
@@ -95,6 +82,22 @@ export function apply(ctx: Context): void {
     }, "session-mode: field wording"),
   );
 
+  // 两份 policy 名单是**字符串数组**，键的候选是一份封闭名单（上游 waterfall 名，见 `shared.ts` 的
+  // `POLICY_NAMES`）：在数组**项**那一路径上登记候选值，页面因此把每一项画成选择器，两条已知 policy 直接可选
+  // （不必手写名字）。名单住在 `shared.ts`——client 半不 import `modes.ts`（免得把 schemastery 拖进浏览器包）。
+  ctx.inject(["schemaFormHints"], (scope) =>
+    scope.effect(() => {
+      const offs = POLICY_FIELDS.map((key) =>
+        scope.schemaFormHints.select(SESSION_MODE_NS, ["modes", DYNAMIC, key, DYNAMIC], {
+          options: () => POLICY_NAMES.map((value) => ({ value })),
+        }),
+      );
+      return () => {
+        for (const off of offs) off();
+      };
+    }, "session-mode: policy candidates"),
+  );
+
   // 选模型的候选不在本行的 schema 里：provider 是部署里的 LLM 目录（活着的路由 + 可配置声明），模型清单读那份声明
   // 指向的配置（`settingsNs` / `settingsPath`）。目录异步取到后注册——注册本身就是一次变更通知。
   ctx.inject(["schemaFormHints"], (scope) =>

package/src/client/locales.ts

@@ -1,9 +1,5 @@
-/**
- * client 半的文案：命名空间 `session-mode`（与 locale 注册时用的 key 一致）。
- *
- * 只有会话里那个模式 chip 用这份字典：模式的名字与说明由 host 的清单给（那是数据，不是文案）。本行的配置页
- * （各模式的默认模型）由通用 schema 表单渲染，文案在它自己的字典里。
- */
+// client 半的文案：命名空间 `session-mode`（与 locale 注册时用的 key 一致）。模式的名字与说明由 host 的清单给
+// （那是数据，不是文案）；本行配置页的文案在通用 schema 表单自己的字典里。
 
 export const zh = {
   seatHint: "选择这个会话的模式",

package/src/client/use-roster.ts

@@ -2,13 +2,11 @@ import { useEffect, useState } from "react";
 import type { SessionModeRoster } from "../shared.ts";
 import { fetchRoster } from "./api.ts";
 
-/**
- * 模块级缓存：清单是装配事实（`session-mode` 行的 config），页面生命周期里不会变，两次挂载之间不必重拉。
- * 失败不缓存——下次挂载就是一次重试。
- */
+// 模块级缓存：清单是装配事实（`session-mode` 行的 config），页面生命周期里不会变，两次挂载之间不必重拉。
+// 失败不缓存——下次挂载就是一次重试。
 let pending: Promise<SessionModeRoster> | undefined;
 
-/** 读模式清单；还没读到（或读失败）时返回 undefined，组件据此不渲染。 */
+// 读模式清单；还没读到（或读失败）时返回 undefined，组件据此不渲染。
 export function useRoster(): SessionModeRoster | undefined {
   const [roster, setRoster] = useState<SessionModeRoster | undefined>(undefined);
   useEffect(() => {