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

package/lib/types/types.d.ts

@@ -1,11 +1,11 @@
 /** Browser-safe request, result, and lifecycle vocabulary for the Session Remote service. */
+import type { NativeFileApplication } from '@deepseek-ai/dsh-native-command/types';
 import type { AttachmentIdType, ImageAttachmentLimits, ImageAttachmentRef, ImageMediaType } from '@deepseek-ai/dsh-attachment';
 import type { Branded } from '@deepseek-ai/dsh-brand';
 import type { LlmAttemptId, MessageId } from '@deepseek-ai/dsh-llm/brand';
-import type { ContentBlock } from '@deepseek-ai/dsh-llm';
+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 { JobId } from '@deepseek-ai/dsh-jobs/brand';
 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' {
@@ -42,10 +42,24 @@ export interface SessionListMetadata {
     /** Latest human-authored prompt time in the folded prefix. */
     readonly lastPromptAt: number | null;
 }
-/** Every available cached wire value used as partial, possibly stale Session-list hints. */
+/**
+ * Every available wire value a Session-list row carries as partial, possibly
+ * stale hints. `kind` and `asOfSeq` are independent facts: `kind` says which
+ * sequence space `asOfSeq` belongs to, and therefore how a client may merge
+ * the block; `asOfSeq` is the producer's watermark in that space.
+ */
 export interface SessionProjectionHints {
+    /**
+     * `sequenced`: the Host's live registry produced the block for an attached
+     * Session, so `asOfSeq` is comparable with baselines and frames of the same
+     * connection. `cached`: a header-only listing viewed the block from the
+     * persisted projection cache, so `asOfSeq` is the stored record's own
+     * watermark and must not be compared with the connected Session's values.
+     */
+    readonly kind: 'cached' | 'sequenced';
+    /** Watermark of the block in the sequence space named by `kind`. */
     readonly asOfSeq: number;
-    /** Provider-validated values present in the cache; omitted keys remain unknown. */
+    /** Provider-validated values present in the block; omitted keys remain unknown. */
     readonly values: SessionProjectionValues;
 }
 /** Complete projection values at an exact Session event cursor. */
@@ -135,7 +149,7 @@ export interface ModelCatalog {
 export type QueueAction = {
     readonly kind: 'edit';
     /** Non-empty text-only replacement content. */
-    readonly content: readonly ContentBlock[];
+    readonly content: readonly TextBlock[];
 } | {
     readonly kind: 'remove';
 } | {
@@ -143,6 +157,8 @@ export type QueueAction = {
 };
 /** One Session list entry. */
 export interface SessionSummary {
+    /** Whether this Session currently owns a live Agent. */
+    readonly agentAvailable: boolean;
     readonly sessionId: SessionId;
     readonly updatedAt: number;
     readonly running: boolean;
@@ -172,6 +188,7 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
             readonly requestedCwd: string;
             readonly existingCwd?: string;
         };
+        'session/projections-unavailable': Record<string, never>;
         'session/writer-held': {
             readonly sessionId: SessionId;
         };
@@ -287,6 +304,7 @@ export interface SessionRenameValue {
 /** Session fork request. */
 export interface SessionForkRequest {
     readonly sessionId: SessionId;
+    /** Exact inclusive source event seq; omission selects the latest completed-turn prefix. */
     readonly atSeq?: number;
 }
 /** Identity of a newly forked Session. */
@@ -339,6 +357,8 @@ export interface SessionCancelValue {
 export interface SessionOpenWorkspacePathRequest {
     /** File-manager navigation when requested; omission uses the default application. */
     readonly action?: 'reveal';
+    /** Registered application identifier; ignored for reveal. Omission preserves the operating system default. */
+    readonly application?: string;
     /** Path after best-effort Session workspace resolution, in Host filesystem syntax. */
     readonly path: string;
 }
@@ -366,8 +386,14 @@ export type SessionAddress = {
     readonly kind: 'subagent';
     readonly parentSessionId: SessionId;
     readonly childSessionId: SessionId;
-    readonly mode: 'one-shot' | 'continuable';
+    readonly mode: 'one-shot' | 'continuable' | 'unknown';
 };
+/** One non-activating Session projection read. */
+export interface SessionProjectionsRequest {
+    readonly sessionId: SessionId;
+}
+/** Complete Session projection baseline; null when the Session does not exist. */
+export type SessionProjectionsValue = SessionProjectionBaseline | null;
 /** One raw Session event in the Remote journal. */
 export interface SessionEventEntry {
     readonly type: 'event';
@@ -489,19 +515,8 @@ export type SessionFollowFrame = {
     readonly type: 'assistant-stream';
     readonly frame: SessionAssistantStreamFrame;
 };
-/** Browser-safe background-job row. */
-export interface SessionJob {
-    readonly id: JobId;
-    readonly kind: string;
-    readonly label: string;
-    readonly status: 'running' | 'stopping' | 'completed' | 'killed' | 'failed';
-    readonly detail?: string;
-    readonly startedAt: number;
-    readonly finishedAt?: number;
-}
 /** Complete live control baseline emitted once per control stream generation. */
 export interface SessionControlBaseline {
-    readonly jobs: Readonly<Record<SessionId, readonly SessionJob[]>>;
     readonly projections: Readonly<Record<SessionId, SessionProjectionBaseline>>;
 }
 /** One finished projection value and its durable watermark. */
@@ -515,19 +530,16 @@ export interface SessionProjectionUpdate {
 export type SessionControlFrame = {
     readonly type: 'baseline';
     readonly value: SessionControlBaseline;
-} | {
-    readonly type: 'jobs';
-    readonly sessionId: SessionId;
-    readonly jobs: readonly SessionJob[];
 } | ({
     readonly type: 'projection';
 } & SessionProjectionUpdate);
 declare module '@deepseek-ai/cordis' {
     interface Events {
         /**
-         * A Session became visible to Session list consumers.
+         * A Session became visible or its Agent was created or disposed.
+         * Consumers upsert the summary and replace its current running and availability state.
          * @mode emit
-         * @param summary - initial list row for the Session.
+         * @param summary - current list row for the Session.
          */
         'api-session/added'(summary: SessionSummary): void;
         /**
@@ -561,4 +573,6 @@ declare module '@deepseek-ai/cordis' {
 }
 /** JSON-compatible projection value accepted by list consumers. */
 export type SessionProjectionValue = JsonValue;
+/** Application metadata returned by the serving desktop for one file. */
+export type SessionWorkspacePathApplication = NativeFileApplication;
 //# sourceMappingURL=types.d.ts.map

package/lib/types/types.js

@@ -1,4 +1,3 @@
-/** Browser-safe request, result, and lifecycle vocabulary for the Session Remote service. */
 /** Maximum number of Sessions returned by one search. */
 export const SESSION_SEARCH_RESULT_LIMIT = 20;
 /** Maximum search snippet length in Unicode code points. */

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.1.6-alpha.2",
+  "version": "0.1.7-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -67,45 +67,41 @@
   "dependencies": {
     "mime-types": "^3.0.2",
     "zod": "^4.4.3",
-    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-deque": "^0.1.6-alpha.2",
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/dsh-deque": "^0.1.7-alpha.1",
+    "@deepseek-ai/schemastery": "^3.18.3",
+    "@deepseek-ai/dsh-brand": "^0.1.7-alpha.1"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-agent-default-model": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-commands": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-file-upload": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-file-reference": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-fs": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-jobs": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-scope": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session-projection-cache": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session-title": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session-query": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-skill": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-subagent": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-typert-registry": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-util-time": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-util-values": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-util-workspace-path": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-native-command": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-workspace": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.6-alpha.2"
+    "@deepseek-ai/cordis": "^4.0.3",
+    "@deepseek-ai/dsh-agent": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-agent-default-model": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-agent-preset-registry": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-file-upload": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-commands": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-fs": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-file-reference": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-native-command": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-scope": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-title": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-query": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-skill": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-typert-registry": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-util-time": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-subagent": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-util-values": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-workspace": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.7-alpha.1"
   },
   "peerDependenciesMeta": {
-    "@deepseek-ai/dsh-jobs": {
-      "optional": true
-    },
     "@deepseek-ai/dsh-session-persistence": {
       "optional": true
     },
@@ -115,46 +111,45 @@
   },
   "devDependencies": {
     "@types/mime-types": "^3.0.1",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-agent-default-model": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-file-upload": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-commands": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-file-reference": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-fs-local": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-jobs": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-native-command": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-permission-presets": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-remote-mock": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-scope": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-fs": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session-projection-cache": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session-query": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session-title": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-skill": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-storage": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-storage-domain": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-storage-json": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-subagent": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-util-values": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-util-time": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-util-workspace-path": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-workspace": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-util-crypto": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-typert-registry": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.6-alpha.2"
+    "@deepseek-ai/dsh-agent": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-agent-default-model": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-agent-loop": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-file-upload": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-commands": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-file-reference": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-fs": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-fs-local": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-agent-preset-registry": "^0.1.7-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.3",
+    "@deepseek-ai/dsh-native-command": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-permission-presets": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-scope": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-title": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-skill": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-storage": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-remote-mock": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-typert-registry": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-util-crypto": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-util-time": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-storage-json": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-query": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-workspace": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-subagent": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-util-values": "^0.1.7-alpha.1"
   },
   "scripts": {
     "bundle": "tsdown",