@huanlin/dsh-focus-chat 0.1.23

package/lib/index.js

@@ -0,0 +1,6 @@
+//#region src/index.ts
+/** Host loader entry for the browser-only focus-view plugin. */
+/** Provides no host-side behavior. */
+function apply() {}
+//#endregion
+export { apply };

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

@@ -0,0 +1,12 @@
+/** The focus view plugin's single assembly point: register the view tab into
+ *  the conversation view slot (the chat plugin's apply layout). */
+/** Required services: the view slot, the locale registry, sessions, the connection facts, the Conversation image resolver, and the Remote namespaces. */
+export declare const inject: string[];
+import type { Context } from '@deepseek-ai/cordis';
+/**
+ * Client plugin body: register the focus view tab.
+ * The registration rides the slot service's effect wrapper, so plugin unload
+ * removes the tab.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: Context): void;

package/lib/types/client/contract/props.d.ts

@@ -0,0 +1,78 @@
+/** Shared props of the focus view entry (the contract face between the apply side and the view). */
+import type { MarkdownFileMentions } from '@deepseek-ai/dsh-client-ui-primitives';
+import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+import type { HostObservable, InjectFace, TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { MessageId } from '@deepseek-ai/dsh-client-connection/client';
+import type { ConvViewProps, TurnLocation } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { MessageFeedbackActionResult, MessageFeedbackView } from '../model/feedback-controller.ts';
+import type { MessageFeedbackRating } from '@deepseek-ai/dsh-message-feedback/types';
+/** One reflow-resistant scroll position (the chat view's saved shape). */
+export interface FocusScrollPosition {
+    /** Stable flow-item identity. */
+    anchorKey: string;
+    /** Anchor row top relative to the scrollport. */
+    anchorTop: number;
+    /** Raw scrollport offset at capture. */
+    scrollTop: number;
+}
+/** Owner currency of a closing assistant (the chat turn-tail owner shape). */
+export interface FocusTurnTailOwner {
+    /** Engine-owned closing turn boundary. */
+    turn: TurnLocation;
+    /** The closing assistant's seq. */
+    seq: number;
+    /** Open a filesystem path through the Host. */
+    openFile: (path: string) => void;
+}
+/** Injected business face of the focus view entry. */
+export interface FocusViewInjected {
+    /** Load one older page of history into the session window (chat-view semantics). */
+    loadOlder: () => void;
+    /** Resolve a session-authorized historical image for inline display. */
+    loadImage: (attachment: ImageAttachmentRef) => Promise<string>;
+    /** Open a workspace path through the Host; refusals reject so the view can surface its dialog. */
+    openFile: (path: string) => Promise<void>;
+    /** Fork the session at one message seq (turn-tail branch semantics). */
+    forkAt: (seq: number) => void;
+    /** Prose file-mention vocabulary for a closing assistant (optional service). */
+    fileMentions: (owner: FocusTurnTailOwner) => MarkdownFileMentions | undefined;
+    /** Whether the browser itself is connected over loopback (produced-chip gating). */
+    isLoopback: boolean;
+    /** Per-session scroll-position ledger (the chat view's persistence). */
+    scroll: {
+        save: (position: FocusScrollPosition | null) => void;
+        read: () => FocusScrollPosition | null;
+    };
+}
+/** Injected Host account home and message-feedback hooks for the view (the
+ *  chat tool-row rule's home abbreviation source, plus the per-message
+ *  feedback view the chat's assistant-actions strip reads — re-declared here
+ *  because the focus view cannot take the assistant-actions slot seat). */
+export interface FocusHooksInjected {
+    hooks: {
+        /** Host account home of the active connection generation, bound by the
+         *  slot renderer; absent while reconnecting. */
+        hostHome: HostObservable<string | undefined>;
+        /** The owning Session's feedback view, shared by every message control. */
+        feedback: HostObservable<MessageFeedbackView>;
+    };
+    /** Load the Session's feedback once, on first interaction. */
+    ensureFeedback: () => Promise<MessageFeedbackActionResult>;
+    /** Create or replace feedback for one message. */
+    rateFeedback: (messageId: MessageId, rating: MessageFeedbackRating, note?: string) => Promise<MessageFeedbackActionResult>;
+    /** Toggle or retract one message's rating. */
+    toggleFeedback: (messageId: MessageId, rating: MessageFeedbackRating) => Promise<MessageFeedbackActionResult>;
+    /** Drop the note while keeping the rating. */
+    clearFeedbackNote: (messageId: MessageId) => Promise<MessageFeedbackActionResult>;
+}
+/**
+ * Full props of the focus view entry: the conversation view kit, the
+ * injected face (hooks bound), and the focus locale seat. Message images
+ * render through the view's own gallery (the chat view owns the image slot
+ * declaration, so a second `conversation.view` entry cannot re-declare it).
+ */
+export type FocusViewProps = ConvViewProps & FocusViewInjected & InjectFace<FocusHooksInjected> & {
+    t: FocusTranslate;
+};
+/** The focus locale seat (the view namespace). */
+export type FocusTranslate = TranslateNS<'focus'>;

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

@@ -0,0 +1,10 @@
+import type { FocusKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The focus view's copy. */
+        focus: FocusKey;
+    }
+}
+export type { FocusKey } from './locales.ts';
+export type { FocusScrollPosition, FocusTurnTailOwner, FocusViewInjected, FocusViewProps } from './contract/props.ts';
+export { apply, inject } from './apply.ts';

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

@@ -0,0 +1,437 @@
+/** `focus` namespace dictionaries (the focus view's copy). */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'view.label': string;
+    copy: string;
+    copied: string;
+    'tool.group': string;
+    'tool.group.one': string;
+    'tool.commands': string;
+    'tool.commands.one': string;
+    'tool.searches': string;
+    'tool.searches.one': string;
+    'tool.thought': string;
+    'tool.context': string;
+    'tool.context.one': string;
+    'tool.edits': string;
+    'tool.edits.one': string;
+    'tool.failedSuffix': string;
+    'tool.failedAll': string;
+    'tool.failed.commands.one': string;
+    'tool.failed.searches.one': string;
+    'tool.subagents': string;
+    'tool.subagents.one': string;
+    'tool.todos': string;
+    'tool.todos.one': string;
+    'todo.rowTitle': string;
+    'todo.completed': string;
+    'tool.goals': string;
+    'tool.goals.one': string;
+    'tool.workflows': string;
+    'tool.workflows.one': string;
+    'tool.skills': string;
+    'tool.skills.one': string;
+    'tool.questions': string;
+    'tool.questions.one': string;
+    'ask.rowTitle': string;
+    'ask.waiting': string;
+    'ask.cancelled': string;
+    'ask.interrupted': string;
+    'ask.answered': string;
+    'tool.plans': string;
+    'tool.plans.one': string;
+    'tool.jobs': string;
+    'tool.jobs.one': string;
+    worked: string;
+    'turnFold.stopped': string;
+    'context.fold': string;
+    'tool.explored.files': string;
+    'tool.explored.files.one': string;
+    'tool.explored.dirs': string;
+    'tool.explored.dirs.one': string;
+    'tool.explored.both': string;
+    'tool.others': string;
+    'tool.others.one': string;
+    'tool.separator': string;
+    'status.diving': string;
+    'duration.seconds': string;
+    'duration.minutes': string;
+    'tool.input': string;
+    'row.running': string;
+    'row.failed': string;
+    'row.stopped': string;
+    extraBlock: string;
+    'terminal.signal': string;
+    'terminal.exitCode': string;
+    'terminal.running': string;
+    'terminal.failed': string;
+    'terminal.done': string;
+    'terminal.noOutput': string;
+    'terminal.collapseAria': string;
+    'terminal.collapse': string;
+    'terminal.expandAria': string;
+    'terminal.expand': string;
+    'tool.expandAria': string;
+    'tool.collapseAria': string;
+    loadOlder: string;
+    loading: string;
+    think: string;
+    'thought.duration': string;
+    'thought.expandAria': string;
+    stopped: string;
+    command: string;
+    'command.running': string;
+    'command.done': string;
+    'command.failed': string;
+    compaction: string;
+    'compaction.completed': string;
+    'compaction.expand': string;
+    'compaction.unavailable': string;
+    'compaction.running': string;
+    contextInjection: string;
+    contextRecall: string;
+    'context.instructions.loaded': string;
+    'context.instructions.added': string;
+    'context.instructions.updated': string;
+    'context.instructions.removed': string;
+    'context.catalog.replaced': string;
+    'context.catalog.more': string;
+    'context.snapshot.supersedes': string;
+    'context.relay.from': string;
+    'context.recall.counts': string;
+    'context.recall.truncated': string;
+    unknownSurface: string;
+    unknownBlock: string;
+    'retry.active': string;
+    'retry.scheduled': string;
+    'retry.started': string;
+    'retry.cancelled': string;
+    'retry.status': string;
+    'retry.delay': string;
+    'retry.failure': string;
+    turnError: string;
+    maxTokens: string;
+    'maxTokens.hint': string;
+    loadingHistory: string;
+    loadError: string;
+    toBottom: string;
+    'nav.rail': string;
+    ranFor: string;
+    ttft: string;
+    tokensPerSecond: string;
+    branch: string;
+    branchUnavailable: string;
+    'produced.label': string;
+    'produced.more': string;
+    'produced.moreOne': string;
+    'produced.showInFolder': string;
+    'produced.open': string;
+    'image.label': string;
+    'image.openOriginal': string;
+    'image.openOriginalLabel': string;
+    'image.loading': string;
+    'image.loadFailed': string;
+    'image.preview': string;
+    'image.closePreview': string;
+    'image.serviceUnavailable': string;
+    'fileOpen.title': string;
+    'fileOpen.unknown': string;
+    'fileOpen.folderTitle': string;
+    'fileOpen.folderUnknown': string;
+    cancel: string;
+    retry: string;
+    close: string;
+    'feedback.like': string;
+    'feedback.likeActive': string;
+    'feedback.dislike': string;
+    'feedback.dislikeActive': string;
+    'feedback.note.open': string;
+    'feedback.note.dialog': string;
+    'feedback.note.placeholder': string;
+    'feedback.note.save': string;
+    'feedback.note.cancel': string;
+    'feedback.note.aria': string;
+    'feedback.error.conflict': string;
+    'feedback.error.load': string;
+    'feedback.error.generic': string;
+    'clock.md': string;
+    'clock.ymd': string;
+    'json.truncated': string;
+    empty: string;
+    'diff.files': string;
+    'diff.collapseAria': string;
+    'diff.expandAria': string;
+    'read.window': string;
+    'read.collapseAria': string;
+    'read.expandAria': string;
+    'search.paths': string;
+    'search.paths.truncated': string;
+    'search.matches': string;
+    'search.matches.truncated': string;
+    'search.noResults': string;
+    'search.collapseAria': string;
+    'search.expandAria': string;
+    'web.noResults': string;
+    'web.sourcesTruncated': string;
+    'web.http': string;
+    'web.contentTruncated': string;
+    'markdown.footnotes': string;
+    systemPrompt: string;
+    'turnUsage.title': string;
+    'turnUsage.summaryWithCache': string;
+    'turnUsage.model': string;
+    'turnUsage.input': string;
+    'turnUsage.cacheRead': string;
+    'turnUsage.cacheWrite': string;
+    'turnUsage.output': string;
+    'turnUsage.reasoning': string;
+    'turnUsage.total': string;
+    'turnUsage.count': string;
+    'turnNavigation.label': string;
+    'turnNavigation.jump': string;
+    'turnNavigation.turn': string;
+    'number.thousand': string;
+    'number.million': string;
+    'number.groupSeparator': string;
+    'tool.title.search': string;
+    'tool.title.read': string;
+    'tool.title.bash': string;
+    'tool.title.write': string;
+    'tool.title.edit': string;
+    'tool.title.code': string;
+    'tool.title.skill': string;
+    'tool.title.generic': string;
+    'tool.title.inspect': string;
+    'tool.title.runCordis': string;
+    'tool.title.stopCordis': string;
+    'tool.title.removeCordis': string;
+    'tool.title.pwsh': string;
+    'tool.title.jobOutput': string;
+    'tool.title.jobKill': string;
+    'tool.title.jobList': string;
+    'tool.title.sendMessage': string;
+    'tool.title.interruptAgent': string;
+    'tool.title.listAgents': string;
+    'tool.agents': string;
+    'tool.agents.running': string;
+    'tool.agents.none': string;
+};
+/** The focus namespace key union. */
+export type FocusKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'view.label': string;
+    copy: string;
+    copied: string;
+    'tool.group': string;
+    'tool.group.one': string;
+    'tool.commands': string;
+    'tool.commands.one': string;
+    'tool.searches': string;
+    'tool.searches.one': string;
+    'tool.thought': string;
+    'tool.context': string;
+    'tool.context.one': string;
+    'tool.edits': string;
+    'tool.edits.one': string;
+    'tool.failedSuffix': string;
+    'tool.failedAll': string;
+    'tool.failed.commands.one': string;
+    'tool.failed.searches.one': string;
+    'tool.subagents': string;
+    'tool.subagents.one': string;
+    'tool.todos': string;
+    'tool.todos.one': string;
+    'todo.rowTitle': string;
+    'todo.completed': string;
+    'tool.goals': string;
+    'tool.goals.one': string;
+    'tool.workflows': string;
+    'tool.workflows.one': string;
+    'tool.skills': string;
+    'tool.skills.one': string;
+    'tool.questions': string;
+    'tool.questions.one': string;
+    'ask.rowTitle': string;
+    'ask.waiting': string;
+    'ask.cancelled': string;
+    'ask.interrupted': string;
+    'ask.answered': string;
+    'tool.plans': string;
+    'tool.plans.one': string;
+    'tool.jobs': string;
+    'tool.jobs.one': string;
+    worked: string;
+    'turnFold.stopped': string;
+    'context.fold': string;
+    'tool.explored.files': string;
+    'tool.explored.files.one': string;
+    'tool.explored.dirs': string;
+    'tool.explored.dirs.one': string;
+    'tool.explored.both': string;
+    'tool.others': string;
+    'tool.others.one': string;
+    'tool.separator': string;
+    'status.diving': string;
+    'duration.seconds': string;
+    'duration.minutes': string;
+    'tool.input': string;
+    'row.running': string;
+    'row.failed': string;
+    'row.stopped': string;
+    extraBlock: string;
+    'terminal.signal': string;
+    'terminal.exitCode': string;
+    'terminal.running': string;
+    'terminal.failed': string;
+    'terminal.done': string;
+    'terminal.noOutput': string;
+    'terminal.collapseAria': string;
+    'terminal.collapse': string;
+    'terminal.expandAria': string;
+    'terminal.expand': string;
+    'tool.expandAria': string;
+    'tool.collapseAria': string;
+    loadOlder: string;
+    loading: string;
+    think: string;
+    'thought.duration': string;
+    'thought.expandAria': string;
+    stopped: string;
+    command: string;
+    'command.running': string;
+    'command.done': string;
+    'command.failed': string;
+    compaction: string;
+    'compaction.completed': string;
+    'compaction.expand': string;
+    'compaction.unavailable': string;
+    'compaction.running': string;
+    contextInjection: string;
+    contextRecall: string;
+    'context.instructions.loaded': string;
+    'context.instructions.added': string;
+    'context.instructions.updated': string;
+    'context.instructions.removed': string;
+    'context.catalog.replaced': string;
+    'context.catalog.more': string;
+    'context.snapshot.supersedes': string;
+    'context.relay.from': string;
+    'context.recall.counts': string;
+    'context.recall.truncated': string;
+    unknownSurface: string;
+    unknownBlock: string;
+    'retry.active': string;
+    'retry.scheduled': string;
+    'retry.started': string;
+    'retry.cancelled': string;
+    'retry.status': string;
+    'retry.delay': string;
+    'retry.failure': string;
+    turnError: string;
+    maxTokens: string;
+    'maxTokens.hint': string;
+    loadingHistory: string;
+    loadError: string;
+    toBottom: string;
+    'nav.rail': string;
+    ranFor: string;
+    ttft: string;
+    tokensPerSecond: string;
+    branch: string;
+    branchUnavailable: string;
+    'produced.label': string;
+    'produced.more': string;
+    'produced.moreOne': string;
+    'produced.showInFolder': string;
+    'produced.open': string;
+    'image.label': string;
+    'image.openOriginal': string;
+    'image.openOriginalLabel': string;
+    'image.loading': string;
+    'image.loadFailed': string;
+    'image.preview': string;
+    'image.closePreview': string;
+    'image.serviceUnavailable': string;
+    'fileOpen.title': string;
+    'fileOpen.unknown': string;
+    'fileOpen.folderTitle': string;
+    'fileOpen.folderUnknown': string;
+    cancel: string;
+    retry: string;
+    close: string;
+    'feedback.like': string;
+    'feedback.likeActive': string;
+    'feedback.dislike': string;
+    'feedback.dislikeActive': string;
+    'feedback.note.open': string;
+    'feedback.note.dialog': string;
+    'feedback.note.placeholder': string;
+    'feedback.note.save': string;
+    'feedback.note.cancel': string;
+    'feedback.note.aria': string;
+    'feedback.error.conflict': string;
+    'feedback.error.load': string;
+    'feedback.error.generic': string;
+    'clock.md': string;
+    'clock.ymd': string;
+    'json.truncated': string;
+    empty: string;
+    'diff.files': string;
+    'diff.collapseAria': string;
+    'diff.expandAria': string;
+    'read.window': string;
+    'read.collapseAria': string;
+    'read.expandAria': string;
+    'search.paths': string;
+    'search.paths.truncated': string;
+    'search.matches': string;
+    'search.matches.truncated': string;
+    'search.noResults': string;
+    'search.collapseAria': string;
+    'search.expandAria': string;
+    'web.noResults': string;
+    'web.sourcesTruncated': string;
+    'web.http': string;
+    'web.contentTruncated': string;
+    'markdown.footnotes': string;
+    systemPrompt: string;
+    'turnUsage.title': string;
+    'turnUsage.summaryWithCache': string;
+    'turnUsage.model': string;
+    'turnUsage.input': string;
+    'turnUsage.cacheRead': string;
+    'turnUsage.cacheWrite': string;
+    'turnUsage.output': string;
+    'turnUsage.reasoning': string;
+    'turnUsage.total': string;
+    'turnUsage.count': string;
+    'turnNavigation.label': string;
+    'turnNavigation.jump': string;
+    'turnNavigation.turn': string;
+    'number.thousand': string;
+    'number.million': string;
+    'number.groupSeparator': string;
+    'tool.title.search': string;
+    'tool.title.read': string;
+    'tool.title.bash': string;
+    'tool.title.write': string;
+    'tool.title.edit': string;
+    'tool.title.code': string;
+    'tool.title.skill': string;
+    'tool.title.generic': string;
+    'tool.title.inspect': string;
+    'tool.title.runCordis': string;
+    'tool.title.stopCordis': string;
+    'tool.title.removeCordis': string;
+    'tool.title.pwsh': string;
+    'tool.title.jobOutput': string;
+    'tool.title.jobKill': string;
+    'tool.title.jobList': string;
+    'tool.title.sendMessage': string;
+    'tool.title.interruptAgent': string;
+    'tool.title.listAgents': string;
+    'tool.agents': string;
+    'tool.agents.running': string;
+    'tool.agents.none': string;
+};