dsh-home-hosted 0.2.1 → 0.2.2

package/lib/types/home-hosted/entries.d.ts

@@ -12,10 +12,24 @@ import type { EntryIntent, OnPortConflict, ServerEntry, ServerEntryPatch } from
  */
 export declare function defaultOnPortConflict(platform?: NodeJS.Platform): OnPortConflict;
 export declare function defaultIntent(id: string, platform?: NodeJS.Platform): EntryIntent;
-/** The owned keys as a patch, preserving any sibling keys inside `stop`. */
-export declare function ownedPatch(intent: EntryIntent, live?: ServerEntry | null): ServerEntryPatch;
-/** Owned keys whose live value differs from the intent. */
-export declare function ownedDrift(live: ServerEntry | null, intent: EntryIntent): string[];
+/**
+ * The owned keys as a patch, preserving any sibling keys inside `stop`.
+ *
+ * `persistent` is omitted unless the panel that would parse the write knows the
+ * key: an older schema drops it and warns, so writing one is noise at best.
+ */
+export declare function ownedPatch(intent: EntryIntent, live?: ServerEntry | null, options?: {
+    persistent?: boolean;
+}): ServerEntryPatch;
+/**
+ * Owned keys whose live value differs from the intent.
+ *
+ * The intent keeps what the person asked for; a key the panel cannot parse is
+ * not drift, or every entry would report one on an older panel.
+ */
+export declare function ownedDrift(live: ServerEntry | null, intent: EntryIntent, options?: {
+    persistent?: boolean;
+}): string[];
 /**
  * Only the owned keys, as they were before this plugin touched the entry.
  *

package/lib/types/home-hosted/resolve.d.ts

@@ -1,11 +1,13 @@
 import type { CliStatus } from '../shared/contracts.js';
 import type { CliLaunch } from './launch.js';
 /** The range the plugin ships and is tested against. */
-export declare const EXPECTED_RANGE = "^0.6.1";
+export declare const EXPECTED_RANGE = "^0.6.4";
 /** Oldest release whose API and config schema this plugin relies on. */
 export declare const MIN_SUPPORTED_VERSION = "0.4.1";
 /** Oldest release whose config schema accepts `onPortConflict: kill`. */
 export declare const MIN_KILL_VERSION = "0.6.0";
+/** `persistent` (the nanny that keeps an entry alive across panel restarts). */
+export declare const MIN_PERSISTENT_VERSION = "0.6.3";
 export type CliPreference = 'pinned' | 'global';
 export interface CliResolution {
     launch: CliLaunch | null;

package/lib/types/home-hosted/web-notice.d.ts

@@ -0,0 +1,18 @@
+import type { Context } from '@deepseek-ai/cordis';
+/**
+ * dsh web answers an unauthenticated browser with a plain-text 401 line written
+ * by the in-box connection plugin. That text is not configurable and no event
+ * covers it, so a home-hosted deployment — which is where this session's log,
+ * and with it the tokenised URL, actually lives — appends where to look.
+ *
+ * It reaches one internal field, `connection.browserAuth.writeUnauthorized`, and
+ * fails soft: if that shape is ever gone, dsh's own text is left untouched.
+ */
+export declare const STOCK_UNAUTHORIZED = "dsh web authentication required; reopen the URL printed by dsh web.";
+/** The 401 body: dsh's own line, plus where this deployment's log page is. */
+export declare function authNoticeBody(logUrl: string | null): string;
+/**
+ * Install the notice once the connection service is up. `logUrlOf` is read per
+ * 401, so turning the setting off takes effect without re-installing anything.
+ */
+export declare function registerAuthNotice(ctx: Context, logUrlOf: () => string | null): void;

package/lib/types/service.d.ts

@@ -63,6 +63,8 @@ export declare class HomeHostedService extends Service {
     private cli;
     private panelControlDeps;
     private cliExec;
+    /** The panel page showing this session's log, where its tokenised URL is. */
+    panelLogUrl(): string | null;
     /** The port the panel's config holds, without touching a running panel. */
     private configuredPort;
     /** Write the chosen panel port into the state the panel boots from. */
@@ -82,6 +84,8 @@ export declare class HomeHostedService extends Service {
      * older panel refuses to *boot* with it — so this is checked before any write.
      */
     private configVersion;
+    /** Whether the panel whose schema parses our write knows `persistent`. */
+    private supportsPersistent;
     private assertPolicySupported;
     private applyIntents;
     /**

package/lib/types/shared/contracts.d.ts

@@ -28,6 +28,8 @@ export interface SettingsPatch {
     manageDsh?: boolean;
     entries?: PluginSettings['entries'];
     panel?: Partial<PluginSettings['panel']>;
+    authNotice?: boolean;
+    uiStyle?: UiStyle;
     agentTools?: Partial<PluginSettings['agentTools']>;
     cli?: Partial<PluginSettings['cli']>;
 }
@@ -131,6 +133,11 @@ export type ServerEntryPatch = Partial<ServerEntry>;
 /** What the plugin decides about one entry, and the keys it therefore owns. */
 export interface EntryIntent {
     id: string;
+    /**
+     * Run under home-hosted's nanny, so stopping or restarting the *panel* leaves
+     * this process alive. Needs home-hosted 0.6.3.
+     */
+    persistent: boolean;
     autostart: boolean;
     onPortConflict: OnPortConflict;
     stopKillPortHolders: boolean;
@@ -250,6 +257,7 @@ export declare const AGENT_TOOL_NAMES: readonly AgentToolName[];
 export declare const MUTATING_AGENT_TOOLS: readonly AgentToolName[];
 /** The shape this release writes; a file without it was written by 0.1.x. */
 export declare const SETTINGS_VERSION = 2;
+export type UiStyle = 'detailed' | 'compact';
 export interface PluginSettings {
     version: number;
     autostart: {
@@ -270,6 +278,10 @@ export interface PluginSettings {
     panel: {
         port: number | null;
     };
+    /** Point dsh web's sign-in page at the panel log that holds the tokenised URL. */
+    authNotice: boolean;
+    /** `detailed` shows cards and open disclosures; `compact` folds both away. */
+    uiStyle: UiStyle;
     cli: {
         /** `pinned` runs the copy this plugin ships; `global` runs the one on PATH. */
         prefer: 'pinned' | 'global';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-home-hosted",
-  "version": "0.2.1",
-  "description": "Boot autostart for home-hosted and home-hosted server management from DeepSeek Harness.",
+  "version": "0.2.2",
+  "description": "DeepSeek Harness (dsh) plugin: start your dsh web server automatically at boot, and manage home-hosted's panel and servers from inside dsh.",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -17,11 +17,25 @@
   },
   "keywords": [
     "deepseek-harness",
+    "dsh",
     "dsh-plugin",
+    "deepseek",
     "home-hosted",
     "autostart",
+    "boot",
+    "startup",
+    "reboot",
     "systemd",
-    "launchd"
+    "launchd",
+    "xdg-autostart",
+    "windows-task-scheduler",
+    "process-supervisor",
+    "server-management",
+    "self-hosted",
+    "homelab",
+    "agent-tools",
+    "cordis",
+    "typescript"
   ],
   "engines": {
     "node": ">=24"
@@ -103,6 +117,6 @@
     "vitest": "^2.1.8"
   },
   "dependencies": {
-    "home-hosted": "^0.6.1"
+    "home-hosted": "^0.6.4"
   }
 }