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

package/lib/types/index.js

@@ -91,9 +91,11 @@ import z from '@deepseek-ai/schemastery';
 import { errorChain, ReasoningEffortId } from '@deepseek-ai/dsh-llm';
 import { canOpenNativePath, nativeFileManager, nativeFileApplications, openNativeFileApplication, openNativeAssociatedPath, revealNativePath } from '@deepseek-ai/dsh-native-command';
 import { SessionQueryError } from '@deepseek-ai/dsh-session-query';
-import { Remote, RemoteError, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import { Remote, RemoteError, TypertRemoteService, principalOf } from '@deepseek-ai/dsh-typert-protocol';
+import { canonicalClientTimeZone } from '@deepseek-ai/dsh-util-time';
+import { assertNever } from '@deepseek-ai/dsh-util-values';
 import { ApiSessionAgentController, inspectApiSession, } from "./agent.js";
-import { SessionCommandController } from "./commands.js";
+import { SessionCommandController, hasPromptContent } from "./commands.js";
 import { SessionControlController } from "./control.js";
 import { SessionHistoryController } from "./history.js";
 import { SessionFileReferences } from "./file-references.js";
@@ -106,6 +108,15 @@ import { ArchivedSessionGate } from "./archived-session-gate.js";
 export { ApiSessionNotFound } from "./agent.js";
 export { SessionFileReferences } from "./file-references.js";
 export { SessionSkillCatalog } from "./skill-catalog.js";
+/**
+ * Read the Session resource a history address names: the Session itself, or
+ * the child Session whose transcript a subagent address reads.
+ * @param request - history request carrying the durable address.
+ * @returns the Session whose access the read requires.
+ */
+function addressedSession(request) {
+    return request.address.kind === 'session' ? request.address.sessionId : request.address.childSessionId;
+}
 /** Host service backing the generated `ctx.remote.session` namespace. */
 let SessionController = (() => {
     let _classSuper = TypertRemoteService;
@@ -147,8 +158,8 @@ let SessionController = (() => {
             _attachment_decorators = [Remote('attachment')];
             _updateQueue_decorators = [Remote('updateQueue')];
             _cancel_decorators = [Remote('cancel')];
-            _page_decorators = [Remote('page')];
-            _follow_decorators = [Remote({ mode: 'stream' })];
+            _page_decorators = [Remote({ name: 'page', resources: { session: addressedSession } })];
+            _follow_decorators = [Remote({ mode: 'stream', resources: { session: addressedSession } })];
             _projections_decorators = [Remote('projections')];
             _control_decorators = [Remote({ mode: 'stream' })];
             __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);
@@ -179,6 +190,7 @@ let SessionController = (() => {
             'fileUploads',
             'fs',
             'llm',
+            'remoteAccess',
             'sessions',
             'sessionProjections',
             'sessionQuery',
@@ -207,6 +219,7 @@ let SessionController = (() => {
          */
         constructor(ctx, config, internals = {}) {
             super(ctx, 'sessionController', { namespace: 'session' });
+            ctx.typert.resources.register('session', { field: 'sessionId' });
             const resolved = SessionController.Config(config);
             installModelSelectionProjection(ctx);
             this.agents = new ApiSessionAgentController(ctx);
@@ -324,21 +337,25 @@ let SessionController = (() => {
          * @returns visible Session summaries ordered by activity.
          */
         async list(_request, signal) {
-            return { items: await this.listState.list(signal) };
+            const items = await this.listState.list(signal);
+            return { items: items.filter(item => this.ctx.remoteAccess.allows({ kind: 'session', id: item.sessionId })) };
         }
         /**
-         * Search visible Session content without resuming an Agent.
+         * Search visible Session content without resuming an Agent. A non-owner
+         * receives only the hits whose Session `allows()` admits; `hasMore`
+         * describes the bounded result before that filtering.
          * @param request - literal message-content query.
          * @param signal - cancellation for list and search reads.
          * @returns authorized bounded Session search results.
          */
-        search(request, signal) {
-            return this.listState.search(request.query, signal);
+        async search(request, signal) {
+            const result = await this.listState.search(request.query, signal);
+            return { ...result, items: result.items.filter(item => this.ctx.remoteAccess.allows({ kind: 'session', id: item.sessionId })) };
         }
         /**
-         * Create or idempotently adopt one ordinary Session.
-         * @param request - requested identity, location, and Agent preset.
-         * @returns the Session identity and resolved preset when configured.
+         * Create one ordinary Session for a new conversation, reusing the named blank Session while it is reusable.
+         * @param request - optional blank Session to reuse, location, and Agent preset.
+         * @returns the created or reused Session identity and its preset when configured.
          */
         create(request) {
             return this.commands.create(request);
@@ -463,10 +480,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);
         }
         /**
@@ -475,9 +500,26 @@ let SessionController = (() => {
          * @param signal - caller cancellation before prompt admission begins.
          * @returns acknowledgement that the Agent accepted the prompt.
          */
-        prompt(request, signal) {
+        async prompt(request, signal) {
             signal.throwIfAborted();
-            return this.commands.prompt(request);
+            if (!hasPromptContent(request.content)) {
+                throw new RemoteError('gateway/bad-request', 'prompt content must include non-whitespace text or an attachment', {});
+            }
+            const clientTimeZone = request.clientTimeZone === undefined
+                ? undefined
+                : canonicalClientTimeZone(request.clientTimeZone);
+            if (request.clientTimeZone !== undefined && clientTimeZone === undefined) {
+                throw new RemoteError('session/invalid-time-zone', 'clientTimeZone must be UTC or a valid IANA Area/Location name', { value: request.clientTimeZone });
+            }
+            // The caller is recorded only when it is not the owner, so owner messages keep their exact source.
+            const principal = principalOf(this.ctx.invocation);
+            const source = {
+                kind: 'user',
+                rpcId: request.requestId,
+                ...(clientTimeZone === undefined ? {} : { clientTimeZone }),
+                ...(principal === undefined ? {} : { principal }),
+            };
+            return this.commands.prompt(request, source);
         }
         /**
          * Read one image proven reachable from the addressed Session log.
@@ -523,10 +565,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 +578,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 +609,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,13 +620,36 @@ 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.
          * @returns one complete baseline followed by live replacement frames.
          */
-        control(signal) {
-            return this.controlState.control(signal);
+        async *control(signal) {
+            for await (const frame of this.controlState.control(signal)) {
+                switch (frame.type) {
+                    case 'baseline': {
+                        const projections = Object.fromEntries(Object.entries(frame.value.projections)
+                            .filter(([sessionId]) => this.ctx.remoteAccess.allows({ kind: 'session', id: sessionId })));
+                        yield { type: 'baseline', value: { ...frame.value, projections } };
+                        break;
+                    }
+                    case 'projection':
+                        if (this.ctx.remoteAccess.allows({ kind: 'session', id: frame.sessionId }))
+                            yield frame;
+                        break;
+                    /* v8 ignore next -- closed control-frame union. */
+                    default:
+                        assertNever(frame);
+                }
+            }
         }
     };
 })();

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

@@ -6,6 +6,7 @@ import type { LlmAttemptId, MessageId } from '@deepseek-ai/dsh-llm/brand';
 import type { TextBlock } from '@deepseek-ai/dsh-llm';
 import type { SessionId, SessionSeqCursor } from '@deepseek-ai/dsh-session/types';
 import type { SessionProjectionMap } from '@deepseek-ai/dsh-session-projection/types';
+import type { Principal } from '@deepseek-ai/dsh-typert-protocol';
 import type { JsonValue } from '@deepseek-ai/dsh-util-values';
 import type { WorkspaceId } from '@deepseek-ai/dsh-workspace/types';
 declare module '@deepseek-ai/dsh-session-projection/types' {
@@ -159,6 +160,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;
@@ -209,7 +212,6 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
         'agent-preset/conflict': {
             readonly sessionId: SessionId;
             readonly requestedPreset: string;
-            readonly existingPreset?: string;
         };
         'session/attachment-invalid': {
             readonly reason: string;
@@ -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;
@@ -275,16 +280,22 @@ export interface SessionSearchValue {
     readonly items: readonly SessionSearchItem[];
     readonly hasMore: boolean;
 }
-/** Session creation or explicit-id adoption request. */
+/** Request for a Session for a new conversation. */
 export interface SessionCreateRequest {
+    /** Workspace the Session joins; exclusive with `cwd`. */
     readonly workspaceId?: WorkspaceId;
+    /** Directory the Session owns when no Workspace is named. */
     readonly cwd?: string;
+    /** Blank Session to reuse while it is reusable, or the identity of a new Session when none is stored under it. */
     readonly sessionId?: SessionId;
+    /** Preset the Session runs, replacing a reused Session's recorded preset; the configured default when omitted. */
     readonly agentPreset?: string;
 }
 /** Session creation response value. */
 export interface SessionCreateValue {
+    /** The created or reused Session, which may differ from the requested `sessionId`. */
     readonly sessionId: SessionId;
+    /** Preset the Session runs, when the deployment composes a preset roster. */
     readonly agentPreset?: string;
 }
 /** Session model-selection request. */
@@ -310,6 +321,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 {
@@ -374,11 +387,16 @@ export interface SessionOpenWorkspacePathValue {
 export type SessionRequestId = Branded<'session-request-id'>;
 declare module '@deepseek-ai/dsh-llm' {
     interface MessageSourceMap {
-        /** Browser prompt correlation and optional Host-validated time zone. */
+        /**
+         * Browser prompt correlation, optional Host-validated time zone, and the
+         * caller that submitted the prompt. `principal` is written only for a
+         * caller other than the owner, so an absent `principal` means the owner.
+         */
         'user-rpc': {
             kind: 'user';
             rpcId: SessionRequestId;
             clientTimeZone?: string;
+            principal?: Principal;
         };
     }
 }
@@ -396,8 +414,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/locale/en.json

@@ -0,0 +1,5 @@
+{
+  "meta": {
+    "title": "api-session-controller"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "会话控制接口",
+    "description": "向客户端提供会话读取、运行控制和状态更新能力。"
+  }
+}

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.3",
   "publishConfig": {
     "access": "public"
   },
@@ -39,7 +39,8 @@
       "default": "./lib/typert.remote-client.js"
     },
     "./src/*": "./src/*",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "dsh": {
     "client": {
@@ -54,6 +55,7 @@
     }
   },
   "files": [
+    "locale/*.json",
     "lib/index.js",
     "lib/client.js",
     "lib/types/**/*.js",
@@ -65,43 +67,44 @@
   ],
   "license": "MIT",
   "dependencies": {
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-deque": "0.2.1-alpha.3",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.2",
     "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/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-agent-default-model": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-api-gateway": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-file-upload": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-commands": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-credentials": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-file-reference": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-fs": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-native-command": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-scope": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-persistence": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-projection-cache": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-query": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-title": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-settings": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-skill": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-typert-registry": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-time": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-workspace": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.3"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-session-persistence": {
@@ -115,48 +118,51 @@
     }
   },
   "devDependencies": {
+    "@deepseek-ai/dsh-api-remote-access": "0.2.1-alpha.3",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-agent-default-model": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-api-gateway": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-file-upload": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-commands": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-credentials": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-file-reference": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-fs": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-fs-local": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-native-command": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-permission-presets": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-remote-mock": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-scope": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-persistence": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-projection-cache": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-query": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-title": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-settings": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-skill": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-storage": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-storage-domain": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-storage-json": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-typert-registry": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-crypto": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-time": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-workspace": "0.2.1-alpha.3",
     "@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-working-directory": "0.2.1-alpha.3"
   },
   "scripts": {
     "bundle": "tsdown",