@ahggg/dsh-side-chat 0.7.3 → 1.0.1

package/lib/shared/contracts.d.ts

@@ -4,7 +4,11 @@ export type SessionId = string & {
     readonly [brand]: 'SessionId';
 };
 export declare function SessionId(value: string): SessionId;
-/** Provider/model choice owned by one Side Chat fork. */
+/** Plugin-local identity. It is never registered as a DSH Session. */
+export type SideChatId = string & {
+    readonly [brand]: 'SideChatId';
+};
+export declare function SideChatId(value: string): SideChatId;
 export interface SideChatModelSelection {
     readonly provider: string;
     readonly model: string;
@@ -22,7 +26,7 @@ export interface SideChatWireError {
     readonly message: string;
     readonly recoverable: boolean;
 }
-export type SideChatOperation = 'create' | 'open' | 'prompt' | 'close';
+export type SideChatOperation = 'create' | 'prompt' | 'close';
 export interface SideChatClientError extends SideChatWireError {
     readonly operation: SideChatOperation;
 }
@@ -53,55 +57,84 @@ export interface ConversationSelection {
     readonly atSeq: number;
     readonly rect: SelectionRect;
 }
-export type SideChatPhase = 'closed' | 'draft' | 'creating' | 'opening' | 'ready' | 'running' | 'needs-input' | 'needs-approval' | 'closing' | 'error';
+export interface SideChatMessage {
+    readonly id: string;
+    readonly role: 'user' | 'assistant';
+    readonly text: string;
+    readonly reasoning?: string | undefined;
+    readonly selectedText?: string | undefined;
+    readonly status: 'streaming' | 'complete' | 'stopped' | 'error';
+}
+export type SideChatPhase = 'closed' | 'draft' | 'creating' | 'ready' | 'running' | 'closing' | 'error';
 export interface SideChatState {
     readonly phase: SideChatPhase;
     readonly modelSelection?: SideChatModelSelection | undefined;
     readonly parentSessionId?: SessionId | undefined;
-    readonly childSessionId?: SessionId | undefined;
+    readonly chatId?: SideChatId | undefined;
     readonly boundarySeq?: number | undefined;
-    readonly inheritedThroughSeq?: number | undefined;
     readonly selection?: ConversationSelection | undefined;
     readonly draft: string;
-    readonly firstQuestion?: string | undefined;
+    readonly messages: readonly SideChatMessage[];
     readonly error?: SideChatClientError | undefined;
 }
 export interface CreateSideChatRequest {
     readonly parentSessionId: SessionId;
     readonly atSeq: number;
+    readonly selectedText?: string | undefined;
     readonly modelSelection?: SideChatModelSelection | undefined;
 }
 export interface CreateSideChatValue {
     readonly parentSessionId: SessionId;
-    readonly childSessionId: SessionId;
+    readonly chatId: SideChatId;
     readonly boundarySeq: number;
-    readonly inheritedThroughSeq: number;
-    readonly modelSelection?: SideChatModelSelection | undefined;
+    readonly modelSelection: SideChatModelSelection;
 }
-export interface SelectSideChatModelRequest extends SideChatModelSelection {
-    readonly childSessionId: SessionId;
+export interface ChatRequest {
+    readonly chatId: SideChatId;
+}
+export interface SelectSideChatModelRequest extends ChatRequest, SideChatModelSelection {
 }
 export interface SelectSideChatModelValue {
     readonly selected: SideChatModelSelection;
 }
-export interface CloseSideChatRequest {
-    readonly childSessionId: SessionId;
+export interface SendSideChatRequest extends ChatRequest {
+    /** Stable across a retry when transport failed before admission was observed. */
+    readonly requestId: string;
+    readonly text: string;
 }
 export interface CloseSideChatValue {
     readonly closed: true;
 }
+export type SideChatStreamEvent = {
+    readonly type: 'started';
+    readonly requestId: string;
+    readonly modelSelection: SideChatModelSelection;
+} | {
+    readonly type: 'content';
+    readonly text: string;
+    readonly reasoning: string;
+} | {
+    readonly type: 'finished';
+    readonly status: 'complete' | 'stopped';
+} | {
+    readonly type: 'error';
+    readonly error: SideChatWireError;
+};
+export interface SideChatStream extends AsyncIterable<SideChatStreamEvent> {
+    dispose(): void;
+}
 export interface SideChatRemote {
     create(request: CreateSideChatRequest): Promise<SideChatResult<CreateSideChatValue>>;
     selectModel(request: SelectSideChatModelRequest): Promise<SideChatResult<SelectSideChatModelValue>>;
-    close(request: CloseSideChatRequest): Promise<SideChatResult<CloseSideChatValue>>;
+    stream(request: SendSideChatRequest): SideChatStream;
+    cancel(request: ChatRequest): Promise<SideChatResult<{
+        readonly cancelled: true;
+    }>>;
+    close(request: ChatRequest): Promise<SideChatResult<CloseSideChatValue>>;
 }
+/** Text representation also used by the durable main-composer annotation codec. */
 export type SideChatPromptPart = {
     readonly type: 'text';
     readonly text: string;
-} | {
-    readonly type: 'image';
-    readonly mediaType: string;
-    readonly data: string;
-    readonly name?: string;
 };
 export {};

package/lib/shared/contracts.js

@@ -1,3 +1,2 @@
-export function SessionId(value) {
-    return value;
-}
+export function SessionId(value) { return value; }
+export function SideChatId(value) { return value; }

package/lib/shared/error-codes.d.ts

@@ -1,3 +1,3 @@
-export declare const SIDE_CHAT_ERROR_CODES: readonly ["selection_empty", "selection_outside_conversation", "selection_not_model_visible", "selection_too_large", "selection_stale", "selection_crosses_unsupported_nodes", "parent_session_missing", "parent_session_not_ready", "fork_unavailable", "side_chat_already_open", "side_chat_not_found", "side_chat_open_failed", "side_chat_prompt_failed", "side_chat_model_failed", "side_chat_interrupt_failed", "side_chat_destroy_failed", "transport_error", "invalid_request", "internal_error"];
+export declare const SIDE_CHAT_ERROR_CODES: readonly ["selection_empty", "selection_outside_conversation", "selection_not_model_visible", "selection_too_large", "selection_stale", "selection_crosses_unsupported_nodes", "parent_session_missing", "parent_session_not_ready", "context_unavailable", "context_too_large", "side_chat_already_open", "side_chat_not_found", "side_chat_prompt_failed", "side_chat_model_failed", "side_chat_interrupt_failed", "side_chat_destroy_failed", "transport_error", "invalid_request", "internal_error"];
 export type SideChatErrorCode = (typeof SIDE_CHAT_ERROR_CODES)[number];
 export declare function isSideChatErrorCode(value: unknown): value is SideChatErrorCode;

package/lib/shared/error-codes.js

@@ -7,10 +7,10 @@ export const SIDE_CHAT_ERROR_CODES = [
     'selection_crosses_unsupported_nodes',
     'parent_session_missing',
     'parent_session_not_ready',
-    'fork_unavailable',
+    'context_unavailable',
+    'context_too_large',
     'side_chat_already_open',
     'side_chat_not_found',
-    'side_chat_open_failed',
     'side_chat_prompt_failed',
     'side_chat_model_failed',
     'side_chat_interrupt_failed',

package/lib/shared/{archived-wire.d.ts → side-chat-wire.d.ts}

@@ -1,4 +1,9 @@
 import { z } from 'zod';
+export declare const modelSelectionSchema: z.ZodObject<{
+    provider: z.ZodString;
+    model: z.ZodString;
+    reasoningEffort: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
 export declare const sideChatWireErrorSchema: z.ZodObject<{
     code: z.ZodEnum<{
         selection_empty: "selection_empty";
@@ -9,10 +14,10 @@ export declare const sideChatWireErrorSchema: z.ZodObject<{
         selection_crosses_unsupported_nodes: "selection_crosses_unsupported_nodes";
         parent_session_missing: "parent_session_missing";
         parent_session_not_ready: "parent_session_not_ready";
-        fork_unavailable: "fork_unavailable";
+        context_unavailable: "context_unavailable";
+        context_too_large: "context_too_large";
         side_chat_already_open: "side_chat_already_open";
         side_chat_not_found: "side_chat_not_found";
-        side_chat_open_failed: "side_chat_open_failed";
         side_chat_prompt_failed: "side_chat_prompt_failed";
         side_chat_model_failed: "side_chat_model_failed";
         side_chat_interrupt_failed: "side_chat_interrupt_failed";
@@ -24,36 +29,41 @@ export declare const sideChatWireErrorSchema: z.ZodObject<{
     message: z.ZodString;
     recoverable: z.ZodBoolean;
 }, z.core.$strict>;
-export declare const archivedCreateRequestSchema: z.ZodObject<{
+export declare const createRequestSchema: z.ZodObject<{
     parentSessionId: z.ZodString;
     atSeq: z.ZodNumber;
+    selectedText: z.ZodOptional<z.ZodString>;
     modelSelection: z.ZodOptional<z.ZodObject<{
         provider: z.ZodString;
         model: z.ZodString;
         reasoningEffort: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
-export declare const archivedSelectModelRequestSchema: z.ZodObject<{
-    childSessionId: z.ZodString;
+export declare const chatRequestSchema: z.ZodObject<{
+    chatId: z.ZodString;
+}, z.core.$strict>;
+export declare const selectModelRequestSchema: z.ZodObject<{
+    chatId: z.ZodString;
     provider: z.ZodString;
     model: z.ZodString;
     reasoningEffort: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
-export declare const archivedCloseRequestSchema: z.ZodObject<{
-    childSessionId: z.ZodString;
+export declare const sendRequestSchema: z.ZodObject<{
+    chatId: z.ZodString;
+    requestId: z.ZodString;
+    text: z.ZodString;
 }, z.core.$strict>;
-export declare const archivedCreateResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare const createResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     ok: z.ZodLiteral<true>;
     value: z.ZodObject<{
         parentSessionId: z.ZodString;
-        childSessionId: z.ZodString;
+        chatId: z.ZodString;
         boundarySeq: z.ZodNumber;
-        inheritedThroughSeq: z.ZodNumber;
-        modelSelection: z.ZodOptional<z.ZodObject<{
+        modelSelection: z.ZodObject<{
             provider: z.ZodString;
             model: z.ZodString;
             reasoningEffort: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>>;
+        }, z.core.$strict>;
     }, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
     ok: z.ZodLiteral<false>;
@@ -67,10 +77,10 @@ export declare const archivedCreateResultSchema: z.ZodDiscriminatedUnion<[z.ZodO
             selection_crosses_unsupported_nodes: "selection_crosses_unsupported_nodes";
             parent_session_missing: "parent_session_missing";
             parent_session_not_ready: "parent_session_not_ready";
-            fork_unavailable: "fork_unavailable";
+            context_unavailable: "context_unavailable";
+            context_too_large: "context_too_large";
             side_chat_already_open: "side_chat_already_open";
             side_chat_not_found: "side_chat_not_found";
-            side_chat_open_failed: "side_chat_open_failed";
             side_chat_prompt_failed: "side_chat_prompt_failed";
             side_chat_model_failed: "side_chat_model_failed";
             side_chat_interrupt_failed: "side_chat_interrupt_failed";
@@ -83,7 +93,7 @@ export declare const archivedCreateResultSchema: z.ZodDiscriminatedUnion<[z.ZodO
         recoverable: z.ZodBoolean;
     }, z.core.$strict>;
 }, z.core.$strict>], "ok">;
-export declare const archivedSelectModelResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare const selectModelResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     ok: z.ZodLiteral<true>;
     value: z.ZodObject<{
         selected: z.ZodObject<{
@@ -104,10 +114,10 @@ export declare const archivedSelectModelResultSchema: z.ZodDiscriminatedUnion<[z
             selection_crosses_unsupported_nodes: "selection_crosses_unsupported_nodes";
             parent_session_missing: "parent_session_missing";
             parent_session_not_ready: "parent_session_not_ready";
-            fork_unavailable: "fork_unavailable";
+            context_unavailable: "context_unavailable";
+            context_too_large: "context_too_large";
             side_chat_already_open: "side_chat_already_open";
             side_chat_not_found: "side_chat_not_found";
-            side_chat_open_failed: "side_chat_open_failed";
             side_chat_prompt_failed: "side_chat_prompt_failed";
             side_chat_model_failed: "side_chat_model_failed";
             side_chat_interrupt_failed: "side_chat_interrupt_failed";
@@ -120,7 +130,7 @@ export declare const archivedSelectModelResultSchema: z.ZodDiscriminatedUnion<[z
         recoverable: z.ZodBoolean;
     }, z.core.$strict>;
 }, z.core.$strict>], "ok">;
-export declare const archivedCloseResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare const closeResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     ok: z.ZodLiteral<true>;
     value: z.ZodObject<{
         closed: z.ZodLiteral<true>;
@@ -137,10 +147,43 @@ export declare const archivedCloseResultSchema: z.ZodDiscriminatedUnion<[z.ZodOb
             selection_crosses_unsupported_nodes: "selection_crosses_unsupported_nodes";
             parent_session_missing: "parent_session_missing";
             parent_session_not_ready: "parent_session_not_ready";
-            fork_unavailable: "fork_unavailable";
+            context_unavailable: "context_unavailable";
+            context_too_large: "context_too_large";
+            side_chat_already_open: "side_chat_already_open";
+            side_chat_not_found: "side_chat_not_found";
+            side_chat_prompt_failed: "side_chat_prompt_failed";
+            side_chat_model_failed: "side_chat_model_failed";
+            side_chat_interrupt_failed: "side_chat_interrupt_failed";
+            side_chat_destroy_failed: "side_chat_destroy_failed";
+            transport_error: "transport_error";
+            invalid_request: "invalid_request";
+            internal_error: "internal_error";
+        }>;
+        message: z.ZodString;
+        recoverable: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>], "ok">;
+export declare const cancelResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    value: z.ZodObject<{
+        cancelled: z.ZodLiteral<true>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            selection_empty: "selection_empty";
+            selection_outside_conversation: "selection_outside_conversation";
+            selection_not_model_visible: "selection_not_model_visible";
+            selection_too_large: "selection_too_large";
+            selection_stale: "selection_stale";
+            selection_crosses_unsupported_nodes: "selection_crosses_unsupported_nodes";
+            parent_session_missing: "parent_session_missing";
+            parent_session_not_ready: "parent_session_not_ready";
+            context_unavailable: "context_unavailable";
+            context_too_large: "context_too_large";
             side_chat_already_open: "side_chat_already_open";
             side_chat_not_found: "side_chat_not_found";
-            side_chat_open_failed: "side_chat_open_failed";
             side_chat_prompt_failed: "side_chat_prompt_failed";
             side_chat_model_failed: "side_chat_model_failed";
             side_chat_interrupt_failed: "side_chat_interrupt_failed";
@@ -153,3 +196,49 @@ export declare const archivedCloseResultSchema: z.ZodDiscriminatedUnion<[z.ZodOb
         recoverable: z.ZodBoolean;
     }, z.core.$strict>;
 }, z.core.$strict>], "ok">;
+export declare const streamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"started">;
+    requestId: z.ZodString;
+    modelSelection: z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+        reasoningEffort: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"content">;
+    text: z.ZodString;
+    reasoning: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"finished">;
+    status: z.ZodEnum<{
+        complete: "complete";
+        stopped: "stopped";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            selection_empty: "selection_empty";
+            selection_outside_conversation: "selection_outside_conversation";
+            selection_not_model_visible: "selection_not_model_visible";
+            selection_too_large: "selection_too_large";
+            selection_stale: "selection_stale";
+            selection_crosses_unsupported_nodes: "selection_crosses_unsupported_nodes";
+            parent_session_missing: "parent_session_missing";
+            parent_session_not_ready: "parent_session_not_ready";
+            context_unavailable: "context_unavailable";
+            context_too_large: "context_too_large";
+            side_chat_already_open: "side_chat_already_open";
+            side_chat_not_found: "side_chat_not_found";
+            side_chat_prompt_failed: "side_chat_prompt_failed";
+            side_chat_model_failed: "side_chat_model_failed";
+            side_chat_interrupt_failed: "side_chat_interrupt_failed";
+            side_chat_destroy_failed: "side_chat_destroy_failed";
+            transport_error: "transport_error";
+            invalid_request: "invalid_request";
+            internal_error: "internal_error";
+        }>;
+        message: z.ZodString;
+        recoverable: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>], "type">;

package/lib/shared/side-chat-wire.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { SIDE_CHAT_ERROR_CODES } from './error-codes.js';
+const id = z.string().min(1).max(512);
+export const modelSelectionSchema = z.object({ provider: id, model: id, reasoningEffort: id.optional() }).strict();
+export const sideChatWireErrorSchema = z.object({
+    code: z.enum(SIDE_CHAT_ERROR_CODES), message: z.string(), recoverable: z.boolean(),
+}).strict();
+export const createRequestSchema = z.object({
+    parentSessionId: id, atSeq: z.number().int().nonnegative(),
+    selectedText: z.string().max(16 * 1024).optional(), modelSelection: modelSelectionSchema.optional(),
+}).strict();
+export const chatRequestSchema = z.object({ chatId: id }).strict();
+export const selectModelRequestSchema = z.object({
+    chatId: id, provider: id, model: id, reasoningEffort: id.optional(),
+}).strict();
+export const sendRequestSchema = z.object({ chatId: id, requestId: id, text: z.string().min(1).max(64 * 1024) }).strict();
+function resultSchema(value) {
+    return z.discriminatedUnion('ok', [
+        z.object({ ok: z.literal(true), value }).strict(),
+        z.object({ ok: z.literal(false), error: sideChatWireErrorSchema }).strict(),
+    ]);
+}
+export const createResultSchema = resultSchema(z.object({
+    parentSessionId: id, chatId: id, boundarySeq: z.number().int().nonnegative(), modelSelection: modelSelectionSchema,
+}).strict());
+export const selectModelResultSchema = resultSchema(z.object({ selected: modelSelectionSchema }).strict());
+export const closeResultSchema = resultSchema(z.object({ closed: z.literal(true) }).strict());
+export const cancelResultSchema = resultSchema(z.object({ cancelled: z.literal(true) }).strict());
+export const streamEventSchema = z.discriminatedUnion('type', [
+    z.object({ type: z.literal('started'), requestId: id, modelSelection: modelSelectionSchema }).strict(),
+    z.object({ type: z.literal('content'), text: z.string(), reasoning: z.string() }).strict(),
+    z.object({ type: z.literal('finished'), status: z.enum(['complete', 'stopped']) }).strict(),
+    z.object({ type: z.literal('error'), error: sideChatWireErrorSchema }).strict(),
+]);

package/lib/typert.d.ts

@@ -1,37 +1,5 @@
-export declare const ARCHIVED_INVOCATIONS: {
-    id: string;
-    service: string;
-    namespace: string;
-    method: "create" | "close" | "selectModel";
-    implementation: string;
-    invocation: {
-        kind: "direct";
-    };
-    parameters: {
-        name: string;
-        wire: string;
-        source: "json";
-        codec: {
-            mode: "strict";
-            typeSymbol: string;
-            schema: {
-                parse(value: unknown): unknown;
-            };
-        };
-    }[];
-    result: {
-        mode: "strict";
-        typeSymbol: string;
-        schema: {
-            parse(value: unknown): unknown;
-        };
-    };
-    sourceLocation: {
-        file: string;
-        line: number;
-        column: number;
-    };
-}[];
+import type { InvocationDescriptor } from '@deepseek-ai/dsh-typert-protocol';
+export declare const SIDE_CHAT_INVOCATIONS: InvocationDescriptor[];
 export declare const TYPERT: {
     package: string;
     face: string;
@@ -41,39 +9,6 @@ export declare const TYPERT: {
         events: never[];
         objects: never[];
     };
-    invocations: {
-        id: string;
-        service: string;
-        namespace: string;
-        method: "create" | "close" | "selectModel";
-        implementation: string;
-        invocation: {
-            kind: "direct";
-        };
-        parameters: {
-            name: string;
-            wire: string;
-            source: "json";
-            codec: {
-                mode: "strict";
-                typeSymbol: string;
-                schema: {
-                    parse(value: unknown): unknown;
-                };
-            };
-        }[];
-        result: {
-            mode: "strict";
-            typeSymbol: string;
-            schema: {
-                parse(value: unknown): unknown;
-            };
-        };
-        sourceLocation: {
-            file: string;
-            line: number;
-            column: number;
-        };
-    }[];
+    invocations: InvocationDescriptor[];
 };
 export default TYPERT;