@deepseek-ai/dsh-api-session-controller 0.2.1-alpha.1 → 0.2.1-alpha.2

package/lib/types/client/sessions/projection-store.d.ts

@@ -6,8 +6,8 @@
  * (`{ value, seq }`) comes from the connected Host — a follow opening
  * baseline, a Session Controller `projection` frame, a list block the Host
  * computed for an attached Session — and merges under **higher seq wins**
- * against other sequenced rows. A `cached` row (`{ value }`) comes from the
- * session list's view of the persisted checkpoint, carries no comparable
+ * against other sequenced rows. A `cached` row (`{ value }`) comes from
+ * a Host view of the persisted checkpoint, carries no comparable
  * seq, and yields to every sequenced write. No client-side domain folding
  * exists: a domain ships projection support with zero client code. Per-key
  * bare observable faces feed `useProjection` (ui-renderer binds them).
@@ -101,7 +101,7 @@ export declare class ProjectionValueStore {
      */
     apply(key: string, value: unknown, seq: SessionSeqCursor): void;
     /**
-     * Fill keys from a session-list block the Host labeled `cached`: a zero-I/O
+     * Fill keys from a Host block labeled `cached`: a zero-I/O
      * view of the persisted checkpoint. A cached value lands only where no
      * sequenced row exists: a connected Session has already answered for such
      * a key, and the list's view of the persisted checkpoint cannot be newer

package/lib/types/client/sessions/projection-store.js

@@ -82,7 +82,7 @@ export class ProjectionValueStore {
         this.changed(key);
     }
     /**
-     * Fill keys from a session-list block the Host labeled `cached`: a zero-I/O
+     * Fill keys from a Host block labeled `cached`: a zero-I/O
      * view of the persisted checkpoint. A cached value lands only where no
      * sequenced row exists: a connected Session has already answered for such
      * a key, and the list's view of the persisted checkpoint cannot be newer

package/lib/types/client/sessions/service.d.ts

@@ -12,6 +12,7 @@ import type { AgentContext, ISessions, SessionReference, SessionRetainInfo, Sess
 import { SessionManager } from './manager.ts';
 import type { SessionRemotes } from './remotes.ts';
 import type { SessionListPhase, SessionSearchResultItem, SessionProjectionSnapshot } from './manager.ts';
+import type { SessionListEntry } from './lineage.ts';
 /** Session list row projected from the host list RPC plus live stream increments. */
 export interface SessionSummary {
     id: SessionId;
@@ -23,6 +24,8 @@ export interface SessionSummary {
     parentId?: SessionId;
     /** Coarse durable origin for navigation filtering; not a continuation capability. */
     origin?: 'subagent';
+    /** Format classification supplied by the Host list, when available. */
+    formatStatus?: SessionListEntry['formatStatus'];
     /** Host running state for `ids` members; a display fallback for other rows. */
     running: boolean;
     /** Local ownership counts; Host metadata refreshes cannot overwrite them. */
@@ -30,7 +33,7 @@ export interface SessionSummary {
     /**
      * New Session presentation and reuse eligibility, derived from the Host
      * summary, `sessionListMetadata`, and client acceptance/running observations.
-     * New Session reuses a blank one targeting the same workspace. Filtering
+     * Workspace reconnection may reuse a blank in the same workspace. Filtering
      * stays with the consumer: the store carries every row, while the Workspace
      * browser shows only the selected blank entry.
      */
@@ -113,11 +116,11 @@ export declare class ClientSessions implements ISessions {
      * Resolve an already discovered direct-parent address without opening it.
      * Feature plugins use this to avoid Agent-bound RPCs in persisted child views.
      * @param id - possible addressed child id.
-     * @returns A retained or loaded-catalog address, without retaining a new selection or scope.
+     * @returns A retained, catalog-derived, or unknown-mode listed address, without retaining a new selection or scope.
      */
     subagentAddress(id: SessionId): SubagentAddress | undefined;
     /**
-     * Load all Session projections once per connection; retry an unsuccessful initial read.
+     * Read projections without starting migration; retry failed or migration-deferred reads.
      * @param sessionId - Session to inspect without opening its conversation.
      */
     refreshProjections(sessionId: SessionId): Promise<void>;
@@ -189,7 +192,7 @@ export declare class ClientSessions implements ISessions {
      *   seq (a real event seq the caller already knows; a cut inside an open
      *   turn is balanced Host-side with synthetic closers, and omission selects
      *   the latest completed-turn prefix), and whether to increment an
-     *   inherited durable title before resolving.
+     *   inherited durable title before resolving, plus permission to start source migration.
      * @returns the child session id.
      * @throws {SessionForkError} with the source id.
      * @throws {Error} when a requested child-title rename fails after creation.
@@ -199,6 +202,7 @@ export declare class ClientSessions implements ISessions {
         atSeq?: number;
         increaseTitle?: boolean;
         onCreated?: (childId: SessionId) => void;
+        allowMigration?: boolean;
     }): Promise<SessionId>;
     /**
      * Borrow an already-retained Agent-scoped Context.

package/lib/types/client/sessions/service.js

@@ -234,13 +234,13 @@ export class ClientSessions {
      * Resolve an already discovered direct-parent address without opening it.
      * Feature plugins use this to avoid Agent-bound RPCs in persisted child views.
      * @param id - possible addressed child id.
-     * @returns A retained or loaded-catalog address, without retaining a new selection or scope.
+     * @returns A retained, catalog-derived, or unknown-mode listed address, without retaining a new selection or scope.
      */
     subagentAddress(id) {
         return this.manager.subagentAddress(id);
     }
     /**
-     * Load all Session projections once per connection; retry an unsuccessful initial read.
+     * Read projections without starting migration; retry failed or migration-deferred reads.
      * @param sessionId - Session to inspect without opening its conversation.
      */
     refreshProjections(sessionId) {
@@ -331,7 +331,7 @@ export class ClientSessions {
      *   seq (a real event seq the caller already knows; a cut inside an open
      *   turn is balanced Host-side with synthetic closers, and omission selects
      *   the latest completed-turn prefix), and whether to increment an
-     *   inherited durable title before resolving.
+     *   inherited durable title before resolving, plus permission to start source migration.
      * @returns the child session id.
      * @throws {SessionForkError} with the source id.
      * @throws {Error} when a requested child-title rename fails after creation.
@@ -343,6 +343,7 @@ export class ClientSessions {
         const result = await this.manager.fork({
             sessionId: opts.sessionId,
             ...(opts.atSeq === undefined ? {} : { atSeq: SessionSeq(opts.atSeq) }),
+            ...(opts.allowMigration === undefined ? {} : { allowMigration: opts.allowMigration }),
         });
         if (!result.ok)
             throw new SessionForkError(result.error, opts.sessionId);
@@ -502,6 +503,7 @@ export class ClientSessions {
                 retainedBy: this.retentionSnapshot(entry.sessionId).retainedBy,
                 blank: entry.blank,
                 updatedAt: entry.updatedAt,
+                formatStatus: entry.formatStatus,
                 ...(entry.projectionValues === undefined
                     ? {}
                     : { projectionValues: entry.projectionValues }),
@@ -513,6 +515,8 @@ export class ClientSessions {
         }
         for (const [parentId, projection] of Object.entries(projectionsBySession)) {
             for (const child of projection.values.subagentCatalog ?? []) {
+                if (child.mode === 'external')
+                    continue;
                 const childId = child.id;
                 const summary = byId[childId];
                 const projectionValues = summary?.projectionValues ?? this.manager.projectionValues(childId);

package/lib/types/index.d.ts

@@ -156,7 +156,7 @@ export declare class SessionController extends TypertRemoteService {
      * Fork one cold-readable exact event prefix into a new Session. An omitted
      * boundary selects the latest completed-turn prefix; an open cut receives
      * synthetic fork closers.
-     * @param request - source Session and optional exact inclusive event boundary.
+     * @param request - source Session, optional exact inclusive event boundary, and migration preflight choice.
      * @returns the new Session identity.
      */
     fork(request: SessionForkRequest): Promise<SessionForkValue>;
@@ -201,12 +201,13 @@ export declare class SessionController extends TypertRemoteService {
      */
     follow(request: SessionFollowRequest, signal: AbortSignal): AsyncIterable<SessionFollowFrame>;
     /**
-     * Read all registered projections without activating an Agent.
+     * Read exact projections, returning cached hints only when migration is required.
      * @param request - Session whose current values are required.
-     * @param signal - cancellation for the Session observation.
-     * @returns complete baseline, or null when the Session does not exist.
+     * @param signal - cancellation for the Session read.
+     * @returns a sequenced baseline, cached hints when migration is deferred, or null when absent.
      */
     projections(request: SessionProjectionsRequest, signal: AbortSignal): Promise<SessionProjectionsValue>;
+    private liveProjections;
     /**
      * Stream a complete live-control baseline followed by replacement frames.
      * @param signal - cancellation owned by the Remote stream carrier.

package/lib/types/index.js

@@ -463,10 +463,18 @@ let SessionController = (() => {
          * Fork one cold-readable exact event prefix into a new Session. An omitted
          * boundary selects the latest completed-turn prefix; an open cut receives
          * synthetic fork closers.
-         * @param request - source Session and optional exact inclusive event boundary.
+         * @param request - source Session, optional exact inclusive event boundary, and migration preflight choice.
          * @returns the new Session identity.
          */
-        fork(request) {
+        async fork(request) {
+            if (request.allowMigration === false && this.ctx.sessions.get(request.sessionId) === undefined) {
+                const stored = await this.ctx.get('sessionPersistence')?.stat(request.sessionId);
+                if (stored?.formatStatus === 'migration-required' && this.ctx.sessions.get(request.sessionId) === undefined) {
+                    throw new RemoteError('session/migration-required', 'Open the source Session to complete migration before forking', {
+                        sessionId: request.sessionId,
+                    });
+                }
+            }
             return this.commands.fork(request);
         }
         /**
@@ -523,10 +531,10 @@ let SessionController = (() => {
             return this.history.follow(request, signal);
         }
         /**
-         * Read all registered projections without activating an Agent.
+         * Read exact projections, returning cached hints only when migration is required.
          * @param request - Session whose current values are required.
-         * @param signal - cancellation for the Session observation.
-         * @returns complete baseline, or null when the Session does not exist.
+         * @param signal - cancellation for the Session read.
+         * @returns a sequenced baseline, cached hints when migration is deferred, or null when absent.
          */
         async projections(request, signal) {
             const { sessionId } = request;
@@ -536,12 +544,27 @@ let SessionController = (() => {
             try {
                 const env_2 = { stack: [], error: void 0, hasError: false };
                 try {
+                    signal.throwIfAborted();
+                    const live = this.liveProjections(sessionId);
+                    if (live !== undefined)
+                        return live;
+                    const stored = await this.ctx.get('sessionPersistence')?.stat(sessionId, { signal });
+                    signal.throwIfAborted();
+                    const attached = this.liveProjections(sessionId);
+                    if (attached !== undefined)
+                        return attached;
+                    if (stored === undefined)
+                        return null;
+                    if (stored.formatStatus === 'migration-required') {
+                        const cached = this.ctx.get('sessionProjectionCache')?.cachedSnapshot(stored.header);
+                        return { kind: 'migration-required', values: { ...cached?.values } };
+                    }
                     const observation = __addDisposableResource(env_2, await this.ctx.sessionQuery.observeSession(sessionId, { signal }), false);
                     const projections = observation.projections;
                     if (projections === undefined) {
                         throw new RemoteError('session/projections-unavailable', 'Session projections are unavailable', {});
                     }
-                    return { asOfSeq: projections.asOfSeq, values: projections.values };
+                    return { kind: 'sequenced', asOfSeq: projections.asOfSeq, values: projections.values };
                 }
                 catch (e_2) {
                     env_2.error = e_2;
@@ -552,10 +575,10 @@ let SessionController = (() => {
                 }
             }
             catch (error) {
-                if (error instanceof SessionQueryError && error.code === 'SESSION_QUERY_SESSION_NOT_FOUND')
-                    return null;
-                if (signal.aborted
-                    || (error instanceof SessionQueryError && error.code === 'SESSION_QUERY_ABORTED')) {
+                if (error instanceof SessionQueryError && error.code === 'SESSION_QUERY_SESSION_NOT_FOUND') {
+                    return this.liveProjections(sessionId) ?? null;
+                }
+                if (signal.aborted || (error instanceof SessionQueryError && error.code === 'SESSION_QUERY_ABORTED')) {
                     throw new RemoteError('gateway/cancelled', 'Session projection read was cancelled', {}, { cause: error });
                 }
                 if (error instanceof RemoteError)
@@ -563,6 +586,13 @@ let SessionController = (() => {
                 throw new RemoteError('gateway/internal', 'Session projection read failed', {}, { cause: error });
             }
         }
+        liveProjections(sessionId) {
+            const session = this.ctx.sessions.get(sessionId);
+            if (session === undefined)
+                return undefined;
+            const snapshot = this.ctx.sessionProjections.snapshot(session);
+            return { kind: 'sequenced', asOfSeq: snapshot.asOfSeq, values: snapshot.values };
+        }
         /**
          * Stream a complete live-control baseline followed by replacement frames.
          * @param signal - cancellation owned by the Remote stream carrier.

package/lib/types/list.js

@@ -97,6 +97,7 @@ export class ApiSessionList {
             sessionId: session.id,
             updatedAt: updatedAt(session.header, metadata),
             agentAvailable: this.ctx.agents.get(session.id)?.session === session,
+            formatStatus: 'current',
             running: this.ctx.agents.get(session.id)?.status === 'running',
             blank: metadata?.blank ?? session.seq === 0,
             ...listFields(session.header),
@@ -122,7 +123,7 @@ export class ApiSessionList {
                 items.push(this.summaryFor(live));
             }
             else if (record.header.cwd !== undefined) {
-                cold.push(record.header);
+                cold.push(record);
             }
             if (performance.now() >= yieldDeadline) {
                 await scheduler.yield();
@@ -130,9 +131,9 @@ export class ApiSessionList {
                 yieldDeadline = performance.now() + this.workSliceMs;
             }
         }
-        for (const header of cold) {
+        for (const record of cold) {
             signal?.throwIfAborted();
-            items.push(this.summarizeCold(header));
+            items.push(this.summarizeCold(record));
             if (performance.now() >= yieldDeadline) {
                 await scheduler.yield();
                 signal?.throwIfAborted();
@@ -143,13 +144,14 @@ export class ApiSessionList {
         items.sort((left, right) => right.updatedAt - left.updatedAt);
         return items;
     }
-    summarizeCold(header) {
+    summarizeCold({ header, formatStatus }) {
         const projections = this.projectionsFor(header, undefined);
         const metadata = projections?.values.sessionListMetadata;
         return {
             sessionId: header.id,
             updatedAt: updatedAt(header, metadata),
             agentAvailable: false,
+            ...(formatStatus === undefined ? {} : { formatStatus }),
             running: false,
             // A large, metadata-less, or inaccessible cache miss remains unknown and visible.
             blank: metadata?.blank ?? false,

package/lib/types/skill-catalog.js

@@ -100,7 +100,7 @@ let SessionSkillCatalog = (() => {
             __esDecorate(this, null, _list_decorators, { kind: "method", name: "list", static: false, private: false, access: { has: obj => "list" in obj, get: obj => obj.list }, metadata: _metadata }, null, _instanceExtraInitializers);
             if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
-        static inject = ['agents', 'sessionQuery', 'typert'];
+        static inject = ['agents', 'sessionQuery', 'typert', 'workingDirectory'];
         /** @param ctx - Host context carrying Session reads and optional skill/preset services. */
         constructor(ctx) {
             super(ctx, 'sessionSkillCatalog', { namespace: 'skills' });
@@ -116,7 +116,6 @@ let SessionSkillCatalog = (() => {
         async list(request, signal) {
             const env_1 = { stack: [], error: void 0, hasError: false };
             try {
-                void signal;
                 const { sessionId } = request;
                 let cwd;
                 let agentPreset;
@@ -127,8 +126,13 @@ let SessionSkillCatalog = (() => {
                         if (observation.projections === undefined) {
                             throw new Error('skill catalog requires a projected Session observation');
                         }
-                        cwd = observation.header.cwd;
+                        cwd = observation.projections.values.workingDirectory
+                            ?? observation.header.cwd
+                            ?? this.ctx.workingDirectory.defaultDirectory;
                         agentPreset = observation.projections.values.agentPreset ?? undefined;
+                        const live = this.ctx.agents.get(sessionId);
+                        if (live !== undefined)
+                            cwd = await this.ctx.workingDirectory.ensure(live, signal);
                     }
                     catch (e_1) {
                         env_2.error = e_1;
@@ -145,9 +149,6 @@ let SessionSkillCatalog = (() => {
                     }
                     throw new RemoteError('gateway/internal', `session "${sessionId}" could not be inspected: ${String(error)}`, {});
                 }
-                if (cwd === undefined) {
-                    throw new RemoteError('gateway/internal', `session "${sessionId}" has no project cwd`, {});
-                }
                 const live = this.ctx.agents.get(sessionId);
                 const presets = this.ctx.get('agentPresets');
                 const scoped = live === undefined ? undefined : presets?.serviceFor(live, 'skills');

package/lib/types/types.d.ts

@@ -159,6 +159,8 @@ export type QueueAction = {
 export interface SessionSummary {
     /** Whether this Session currently owns a live Agent. */
     readonly agentAvailable: boolean;
+    /** Current for attached Sessions; otherwise the persistence format status when reported. */
+    readonly formatStatus?: 'current' | 'migration-required';
     readonly sessionId: SessionId;
     readonly updatedAt: number;
     readonly running: boolean;
@@ -226,6 +228,9 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
         'session/fork-unavailable': {
             readonly sessionId: SessionId;
         };
+        'session/migration-required': {
+            readonly sessionId: SessionId;
+        };
         'subagent/not-found': {
             readonly parentSessionId: SessionId;
             readonly childSessionId: SessionId;
@@ -310,6 +315,8 @@ export interface SessionForkRequest {
     readonly sessionId: SessionId;
     /** Exact inclusive source event seq; omission selects the latest completed-turn prefix. */
     readonly atSeq?: number;
+    /** False asks the Host to check for required migration before forking. Defaults to true. */
+    readonly allowMigration?: boolean;
 }
 /** Identity of a newly forked Session. */
 export interface SessionForkValue {
@@ -396,8 +403,13 @@ export type SessionAddress = {
 export interface SessionProjectionsRequest {
     readonly sessionId: SessionId;
 }
-/** Complete Session projection baseline; null when the Session does not exist. */
-export type SessionProjectionsValue = SessionProjectionBaseline | null;
+/** Exact projections carry their event cut; required migration returns sequence-free cache hints. Null means absent. */
+export type SessionProjectionsValue = (SessionProjectionBaseline & {
+    readonly kind: 'sequenced';
+}) | {
+    readonly kind: 'migration-required';
+    readonly values: SessionProjectionValues;
+} | null;
 /** One raw Session event in the Remote journal. */
 export interface SessionEventEntry {
     readonly type: 'event';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-api-session-controller",
   "description": "Session Remote commands, cold reads, and live control transport",
-  "version": "0.2.1-alpha.1",
+  "version": "0.2.1-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -65,43 +65,44 @@
   ],
   "license": "MIT",
   "dependencies": {
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-deque": "0.2.1-alpha.2",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.1",
     "mime-types": "^3.0.2",
-    "zod": "^4.4.3",
-    "@deepseek-ai/dsh-deque": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-brand": "0.2.1-alpha.1",
-    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-agent-default-model": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-api-gateway": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-client-file-upload": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-commands": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-fs": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-native-command": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-scope": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-persistence": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-projection-cache": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-file-reference": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-query": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-credentials": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-title": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-settings": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-skill": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-util-time": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-typert-registry": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-workspace": "0.2.1-alpha.1"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-agent-default-model": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-api-gateway": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-client-file-upload": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-commands": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-credentials": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-file-reference": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-native-command": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-scope": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-persistence": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-projection-cache": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-query": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-title": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-settings": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-skill": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-typert-registry": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-util-time": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-workspace": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-session-persistence": {
@@ -115,48 +116,50 @@
     }
   },
   "devDependencies": {
-    "@types/mime-types": "^3.0.1",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-agent-default-model": "0.2.1-alpha.1",
     "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-api-gateway": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-client-file-upload": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-commands": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-credentials": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-fs": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-fs-local": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-file-reference": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-permission-presets": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-native-command": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-scope": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-remote-mock": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-persistence": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-projection-cache": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-query": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-title": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-skill": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-storage": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-storage-domain": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-storage-json": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-typert-registry": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-util-crypto": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-util-time": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-workspace": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-settings": "0.2.1-alpha.1"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-agent-default-model": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-api-gateway": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-client-file-upload": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-commands": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-credentials": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-file-reference": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs-local": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-native-command": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-permission-presets": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-remote-mock": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-scope": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-persistence": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-projection-cache": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-query": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-title": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-settings": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-skill": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-storage": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-storage-domain": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-storage-json": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-typert-registry": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-util-crypto": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-util-time": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-workspace": "0.2.1-alpha.2",
+    "@types/mime-types": "^3.0.1",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.2"
   },
   "scripts": {
     "bundle": "tsdown",