dsh-pause-session 0.2.0 → 0.2.1

package/lib/types/client/locales.d.ts

@@ -28,6 +28,7 @@ export declare const zh: {
     'all.unclean.aria': string;
     'all.safe': string;
     'all.checking.aria': string;
+    'all.unavailable.aria': string;
     'all.caveat.jobs': string;
     'all.caveat.unresumable': string;
     'all.caveat.stalled': string;

package/lib/types/client/remote.d.ts

@@ -47,6 +47,12 @@ export interface RemoteStatusSource {
 }
 /**
  * Open the native status stream and expose its latest snapshot to both controls.
+ *
+ * The stream owns no retry of its own: a carrier can drop it on a mux reconnect,
+ * a host reload, or a network blip, and the controls must not stay unavailable
+ * until the page is refreshed. This source reconnects with a bounded backoff and
+ * republishes the new snapshot; while it is disconnected the last value is
+ * discarded, so readers see "unavailable" rather than a stale claim.
  * @param remote - the generated Remote namespace.
  * @param lifetime - client lifetime; aborting it releases the stream.
  * @returns the cached source and its change subscription.

package/lib/types/composition.d.ts

@@ -1,58 +1,34 @@
 /**
- * Rebuild the scoped Agent composition a parked Session ran under.
+ * What a parked Session needs to come back as itself.
  *
- * Activation is not only a persisted Session: the Agent preset supplies the
- * scoped tools, prompt sections, skills, and — for a subagent child — the
- * delegation context, persona, and tool restriction that were in force before
- * the park. A resume that loads the log without that setup starts a different
- * Agent on the same history.
+ * A root Session is loaded directly: the Agent preset it ran supplies the
+ * scoped tools, prompt sections, and skills, so the resume mounts that preset
+ * before the Agent is published. A subagent child is not loaded here at all —
+ * the subagent runtime owns its activation, composition, and tree membership,
+ * and cold-resumes it when this plugin delivers the wake through
+ * `ctx.subagents.prompt`.
  *
- * The preset a Session runs is the `agentPreset` projection, never the
- * creation-time header alone: a blank Session may select another preset before
- * its first turn, and the projection records the selection that actually ran.
- * A child with no independent selection joins its live parent's preset
- * generation; one that selected independently mounts the projected preset.
- * The durable child descriptor supplies the persona, tool filter, and route
- * that are reapplied only on cold resume.
- *
- * Both services are optional. A profile without `agentPresets` has no scoped
- * preset composition to restore, and this module leaves the resume unchanged.
- * A profile that mounts one but cannot read the Session projection cannot
- * prove what composition the Session ran, so it fails the resume instead of
- * silently starting a different Agent.
+ * The two cases are told apart by one read of the Session's own log, which is
+ * the same read the press-time resumability check already pays for.
  * @module dsh-pause-session/composition
  */
 import type { Context } from '@deepseek-ai/cordis';
-import type { Agent, AgentOptions, AgentSetup } from '@deepseek-ai/dsh-agent';
-import type { SessionEvent, SessionId } from '@deepseek-ai/dsh-session';
-/** The setup and route options a resumed Agent receives from its stored composition. */
-export interface RestoredComposition {
-    /** The durable child route, when the descriptor recorded one. */
-    readonly agentOptions?: AgentOptions;
+import type { AgentSetup } from '@deepseek-ai/dsh-agent';
+import type { SessionId } from '@deepseek-ai/dsh-session';
+/** How one parked Session comes back. */
+export type ParkedComposition = {
+    /** An ordinary Session the plugin loads itself. */
+    readonly kind: 'root';
     /** The scoped Agent world to mount before the Agent is published. */
     readonly setup?: AgentSetup;
-}
-/**
- * A stored subagent route that no resume may reactivate.
- *
- * A one-shot child is terminal by contract; activating it as a root Agent
- * would turn a finished delegation into an ordinary conversation that happens
- * to share its Session id.
- */
-export declare class UnresumableSessionError extends Error {
-    constructor(sessionId: SessionId);
-}
-/**
- * Whether the child's own log selected a preset before its descriptor.
- *
- * The creation-time selection precedes the first `subagent/descriptor`; a
- * selection after the descriptor belongs to the child's own later history and
- * does not decide which composition cold resume joins. This mirrors the
- * subagent runtime's own cold-resume rule.
- * @param events - the child's own log suffix, without the fork-inherited prefix.
- * @returns whether the child carries an independent preset selection.
- */
-export declare function hasIndependentPresetSelection(events: readonly SessionEvent[]): boolean;
+} | {
+    /**
+     * A subagent child. The subagent runtime restores its composition from the
+     * persisted descriptor and preset projection, so the plugin only delivers
+     * the wake.
+     */
+    readonly kind: 'child';
+};
 /**
  * Whether a local Session may be parked under a promise of a later resume.
  *
@@ -73,22 +49,20 @@ export declare function hasIndependentPresetSelection(events: readonly SessionEv
  */
 export declare function isResumableSession(ctx: Context, sessionId: SessionId, signal?: AbortSignal): Promise<boolean>;
 /**
- * Read one parked Session's stored composition and build the resume options.
+ * Read one parked Session's own log and decide how it comes back.
+ *
+ * A child returns as `child` with no setup: the subagent runtime restores the
+ * composition from the descriptor and the preset projection, and mounting a
+ * second one here would start a different Agent on the same history.
  *
- * The returned `setup` belongs to the unpublished Agent scope, so all
- * registrations exist before `agent/created`. For a root Session the setup
- * mounts the Session's projected preset, or the profile's default when the
- * Session never selected one. For a child under a live parent it applies the
- * child composition: an independent preset mounts separately, while an
- * inherited composition joins the parent's current generation; the historical
- * descriptor's persona and tool filter are reapplied in both cases.
+ * A root resolves the preset it ran — the projection, never the creation-time
+ * header alone, because a blank Session may select another preset before its
+ * first turn — and hands back the setup that mounts it. A profile with no
+ * preset roster has no scoped composition to restore and resumes unchanged.
  * @param ctx - host context carrying the optional preset and Session-query services.
  * @param sessionId - the parked Session being resumed.
- * @param parent - the live direct parent, when a child is resumed under it.
  * @param signal - cancellation for the observation read.
- * @returns the Agent options and setup to pass to `agents.resume`.
- * @throws {UnresumableSessionError} when the stored child route is one-shot.
- * @throws when a mounted preset roster cannot read the Session projection, or
- * a recorded preset cannot be restored.
+ * @returns how this Session comes back.
+ * @throws when a mounted preset roster cannot read the Session projection.
  */
-export declare function restoreComposition(ctx: Context, sessionId: SessionId, parent: Agent | undefined, signal?: AbortSignal): Promise<RestoredComposition>;
+export declare function readParkedComposition(ctx: Context, sessionId: SessionId, signal?: AbortSignal): Promise<ParkedComposition>;

package/lib/types/index.d.ts

@@ -51,7 +51,7 @@ export type Config = z.infer<typeof ConfigShape>;
 export declare const Config: z.ZodPreprocess<z.ZodObject<{
     silentWakeRoutes: z.ZodDefault<z.ZodArray<z.ZodString>>;
     maxListedLogEvents: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>>;
+}, z.core.$strip>, unknown>;
 /**
  * Mount the durable pause registry, the pause gate, the activity fold, their
  * session control, and the clean resume path.

package/lib/types/release-order.d.ts

@@ -1,13 +1,17 @@
 /**
- * The order a tree release walks: parent before child, shallowest first.
+ * The order a batch release walks: parent before child, shallowest first.
+ *
+ * A single tree release already has the pre-order from its own walk, so this
+ * module serves the batch path, where the recorded sessions may span several
+ * trees. `listDescendants` stamps each row with its distance from the listing
+ * root, so one catalog read per recorded root places every member. A session
+ * the walk never reached is its own root and releases with the first level.
  * @module dsh-pause-session/release-order
  */
 import type { Context } from '@deepseek-ai/cordis';
 import type { SessionId } from '@deepseek-ai/dsh-session';
 /** How a batch release is sequenced. */
 export interface ReleaseOrder {
-    /** The tree edge each child was found under. */
-    readonly parents: ReadonlyMap<SessionId, SessionId>;
     /** One list per depth, shallowest first. */
     readonly levels: readonly (readonly SessionId[])[];
 }
@@ -16,6 +20,6 @@ export interface ReleaseOrder {
  * @param ctx - host context carrying the optional subagent catalog.
  * @param sessionIds - every recorded session, in registry order.
  * @param signal - cancellation for each catalog read.
- * @returns the parent of each child, and one list per depth level.
+ * @returns one list per depth level, shallowest first.
  */
 export declare function releaseOrder(ctx: Context, sessionIds: readonly SessionId[], signal?: AbortSignal): Promise<ReleaseOrder>;

package/lib/types/resume-activation.d.ts

@@ -1,6 +1,15 @@
 /**
- * Reactivate one parked session: restore its composition, give it the route its
- * log recorded, deliver the wake it owes, and only then drop the gate and record.
+ * Reactivate one parked Session and deliver the wake it owes.
+ *
+ * The two Session kinds come back through different owners. An ordinary
+ * Session is loaded by this plugin and given the route its own log recorded.
+ * A subagent child belongs to the subagent runtime: delivering the wake through
+ * `ctx.subagents.prompt` is what cold-resumes it as a managed activation, under
+ * its live tree root, with its persisted composition and tree membership
+ * restored by the runtime itself.
+ *
+ * Both paths keep the same release order: the durable record goes first, then
+ * the gate, so a record that cannot be dropped leaves the Session parked.
  * @module dsh-pause-session/resume-activation
  */
 import type { Context } from '@deepseek-ai/cordis';
@@ -11,17 +20,17 @@ import type { ParkRegistry } from './registry.js';
 import type { ResumeAttempt, ResumeOptions, WakeRequest } from './resume-text.js';
 /** The activation entry points the resume path composes. */
 export interface Activator {
-    activate(sessionId: SessionId, request: WakeRequest, rearm: boolean, parentId?: SessionId, signal?: AbortSignal): Promise<ResumeAttempt>;
+    activate(sessionId: SessionId, request: WakeRequest, rearm: boolean, signal?: AbortSignal): Promise<ResumeAttempt>;
     ensureRoute(agent: Agent): void;
     wake(agent: Agent, request: WakeRequest): void;
     rearmGoal(agent: Agent): void;
 }
 /**
  * Build the activation closure.
- * @param ctx - host context carrying the agent store and goal service.
+ * @param ctx - host context carrying the agent store, subagent runtime, and goal service.
  * @param gate - the pause gate released after activation.
  * @param registry - the durable list the release forgets from.
- * @param options - the route knowledge the wake content depends on.
+ * @param options - the route knowledge the root wake content depends on.
  * @returns the activation methods the resume path uses.
  */
 export declare function createActivator(ctx: Context, gate: PauseGate, registry: ParkRegistry, options: ResumeOptions): Activator;

package/lib/types/resume.d.ts

@@ -71,11 +71,10 @@ export interface ResumePath {
      * Resume one session the registry remembers.
      * @param sessionId - the session to resume.
      * @param request - which wake this resume delivers; see {@link WakeRequest}.
-     * @param parentId - the direct parent a batch release already brought back, when there is one.
      * @param signal - cancellation for the cold load and setup.
      * @returns what happened, and the copy for whoever asked.
      */
-    resumeSession(sessionId: SessionId, request: WakeRequest, parentId?: SessionId, signal?: AbortSignal): Promise<ResumeAttempt>;
+    resumeSession(sessionId: SessionId, request: WakeRequest, signal?: AbortSignal): Promise<ResumeAttempt>;
     /**
      * Resume one session the decision list officially owns — a record that is
      * known NOT to be clean, which the clean path above must refuse and this entry
@@ -86,11 +85,10 @@ export interface ResumePath {
      * or only answers it (`'review'`). A review activates nothing and writes
      * nothing: opening a session to read it is the user's own action, not this
      * plugin's.
-     * @param parentId - the direct parent a batch release already brought back, when there is one.
      * @param signal - cancellation for the cold load and setup.
      * @returns what happened, and the copy for whoever asked.
      */
-    decideUnclean(sessionId: SessionId, request: WakeRequest, finalize: 'release' | 'review', parentId?: SessionId, signal?: AbortSignal): Promise<ResumeAttempt>;
+    decideUnclean(sessionId: SessionId, request: WakeRequest, finalize: 'release' | 'review', signal?: AbortSignal): Promise<ResumeAttempt>;
     /**
      * Resume every session the registry remembers, clean ones only. One session's
      * failure never stops the others.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-pause-session",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "DSH plugin: pause every running session (and its subagents) at a safe point before you leave, then resume them the next morning as if nothing was interrupted.",
   "type": "module",
   "main": "lib/index.js",
@@ -86,7 +86,7 @@
     "@deepseek-ai/dsh-typert-protocol": "*"
   },
   "dependencies": {
-    "zod": "4.4.3"
+    "zod": "4.6.6"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "link:../../deepseek-harness/vendor/cordis",