paseo-dsh-direct 0.2.7 → 0.2.9

package/OVERVIEW.md

@@ -18,8 +18,9 @@ Runs DeepSeek Harness (`dsh`) as a native Paseo agent provider. Paseo clients (d
 ## Processes and environment
 
 - **Child process.** For each session the plugin starts the `dsh` executable as a child process and loads a small bridge plugin into it. The two communicate over the child's stdio.
-- **Executable lookup.** In order: the `PASEO_DSH_EXECUTABLE` environment variable, then the Paseo setting `agents.providers.dsh-pi.command`, then `dsh` on `PATH`.
-- **Profile.** The plugin launches `dsh --profile paseo`. If `<DSH_HOME>/profiles/paseo` does not exist, it is created once by running `dsh --profile paseo --from-default-profile web --dump-config`. `DSH_HOME` defaults to `~/.dsh`. Setting `PASEO_DSH_PROFILE` selects another existing profile instead; a missing one is reported as an error, not created.
+- **Executable lookup.** In order: the `PASEO_DSH_EXECUTABLE` environment variable, the executable field of the DeepSeek Harness settings screen, the Paseo setting `agents.providers.dsh-pi.command`, then `dsh` on `PATH`.
+- **Profile.** The plugin launches `dsh --profile paseo`. If `<DSH_HOME>/profiles/paseo` does not exist, it is created once by running `dsh --profile paseo --from-default-profile web --dump-config`. `DSH_HOME` defaults to `~/.dsh`. Setting `PASEO_DSH_PROFILE`, or the profile field of the DeepSeek Harness settings screen (the variable wins), selects another existing profile instead; a missing one is reported as an error, not created.
 - **Environment variables read by the plugin.** `PASEO_DSH_EXECUTABLE`, `PASEO_DSH_PROFILE`, and `DSH_HOME` (to locate the profile directory).
+- **Settings screen.** Executable and profile can also be set under Settings → DeepSeek Harness; changes apply to new sessions.
 - **Environment passed to `dsh`.** The child inherits the Paseo daemon's environment.
 - **Network.** The plugin makes no network requests itself. Model API calls are made by `dsh` according to its own configuration.

package/README.md

@@ -33,6 +33,7 @@ Most dsh integrations go through ACP, a generic protocol that every agent can sp
 - Your existing dsh sessions can be imported and resumed in Paseo.
 - dsh's slash commands (`/compact`, `/plan`, ...) appear in Paseo's `/` menu.
 - Paseo's usage meter shows dsh's token counts and how full the context window is.
+- Goal changes, plan mode switches and permission preset changes show up in the conversation as small timeline cards.
 
 ## Versioning
 
@@ -44,7 +45,7 @@ Create a conversation with the **DeepSeek Harness** provider. Models and presets
 
 The provider supports streamed assistant and reasoning output, tool execution and approval, user questions, model/preset configuration, interruption, and session recovery. It starts DSH with its own `paseo` profile and does not modify Paseo or DSH core.
 
-The plugin uses the DSH profile `paseo`. On first start it creates that profile from DSH's official `web` template (`~/.dsh/profiles/paseo`, or under `$DSH_HOME` when set). Model routes, the default model, and permission presets go in `~/.dsh/profiles/paseo/cordis.patch.yml`. To use a different `dsh` executable, set `agents.providers.dsh-pi.command` in the Paseo configuration or `PASEO_DSH_EXECUTABLE` (which takes precedence); or `PASEO_DSH_PROFILE` to use another existing profile; a profile named there is not created automatically. If the Paseo Daemon has plugin loading disabled, enable `pluginsEnabled` in its configuration before installing the plugin.
+The plugin uses the DSH profile `paseo`. On first start it creates that profile from DSH's official `web` template (`~/.dsh/profiles/paseo`, or under `$DSH_HOME` when set). Model routes, the default model, and permission presets go in `~/.dsh/profiles/paseo/cordis.patch.yml`. The executable and the profile can be set on the **DeepSeek Harness** screen in Paseo's settings (fields `dsh executable` and `dsh profile`). The executable is chosen in this order: `PASEO_DSH_EXECUTABLE`, the settings screen, `agents.providers.dsh-pi.command` in the Paseo configuration, then `dsh` on `PATH`. The profile is chosen from `PASEO_DSH_PROFILE`, then the settings screen, then `paseo`; a profile named explicitly is not created automatically. Changed settings apply to new sessions; running sessions keep their `dsh`. If the Paseo Daemon has plugin loading disabled, enable `pluginsEnabled` in its configuration before installing the plugin.
 
 If a native session is still held by another DSH client (such as a terminal UI), release it there before importing or resuming it from Paseo.
 

package/README.zh.md

@@ -33,6 +33,7 @@ paseo plugin update paseo-dsh-direct --yes     # 更新到最新
 - 已有的 dsh 会话可以导入 Paseo 接着用。
 - dsh 的斜杠命令（`/compact`、`/plan` 等）出现在 Paseo 的 `/` 菜单里。
 - Paseo 的用量表显示 dsh 的 token 用量和上下文占用。
+- 目标变化、计划模式切换和权限预设变化会在对话里显示为小的时间线卡片。
 
 ## 版本号
 
@@ -44,7 +45,7 @@ paseo plugin update paseo-dsh-direct --yes     # 更新到最新
 
 Provider 支持连续正文和思考输出、工具执行与审批、用户问答、模型和 preset 配置、中断及会话恢复。它用插件专用的 `paseo` profile 启动 DSH，不修改 Paseo 或 DSH 核心。
 
-插件使用名为 `paseo` 的 DSH profile。首次启动时，插件用 DSH 官方的 `web` 模板自动创建它（位置是 `~/.dsh/profiles/paseo`；设置了 `$DSH_HOME` 时在其下）。模型路由、默认模型和权限预设写在 `~/.dsh/profiles/paseo/cordis.patch.yml`。可在 Paseo 配置的 `agents.providers.dsh-pi.command` 或 `PASEO_DSH_EXECUTABLE`（后者优先）指定其他 `dsh` 可执行文件，通过 `PASEO_DSH_PROFILE` 改用另一个已存在的 profile；这样指定的 profile 不会被自动创建。如果 Paseo Daemon 默认关闭插件加载，请先在配置中启用 `pluginsEnabled`。
+插件使用名为 `paseo` 的 DSH profile。首次启动时，插件用 DSH 官方的 `web` 模板自动创建它（位置是 `~/.dsh/profiles/paseo`；设置了 `$DSH_HOME` 时在其下）。模型路由、默认模型和权限预设写在 `~/.dsh/profiles/paseo/cordis.patch.yml`。可在 Paseo 设置里的 **DeepSeek Harness** 页（`dsh executable`、`dsh profile` 两项）指定可执行文件与 profile。可执行文件的选择顺序：`PASEO_DSH_EXECUTABLE`、设置页、Paseo 配置的 `agents.providers.dsh-pi.command`、`PATH` 里的 `dsh`。profile 的选择顺序：`PASEO_DSH_PROFILE`、设置页、默认的 `paseo`；显式指定的 profile 不会被自动创建。改动对新会话生效，已在运行的会话继续使用原来的 `dsh`。如果 Paseo Daemon 默认关闭插件加载，请先在配置中启用 `pluginsEnabled`。
 
 如果原生会话仍被另一个 DSH 客户端（如终端界面）占用，请先在那里释放，再从 Paseo 导入或恢复。
 

package/client/settings-screen.tsx

@@ -0,0 +1,101 @@
+import { useSettings } from "@getpaseo/plugin/client";
+import { ScrollView } from "@getpaseo/plugin/client/react-native";
+import { SettingsAction, SettingsInput, SettingsRow, SettingsSection } from "@getpaseo/plugin/client/ui";
+import { useRef } from "react";
+import { DSH_SETTINGS } from "../shared/settings.js";
+
+const EXECUTABLE_HINT =
+  "Path or command of dsh. PASEO_DSH_EXECUTABLE overrides this; leave it empty to use the Paseo provider command or dsh on PATH. Changes apply to new sessions.";
+const PROFILE_HINT =
+  'Name of the dsh profile to launch. PASEO_DSH_PROFILE overrides this; leave it empty to use the "paseo" profile. Changes apply to new sessions.';
+
+/** Edits the dsh executable and profile that the server reads when it launches a bridge. */
+export default function DshSettingsScreen() {
+  const settings = useSettings(DSH_SETTINGS);
+  const draftState = useRef<{ revision: string | undefined; edits: { executable?: string; profile?: string } }>({
+    revision: undefined,
+    edits: {},
+  });
+
+  if (settings.status === "loading") {
+    return (
+      <ScrollView>
+        <SettingsSection title="DeepSeek Harness">
+          <SettingsRow label="Loading settings" />
+        </SettingsSection>
+      </ScrollView>
+    );
+  }
+  if (settings.status === "error") {
+    return (
+      <ScrollView>
+        <SettingsSection title="DeepSeek Harness">
+          <SettingsRow label="Settings unavailable" error={settings.error} />
+          <SettingsAction label="Retry" actionLabel="Retry" onPress={() => void settings.reload()} />
+        </SettingsSection>
+      </ScrollView>
+    );
+  }
+  if (settings.status === "invalid") {
+    return (
+      <ScrollView>
+        <SettingsSection title="DeepSeek Harness">
+          <SettingsRow label="Stored settings are invalid" error={settings.error} hint="They are ignored until you reset them." />
+          <SettingsAction label="Reset" actionLabel="Reset" onPress={() => void settings.reset()} disabled={settings.saving} />
+        </SettingsSection>
+      </ScrollView>
+    );
+  }
+
+  const { revision, values } = settings;
+  // Edits belong to the revision they were typed against; a new revision remounts the inputs, so drop them.
+  if (draftState.current.revision !== revision) {
+    draftState.current = { revision, edits: {} };
+  }
+  const draft = { current: draftState.current.edits };
+  const save = () =>
+    void settings.save(
+      {
+        executable: draft.current.executable ?? values.executable ?? "",
+        profile: draft.current.profile ?? values.profile ?? "",
+      },
+      revision,
+    );
+
+  return (
+    <ScrollView>
+      <SettingsSection title="DeepSeek Harness">
+        <SettingsInput
+          key={`executable-${revision}`}
+          label="dsh executable"
+          hint={EXECUTABLE_HINT}
+          placeholder="dsh"
+          initialValue={values.executable ?? ""}
+          onChangeText={(text) => {
+            draft.current.executable = text;
+          }}
+          disabled={settings.saving}
+        />
+        <SettingsInput
+          key={`profile-${revision}`}
+          label="dsh profile"
+          hint={PROFILE_HINT}
+          placeholder="paseo"
+          initialValue={values.profile ?? ""}
+          onChangeText={(text) => {
+            draft.current.profile = text;
+          }}
+          disabled={settings.saving}
+        />
+        <SettingsAction
+          label="Save"
+          hint={settings.saveError ?? undefined}
+          error={settings.saveError}
+          actionLabel={settings.saving ? "Saving" : "Save"}
+          onPress={save}
+          disabled={settings.saving}
+        />
+      </SettingsSection>
+    </ScrollView>
+  );
+}

package/client/timeline-cards.tsx

@@ -0,0 +1,50 @@
+import { SettingsRow } from "@getpaseo/plugin/client/ui";
+import {
+  type GoalCard,
+  type PermissionPresetCard,
+  type PlanModeCard,
+} from "../shared/timeline-cards.js";
+
+interface CardProps<Data> {
+  item: { data: Data };
+}
+
+/** Text of a goal card. */
+function goalCardText(data: GoalCard): string {
+  const objective = data.objective ? `: ${data.objective}` : "";
+  switch (data.operation) {
+    case "create":
+      return `Goal set${objective}`;
+    case "edit":
+      return `Goal edited${objective}`;
+    case "pause":
+      return "Goal paused";
+    case "resume":
+      return "Goal resumed";
+    case "complete":
+      return "Goal completed";
+    case "block":
+      return data.reason ? `Goal blocked: ${data.reason}` : "Goal blocked";
+    case "clear":
+      return "Goal cleared";
+    case "continue": {
+      const round = data.round === undefined ? "" : ` (round ${data.round}${data.maxRounds === undefined ? "" : `/${data.maxRounds}`})`;
+      return `Goal continued${round}`;
+    }
+  }
+}
+
+/** One-row card for a plan mode switch. */
+export function PlanModeCardView({ item }: CardProps<PlanModeCard>) {
+  return <SettingsRow label={item.data.active ? "Plan mode on" : "Plan mode off"} />;
+}
+
+/** One-row card for a permission preset change. */
+export function PermissionPresetCardView({ item }: CardProps<PermissionPresetCard>) {
+  return <SettingsRow label={`Permission preset: ${item.data.preset}`} />;
+}
+
+/** One-row card for a goal change or an automatic goal round. */
+export function GoalCardView({ item }: CardProps<GoalCard>) {
+  return <SettingsRow label={goalCardText(item.data)} />;
+}

package/index.client.tsx

@@ -1,6 +1,48 @@
 import type { PluginClientContext } from "@getpaseo/plugin/client";
+import { SETTINGS_SCREEN_ICON } from "./shared/settings.js";
+import DshSettingsScreen from "./client/settings-screen.js";
+import {
+  GoalCardView,
+  PermissionPresetCardView,
+  PlanModeCardView,
+} from "./client/timeline-cards.js";
+import {
+  CARD_KINDS,
+  CARD_VERSION,
+  goalCardSchema,
+  permissionPresetCardSchema,
+  planModeCardSchema,
+} from "./shared/timeline-cards.js";
 
-/** Provider presentation is supplied by the server registration and its SVG asset. */
-export default function contribute(_client: PluginClientContext) {
-  return () => {};
+/** Provider presentation comes from the server registration; the client adds the dsh settings screen and timeline cards. */
+export default function contribute(client: PluginClientContext) {
+  const cleanups = [
+    client.addSettingsScreen({
+      id: "dsh",
+      title: "DeepSeek Harness",
+      icon: SETTINGS_SCREEN_ICON,
+      Component: DshSettingsScreen,
+    }),
+    client.addTimelineRenderer({
+      kind: CARD_KINDS.planMode,
+      version: CARD_VERSION,
+      schema: planModeCardSchema,
+      Component: PlanModeCardView,
+    }),
+    client.addTimelineRenderer({
+      kind: CARD_KINDS.permissionPreset,
+      version: CARD_VERSION,
+      schema: permissionPresetCardSchema,
+      Component: PermissionPresetCardView,
+    }),
+    client.addTimelineRenderer({
+      kind: CARD_KINDS.goal,
+      version: CARD_VERSION,
+      schema: goalCardSchema,
+      Component: GoalCardView,
+    }),
+  ];
+  return async () => {
+    await Promise.all(cleanups.map((cleanup) => cleanup()));
+  };
 }

package/index.server.ts

@@ -1,22 +1,23 @@
 import type { PluginServerContext } from "@getpaseo/plugin/server";
+import { DSH_SETTINGS } from "./shared/settings.js";
 import { launchDshBridge } from "./server/bridge-client.js";
+import { currentDshConfigured } from "./server/dsh-config.js";
 import { defaultDshCommand } from "./server/dsh-spawn.js";
 import { DSH_BRIDGE_SOURCE } from "./server/generated-bridge.js";
 import { createDshProvider } from "./server/provider.js";
 
 export default function contribute(server: PluginServerContext) {
-  const executable = process.env.PASEO_DSH_EXECUTABLE;
+  const settings = server.registerSettings(DSH_SETTINGS);
+  // Read per call, not once: a changed setting applies to new sessions and new catalog discovery.
+  const configured = () => currentDshConfigured(process.env, settings);
   server.registerProvider(
     createDshProvider({
-      executable,
+      configured,
       command: defaultDshCommand(process.env),
-      createBridge: (launch) =>
-        launchDshBridge({
-          ...launch,
-          bridgeSource: DSH_BRIDGE_SOURCE,
-          executable,
-          profile: process.env.PASEO_DSH_PROFILE,
-        }),
+      createBridge: async (launch) => {
+        const { executable, profile } = await configured();
+        return launchDshBridge({ ...launch, bridgeSource: DSH_BRIDGE_SOURCE, executable, profile });
+      },
     }),
   );
   return () => {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paseo-dsh-direct",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "DeepSeek Harness Direct Provider Plugin for Paseo",
   "repository": {
     "type": "git",
@@ -19,6 +19,7 @@
     "index.server.ts",
     "index.client.tsx",
     "server",
+    "client",
     "shared",
     "scripts/build.mjs",
     "scripts/install-lefthook.mjs",
@@ -27,14 +28,16 @@
     "dsh.png",
     "OVERVIEW.md",
     "!server/**/*.test.ts",
+    "!client/**/*.test.ts",
     "!server/generated-bridge.ts",
     "!server/generated-version.ts"
   ],
   "peerDependencies": {
-    "@getpaseo/client": "0.11.2",
-    "@getpaseo/protocol": "0.11.2",
+    "@getpaseo/client": "0.12.0",
+    "@getpaseo/protocol": "0.12.0",
     "react": "~19.1.0",
-    "react-native": ">=0.81.5"
+    "react-native": ">=0.81.5",
+    "zod": "^4.4.3"
   },
   "peerDependenciesMeta": {
     "@getpaseo/client": {
@@ -48,12 +51,16 @@
     },
     "react-native": {
       "optional": true
+    },
+    "zod": {
+      "optional": true
     }
   },
   "devDependencies": {
-    "@getpaseo/plugin": "0.11.2",
+    "@getpaseo/plugin": "0.12.0",
     "@types/mdast": "^4.0.4",
     "@types/node": "^24.0.0",
+    "@types/react": "~19.2.0",
     "esbuild": "^0.25.0",
     "lefthook": "^2.1.9",
     "mdast-util-from-markdown": "^2.0.3",

package/server/bridge-client.ts

@@ -62,7 +62,7 @@ export interface SessionLaunch {
 }
 
 export interface LaunchBridgeOptions extends SessionLaunch {
-  /** The `PASEO_DSH_EXECUTABLE` value; it takes precedence over `providerLaunch.command`. */
+  /** The configured executable (`PASEO_DSH_EXECUTABLE`, else the plugin setting); it takes precedence over `providerLaunch.command`. */
   executable?: string;
   profile?: string;
   bridgeSource: string;
@@ -77,7 +77,7 @@ interface PendingRequest {
 
 const MAX_STDERR = 16_384;
 
-/** The profile the plugin launches unless `PASEO_DSH_PROFILE` names another one. */
+/** The profile the plugin launches unless `PASEO_DSH_PROFILE` or the plugin setting names another one. */
 export const DEFAULT_PROFILE = "paseo";
 /** The official DSH profile template the default profile is created from. */
 export const DEFAULT_PROFILE_TEMPLATE = "web";
@@ -142,7 +142,7 @@ export async function ensureDshProfile(options: {
     throw new Error(
       `DSH profile "${options.profile}" does not exist at ${directory}. ` +
         `Create it with \`dsh --profile ${options.profile} --from-default-profile ${DEFAULT_PROFILE_TEMPLATE} --dump-config\`, ` +
-        `or unset PASEO_DSH_PROFILE to use the "${DEFAULT_PROFILE}" profile.`,
+        `or clear the profile in the DeepSeek Harness plugin settings and unset PASEO_DSH_PROFILE to use the "${DEFAULT_PROFILE}" profile.`,
     );
   }
   // Concurrent first launches share one creation run.
@@ -222,8 +222,8 @@ export interface DshLaunch {
 }
 
 /**
- * The dsh launch, by precedence: a non-blank `PASEO_DSH_EXECUTABLE` (the most
- * specific signal, kept for existing installs), then the `launch` Paseo
+ * The dsh launch, by precedence: a non-blank configured executable (`PASEO_DSH_EXECUTABLE`,
+ * else the plugin setting; see `mergeDshConfigured`), then the `launch` Paseo
  * resolved from `command` / `agents.providers.dsh-pi.command`, then `dsh` from
  * `PATH`. `launch.args` belong to `launch.command`, so they are dropped when
  * the environment variable wins.

package/server/dsh-config.ts

@@ -0,0 +1,65 @@
+/** The dsh launch choices that outrank Paseo's own `launch` and the built-in defaults. */
+export interface DshConfigured {
+  /** A non-blank dsh executable, or undefined when neither the environment nor the settings name one. */
+  executable?: string;
+  /** A non-blank profile name, or undefined to use the default profile. */
+  profile?: string;
+}
+
+/** The two values of the plugin settings screen; blank means unset. */
+export interface DshSettingsValues {
+  executable?: string;
+  profile?: string;
+}
+
+const nonBlank = (value: string | undefined): string | undefined => value?.trim() || undefined;
+
+/**
+ * Merges the environment and the settings screen: a non-blank
+ * `PASEO_DSH_EXECUTABLE` / `PASEO_DSH_PROFILE` wins over the setting of the
+ * same name. The result is then resolved against Paseo's `launch` and the
+ * default profile by `resolveDshLaunch` and `launchDshBridge`.
+ */
+export function mergeDshConfigured(
+  env: Readonly<Record<string, string | undefined>>,
+  settings: DshSettingsValues | undefined,
+): DshConfigured {
+  const executable = nonBlank(env.PASEO_DSH_EXECUTABLE) ?? nonBlank(settings?.executable);
+  const profile = nonBlank(env.PASEO_DSH_PROFILE) ?? nonBlank(settings?.profile);
+  return { ...(executable ? { executable } : {}), ...(profile ? { profile } : {}) };
+}
+
+/** The slice of `PluginSettings.read()` this module needs. */
+export interface DshSettingsSource {
+  read(): Promise<
+    | { status: "ready"; values: DshSettingsValues }
+    | { status: "invalid"; error: string }
+    | { status: "error"; error: string }
+  >;
+}
+
+/**
+ * Reads the current settings. Invalid or unreadable settings count as unset,
+ * with one line on stderr, so a bad setting never blocks launching dsh.
+ */
+export async function readDshSettings(
+  source: DshSettingsSource,
+  warn: (line: string) => void = (line) => process.stderr.write(`${line}\n`),
+): Promise<DshSettingsValues | undefined> {
+  const state = await source.read().catch((error: unknown) => ({
+    status: "error" as const,
+    error: error instanceof Error ? error.message : String(error),
+  }));
+  if (state.status === "ready") return state.values;
+  warn(`[paseo-dsh-direct] ignoring the dsh plugin settings (${state.status}): ${state.error}`);
+  return undefined;
+}
+
+/** The configuration the provider uses right now: environment first, then the current settings. */
+export async function currentDshConfigured(
+  env: Readonly<Record<string, string | undefined>>,
+  source: DshSettingsSource,
+  warn?: (line: string) => void,
+): Promise<DshConfigured> {
+  return mergeDshConfigured(env, await readDshSettings(source, warn));
+}

package/server/provider.ts

@@ -25,6 +25,7 @@ import type {
 } from "../shared/bridge-protocol.js";
 import { slashLine } from "../shared/bridge-protocol.js";
 import {
+  DEFAULT_PROFILE,
   describeDshLaunch,
   resolveDshLaunch,
   type BridgeMcpServer,
@@ -32,6 +33,7 @@ import {
   type DshLaunch,
   type SessionLaunch,
 } from "./bridge-client.js";
+import type { DshConfigured } from "./dsh-config.js";
 import { detectDshVersion } from "./dsh-version.js";
 import { PLUGIN_VERSION } from "./plugin-version.js";
 import { displayText, toPromptParts } from "./prompt-content.js";
@@ -50,6 +52,7 @@ const CAPABILITIES = [
   "session.persistence",
   "permission",
   "permission.tool_policy",
+  "timeline.plugin",
 ] as const;
 const PERMISSION_PRESET_SETTING = "permissionPreset";
 const PLAN_MODE_SETTING = "planMode";
@@ -61,8 +64,12 @@ type DetectVersion = (
 
 interface DshProviderOptions {
   createBridge(launch?: SessionLaunch): Promise<DshBridge>;
-  /** The `PASEO_DSH_EXECUTABLE` value; it outranks the `launch` Paseo resolves. `status()` and `createBridge` use the same precedence. */
-  executable?: string;
+  /**
+   * The environment and settings-screen choices, read on every call so a changed
+   * setting applies to new sessions. The executable outranks the `launch` Paseo
+   * resolves; `status()`, the catalog cache key and `createBridge` use the same values.
+   */
+  configured?: () => Promise<DshConfigured> | DshConfigured;
   /** The command registered with Paseo; defaults to `dsh` (see `defaultDshCommand`). */
   command?: string;
   /** Detects the local dsh version for the startup compatibility check; defaults to spawning `<exe> --version`. */
@@ -103,12 +110,16 @@ export function createDshProvider(options: DshProviderOptions): ProviderRegistra
     label: "DeepSeek Harness",
     description: "Direct connection to the local DeepSeek Harness (dsh)",
     icon: "dsh.svg",
-    getCatalogCacheKey: async (options) =>
-      options.scope === "workspace" ? `dsh-pi:${options.cwd}` : "dsh-pi:global",
+    getCatalogCacheKey: async (request) => {
+      const configured = (await options.configured?.()) ?? {};
+      const launch = describeDshLaunch(resolveDshLaunch(configured.executable, request.launch));
+      const scope = request.scope === "workspace" ? request.cwd : "global";
+      return JSON.stringify(["dsh-pi", scope, launch, configured.profile ?? DEFAULT_PROFILE]);
+    },
     command: [options.command ?? "dsh"],
     async status(request) {
       return dshStatus(
-        resolveDshLaunch(options.executable, request?.launch),
+        resolveDshLaunch((await options.configured?.())?.executable, request?.launch),
         request?.launch?.env,
         options.detectDshVersion ?? detectDshVersion,
       );
@@ -153,7 +164,7 @@ async function dshStatus(
       available: false,
       diagnostic:
         `Could not run "${describeDshLaunch(launch)} --version". Install dsh, ` +
-        `set agents.providers.dsh-pi.command in Paseo config, or set PASEO_DSH_EXECUTABLE, ` +
+        `set agents.providers.dsh-pi.command in Paseo config, set the executable in the DeepSeek Harness plugin settings, or set PASEO_DSH_EXECUTABLE, ` +
         `then restart the Paseo daemon.`,
     };
   }
@@ -458,7 +469,7 @@ async function openSession(
       open: opened,
       bridge,
       releaseBridgeListeners: [],
-      projector: new TimelineProjector(input.sessionId),
+      projector: new TimelineProjector(input.sessionId, state.capabilities.includes("timeline.plugin")),
       activeTurnId: null,
       cancelRequested: false,
       dispatch: null,
@@ -494,6 +505,8 @@ async function openSession(
     for (const event of session.open.events) {
       for (const projected of session.projector.projectEvent(event)) state.emit(projected);
     }
+  } else {
+    session.projector.seed(session.open.events);
   }
   await warnOnDshVersionMismatch(session, state);
   state.emit({ type: "session.ready", requestId: input.requestId, sessionId: input.sessionId });

package/server/timeline.ts

@@ -4,6 +4,12 @@ import type {
   ProviderToolCallDetail,
 } from "@getpaseo/plugin/server/provider";
 import type { DshSessionEvent, DshStreamFrame, JsonObject } from "../shared/bridge-protocol.js";
+import {
+  CARD_KINDS,
+  CARD_VERSION,
+  PLUGIN_ID,
+  type GoalCard,
+} from "../shared/timeline-cards.js";
 import { attachmentLabel } from "./prompt-content.js";
 import { classifyTurnEnd } from "./turn-end.js";
 import { arrayValue, numberValue, objectValue, stringValue } from "./values.js";
@@ -26,7 +32,27 @@ export class TimelineProjector {
     { attemptId: string; ordinal: number }
   >();
 
-  constructor(private readonly paseoSessionId: string) {}
+  private planActive = false;
+  private lastPreset: string | undefined;
+  private readonly goals = new Map<string, { objective?: string; maxRounds?: number }>();
+
+  /**
+   * @param paseoSessionId Paseo session id stamped on every projected event.
+   * @param pluginCards Whether the host negotiated `timeline.plugin`; when false no cards are emitted.
+   */
+  constructor(
+    private readonly paseoSessionId: string,
+    private readonly pluginCards = false,
+  ) {}
+
+  /**
+   * Records plan mode, permission preset and goal objectives from history that is
+   * not replayed, so the first live change is compared against the right value.
+   * @param events DSH durable events of the resumed session, oldest first.
+   */
+  seed(events: readonly DshSessionEvent[]): void {
+    for (const event of events) this.projectCards(event);
+  }
 
   projectEvent(
     event: DshSessionEvent,
@@ -35,7 +61,14 @@ export class TimelineProjector {
     const timestamp = toTimestamp(event.time);
     switch (event.type) {
       case "user/message":
-        return this.projectUserMessage(event, timestamp);
+        return [
+          ...this.projectCards(event, timestamp),
+          ...this.projectUserMessage(event, timestamp),
+        ];
+      case "plan/mode":
+      case "permission/preset":
+      case "goal/change":
+        return this.projectCards(event, timestamp);
       case "command/run":
         return this.projectCommandRun(event, options.clientMessageId, timestamp);
       case "command/done":
@@ -208,6 +241,75 @@ export class TimelineProjector {
     return projected;
   }
 
+  /** Updates card state for `event` and returns the plugin cards it produces (none when cards are off). */
+  private projectCards(event: DshSessionEvent, timestamp?: string): SessionEvent[] {
+    const cards: Array<{ id: string; kind: string; data: Record<string, string | number | boolean> }> = [];
+    const data = event.data;
+    if (event.type === "plan/mode" && typeof data.active === "boolean") {
+      if (data.active !== this.planActive) {
+        this.planActive = data.active;
+        cards.push({ id: `plan-mode:${event.seq}`, kind: CARD_KINDS.planMode, data: { active: data.active } });
+      }
+    } else if (event.type === "permission/preset" && typeof data.preset === "string") {
+      const previous = this.lastPreset;
+      this.lastPreset = data.preset;
+      if (previous !== undefined && previous !== data.preset) {
+        cards.push({ id: `permission-preset:${event.seq}`, kind: CARD_KINDS.permissionPreset, data: { preset: data.preset } });
+      }
+    } else if (event.type === "goal/change") {
+      const card = this.goalChangeCard(data);
+      if (card) cards.push({ id: `goal:${event.seq}`, kind: CARD_KINDS.goal, data: { ...card } });
+    } else if (event.type === "user/message") {
+      const source = objectValue(data.source);
+      const round = numberValue(source?.round);
+      const goalId = stringValue(source?.goalId);
+      if (source?.kind === "goal" && round !== undefined && round >= 1) {
+        const known = goalId ? this.goals.get(goalId) : undefined;
+        const card: GoalCard = {
+          operation: "continue",
+          round,
+          ...(known?.maxRounds !== undefined ? { maxRounds: known.maxRounds } : {}),
+          ...(known?.objective !== undefined ? { objective: known.objective } : {}),
+        };
+        cards.push({ id: `goal-continue:${event.seq}`, kind: CARD_KINDS.goal, data: { ...card } });
+      }
+    }
+    if (!this.pluginCards) return [];
+    return cards.map((card) =>
+      timeline(
+        this.paseoSessionId,
+        { type: "plugin", id: card.id, pluginId: PLUGIN_ID, kind: card.kind, version: CARD_VERSION, data: card.data },
+        timestamp,
+      ),
+    );
+  }
+
+  private goalChangeCard(data: JsonObject): GoalCard | undefined {
+    const operation = stringValue(data.operation);
+    if (
+      operation !== "create" && operation !== "edit" && operation !== "pause" &&
+      operation !== "resume" && operation !== "complete" && operation !== "block" &&
+      operation !== "clear"
+    ) {
+      return undefined;
+    }
+    const goal = objectValue(operation === "clear" ? data.cleared : data.goal);
+    const goalId = stringValue(goal?.id);
+    if (operation !== "clear" && goalId) {
+      this.goals.set(goalId, {
+        objective: stringValue(goal?.objective),
+        maxRounds: numberValue(goal?.maxGoalRounds),
+      });
+    }
+    const objective = stringValue(goal?.objective) ?? (goalId ? this.goals.get(goalId)?.objective : undefined);
+    const reason = operation === "block" ? stringValue(objectValue(goal?.blockedReason)?.message) : undefined;
+    return {
+      operation,
+      ...(objective !== undefined ? { objective } : {}),
+      ...(reason !== undefined ? { reason } : {}),
+    };
+  }
+
   private projectUserMessage(event: DshSessionEvent, timestamp?: string): SessionEvent[] {
     const data = event.data;
     const source = objectValue(data.source);

package/shared/settings.ts

@@ -0,0 +1,25 @@
+import { defineSettings } from "@getpaseo/plugin";
+import { z } from "zod";
+
+/**
+ * Host-scoped plugin settings for the dsh launch. Both fields are optional; an
+ * empty or whitespace-only value means unset. The server reads them when a
+ * bridge is launched, and the client settings screen edits them.
+ */
+export const DSH_SETTINGS = defineSettings({
+  id: "dsh",
+  scope: "host",
+  version: 1,
+  schema: z.object({
+    /** Path or command of the dsh executable. */
+    executable: z.string().optional(),
+    /** Name of the dsh profile the plugin launches. */
+    profile: z.string().optional(),
+  }),
+});
+
+/**
+ * Icon of the dsh settings screen. Paseo resolves plugin icons by the exact export name of
+ * `lucide-react-native` (PascalCase) and rejects the whole client contribution otherwise.
+ */
+export const SETTINGS_SCREEN_ICON = "Settings";

package/shared/timeline-cards.ts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+
+/** Plugin id from paseo-plugin.json; Paseo matches timeline plugin items by it, not by the provider id. */
+export const PLUGIN_ID = "paseo-dsh-direct";
+
+/** Schema version shared by every card kind below. */
+export const CARD_VERSION = 1;
+
+/** Plan mode switched on or off. */
+export const planModeCardSchema = z.object({ active: z.boolean() });
+
+/** Permission preset changed to `preset`. */
+export const permissionPresetCardSchema = z.object({ preset: z.string() });
+
+/** Goal operations from `goal/change`, plus `continue` for an automatic goal round. */
+export const goalCardSchema = z.object({
+  operation: z.enum([
+    "create",
+    "edit",
+    "pause",
+    "resume",
+    "complete",
+    "block",
+    "clear",
+    "continue",
+  ]),
+  objective: z.string().optional(),
+  round: z.number().optional(),
+  maxRounds: z.number().optional(),
+  reason: z.string().optional(),
+});
+
+export type PlanModeCard = z.infer<typeof planModeCardSchema>;
+export type PermissionPresetCard = z.infer<typeof permissionPresetCardSchema>;
+export type GoalCard = z.infer<typeof goalCardSchema>;
+
+/** Card kinds keyed by the `kind` field of the Paseo plugin timeline item. */
+export const CARD_KINDS = {
+  planMode: "plan-mode",
+  permissionPreset: "permission-preset",
+  goal: "goal",
+} as const;