@qilin-agent/client-ui-conversation 3.1.6 → 3.1.7

package/lib/types/client/contract/composer-submission.d.ts

@@ -1,8 +1,31 @@
 /** Composer submission vocabulary shared by the input and settings domains. */
 import type { BusyEnterBehavior } from '../../conversation-settings.ts';
+import type { SessionId } from '@qilin-agent/session/types';
 export type { BusyEnterBehavior } from '../../conversation-settings.ts';
 /** Delivery mode requested for one ordinary composer message. */
 export type InputSubmitMode = BusyEnterBehavior;
 /** Keyboard gesture whose delivery mode the submission policy resolves. */
 export type ComposerSubmitGesture = 'enter' | 'accelerated';
+/** Session facts captured when a message submission starts, before asynchronous command arbitration. */
+export interface MessageSubmissionState {
+    readonly sessionId?: SessionId;
+    readonly model?: {
+        readonly provider: string;
+        readonly name: string;
+        readonly effort?: string;
+    };
+    readonly runMode: 'default' | 'plan' | 'goal';
+    readonly running: boolean;
+    /** Whether the Session is still blank, so this message is its first. */
+    readonly newSession: boolean;
+    /** Agent preset id the Session records, when known. */
+    readonly agentPreset?: string;
+}
+/** Immutable occurrence and delivery intent carried by one composer attempt. */
+export interface MessageSubmission {
+    readonly timestamp: number;
+    readonly source?: 'click' | 'enter';
+    readonly mode: InputSubmitMode;
+    readonly state?: MessageSubmissionState;
+}
 //# sourceMappingURL=composer-submission.d.ts.map

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

@@ -207,7 +207,7 @@ export interface SessionInputResolver {
     /**
      * Prepare the exact retained Session before navigation publishes it.
      * @param binding - target Session generation, already retained by the caller.
-     * @param options - content to adopt and explicit permission to replace existing text.
+     * @param options - content to adopt and the handling of an existing draft.
      * @returns applied, preserved, or blocked by a pending submission or disposal.
      */
     requestDraftInitialization(binding: SessionBinding, options: DraftInitializationOptions): DraftInitializationResult;
@@ -215,7 +215,15 @@ export interface SessionInputResolver {
 /** Initial text for a target Session; attachments remain under their existing owner. */
 export interface DraftInitializationOptions {
     readonly prompt?: string;
+    /** `true` acts as `whenDraftExists: 'replace'`; ignored when `whenDraftExists` is set. */
     readonly clearPreviousDraft?: boolean;
+    /**
+     * Handling of a target that already has text or attachments: `replace` swaps the text and
+     * inline references for the prompt (or clears them without one), `append` adds the prompt
+     * as new paragraphs after the existing text, and `keep` leaves the draft unchanged. Omitted,
+     * it is `replace` when `clearPreviousDraft` is true and `keep` otherwise.
+     */
+    readonly whenDraftExists?: 'replace' | 'append' | 'keep';
 }
 /** An initialization request never waits for a React mount or a remote catalog. */
 export type DraftInitializationResult = 'applied' | 'preserved' | 'blocked';

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

@@ -57,7 +57,7 @@ export interface ComposerAttachmentsOwnerProps {
     /** Whether a document-level file drop may add attachments now. */
     canAcceptDrop: boolean;
     /** Add one dropped batch through the composer's validation path. */
-    onAddFiles: (files: readonly File[]) => void;
+    onAddFiles: (files: readonly File[], directories?: ReadonlySet<File>) => void;
     /** Remove one draft attachment through the Conversation service. */
     onRemoveAttachment: (id: DraftAttachmentId) => void;
     /** Current per-draft upload states for file-kind attachments. */
@@ -181,6 +181,12 @@ declare module '@qilin-agent/client-ui-slots' {
             scope: 'session';
             owner: ConversationHeaderCornerOwnerProps;
         };
+        /** Rows of the View tab row's More menu; the header shows More only while this list has registrations. */
+        'conversation.session.header.views.actions': {
+            kind: 'list';
+            scope: 'root';
+            owner: ConversationViewActionsOwnerProps;
+        };
         /** Registered Conversation target Views, rendered one at a time. */
         'conversation.view': {
             kind: 'list';
@@ -427,12 +433,51 @@ export interface ConversationSessionInjected {
     /** Select and activate one View while addressing an opaque focus request to it. */
     openView: (view: string, focus: string) => void;
 }
+/** One customizable View tab listed in the More menu. */
+export interface ConversationViewActionEntry {
+    /** View id. */
+    readonly id: string;
+    /** Resolved View label. */
+    readonly label: string;
+    /** False while the View is manually unpinned. A pinned View still enters More when the header's width budget cannot hold it. */
+    readonly pinned: boolean;
+    /** Whether this View is selected in this Session, independently of its pin state. */
+    readonly active?: boolean;
+}
+/** Owner share of the View tab row's More menu rows. */
+export interface ConversationViewActionsOwnerProps {
+    /** Views outside the header in registration order. */
+    readonly entries: readonly ConversationViewActionEntry[];
+    /**
+     * Select a View in this Session without changing its pin state.
+     * @param id - Listed View id.
+     */
+    readonly onOpen: (id: string) => void;
+    /**
+     * Pin or unpin a View in every Session.
+     * @param id - Listed View id.
+     * @param pinned - Whether the View is manually pinned; the width budget can still fold it into More.
+     */
+    readonly onPinnedChange: (id: string, pinned: boolean) => void;
+    /** Close the More menu. */
+    readonly onDismiss: () => void;
+}
 /** Business callbacks injected into the strict Session header. */
 export interface ConversationSessionHeaderInjected {
     /** Package-owned View roster source bound only for the Conversation header. */
     readonly hooks: {
         readonly conversationViews: ObservableSnapshot<readonly ViewTab[]>;
+        /** Ids of unpinned View tabs held in memory and shared by every Session until plugin reload. */
+        readonly entryPins: ObservableSnapshot<readonly string[]>;
+        /** Whether `conversation.session.header.views.actions` has registrations. */
+        readonly entryActions: ObservableSnapshot<boolean>;
     };
+    /**
+     * Pin or unpin one View tab in every Session; Chat is ignored.
+     * @param id - View id.
+     * @param pinned - Whether the View is manually pinned; the width budget can still fold it into More.
+     */
+    setPinned: (id: string, pinned: boolean) => void;
     /** Select a Session through the Session Controller. */
     open: (sessionId: SessionId) => void;
     /** Select and activate one registered Conversation View. */
@@ -459,7 +504,7 @@ export interface ComposerBarOwnerProps {
 /** Package-private operations injected into the resident composer bar. */
 export interface ComposerBarInjected {
     keyboard: ComposerKeyboard | undefined;
-    addFiles: ((files: readonly File[]) => string | null) | undefined;
+    addFiles: ((files: readonly File[], directories?: ReadonlySet<File>) => string | null) | undefined;
     removeAttachment: ((id: DraftAttachmentId) => void) | undefined;
     resolveDraftAttachments: ((ids: readonly DraftAttachmentId[]) => readonly ComposerAttachment[]) | undefined;
     /** Restart one failed file upload; absent without a session. */
@@ -467,6 +512,8 @@ export interface ComposerBarInjected {
     toggleCommandMenu: ((selection: EditSelection) => void) | undefined;
     stop: (() => void) | undefined;
     hooks: {
+        /** Readable sequence while the fixed Stop command is registered. */
+        stopShortcut: ObservableSnapshot<readonly string[]>;
         /**
          * Live busy-state submission preference: the delivery mode plain Enter
          * and the primary Send button use while the addressed agent is busy.
@@ -535,7 +582,7 @@ export type ConversationWidthControlsProps = FactoryLocalComponentPropsOf<'conve
 /** Full props of the strict Session body. */
 export type ConversationSessionSlotProps = PropsRuntime<'conversation.session'> & PropsRenderSlots<'conversation.view'> & PropsStore<ConversationStore> & InjectFace<ConversationSessionInjected>;
 /** Full props of the strict Session header. */
-export type ConversationSessionHeaderSlotProps = PropsRuntime<'conversation.session.header'> & PropsRenderSlots<'conversation.session.header.lineage' | 'conversation.session.header.actions' | 'conversation.session.header.utilities' | 'conversation.session.header.corner'> & PropsStore<ConversationStore> & InjectFace<ConversationSessionHeaderInjected> & PropsLocale<'conversation'>;
+export type ConversationSessionHeaderSlotProps = PropsRuntime<'conversation.session.header'> & PropsRenderSlots<'conversation.session.header.lineage' | 'conversation.session.header.actions' | 'conversation.session.header.utilities' | 'conversation.session.header.corner' | 'conversation.session.header.views.actions'> & PropsStore<ConversationStore> & InjectFace<ConversationSessionHeaderInjected> & PropsLocale<'conversation'>;
 /** Full props of the draft-attachment renderer. */
 export type ComposerAttachmentsProps = PropsRuntime<'conversation.input.attachments'> & PropsLocale<'conversation'>;
 /** Owner share common to blank-session Workspace pickers. */

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

@@ -24,7 +24,7 @@ export { ConversationLocationIndex } from './conversation/location-index.ts';
 export type { ConversationLocationDataChange } from './conversation/location-index.ts';
 export { ConversationViewRegistry } from './conversation/view-registry.ts';
 export type { ConversationKey } from './locales.ts';
-export type { ComposerAttachment, ComposerAttachmentsOwnerProps, ComposerAttachmentsProps, ComposerFileAttachment, ComposerImageAttachment, DraftFileUpload, DraftFileUploads, ComposerBarInjected, ComposerBarOwnerProps, ComposerBarProps, ComposerChainProps, ConversationHeaderActionOwnerProps, ConversationHeaderCornerOwnerProps, ConversationHeaderLineageOwnerProps, ConversationContentInputProps, ConversationContentProps, ConversationInjected, ConversationSessionHeaderInjected, ConversationSessionHeaderSlotProps, ConversationSessionInjected, ConversationSessionSlotProps, ConversationSlotProps, ConversationViewsProps, ConversationWidthControlsInputProps, ConversationWidthControlsProps, ConversationStore, ConvViewOwnerProps, ConvViewProps, EmptyWorkspaceOwnerProps, HeroAgentPresetOwnerProps, HeroBrandMarkOwnerProps, InputControlOwnerProps, InputZone, MessageImageLoader, MessageImageSource, MessageImagesOwnerProps, RenderMessageImages, UseConversation, UseConversationViews, } from './contract/slots.ts';
+export type { ComposerAttachment, ComposerAttachmentsOwnerProps, ComposerAttachmentsProps, ComposerFileAttachment, ComposerImageAttachment, DraftFileUpload, DraftFileUploads, ComposerBarInjected, ComposerBarOwnerProps, ComposerBarProps, ComposerChainProps, ConversationHeaderActionOwnerProps, ConversationHeaderCornerOwnerProps, ConversationHeaderLineageOwnerProps, ConversationContentInputProps, ConversationContentProps, ConversationInjected, ConversationSessionHeaderInjected, ConversationSessionHeaderSlotProps, ConversationSessionInjected, ConversationSessionSlotProps, ConversationSlotProps, ConversationViewActionEntry, ConversationViewActionsOwnerProps, ConversationViewsProps, ConversationWidthControlsInputProps, ConversationWidthControlsProps, ConversationStore, ConvViewOwnerProps, ConvViewProps, EmptyWorkspaceOwnerProps, HeroAgentPresetOwnerProps, HeroBrandMarkOwnerProps, InputControlOwnerProps, InputZone, MessageImageLoader, MessageImageSource, MessageImagesOwnerProps, RenderMessageImages, UseConversation, UseConversationViews, } from './contract/slots.ts';
 export type { BeginCommandRequest, CommandClaim, ConsumeTokenRequest, DraftAttachmentId, DraftInitializationOptions, DraftInitializationResult, InputActions, InputState, InsertReferenceRequest, InsertTextRequest, PickOutcome, SessionInput, SessionInputResolver, SubmitAttachment, SubmitOutcome, } from './contract/input.ts';
 export type { ArbitrateKey, ArbitrateOutcome, DraftInput, DraftReference, DraftSnapshot, ReferenceInsert, TokenSpan } from './contract/draft-editor.ts';
 export type { ComposerBlock, ComposerBlocks } from './contract/composer-blocks.ts';

package/lib/types/client/input/editor/keymap.d.ts

@@ -28,8 +28,12 @@ export interface ComposerKeymapHandlers {
     canSubmit(): boolean;
     /** The Enter gesture after every guard passed; `accelerated` = Ctrl/Cmd held. */
     submit(accelerated: boolean): void;
-    /** Pasted files (image intake). */
-    intakeFiles(files: readonly File[]): void;
+    /**
+     * Pasted files with directory metadata supplied by the clipboard entry API.
+     * @param files - browser files in clipboard order.
+     * @param directories - known directory members; absent when no entry identifies a directory.
+     */
+    intakeFiles(files: readonly File[], directories?: ReadonlySet<File>): void;
     /** Pasted plain text (sanitized insertion through the shell). */
     pasteText(text: string): void;
 }

package/lib/types/client/input/editor/runtime.d.ts

@@ -62,6 +62,14 @@ export declare class DraftEditorRuntime {
      * @param text - the full next draft.
      */
     setDraft(text: string): void;
+    /**
+     * Add plain text after the current draft as new paragraphs, keeping its text
+     * and references; an empty draft takes the text as its whole content.
+     * Placeholder-sanitized; the caret lands at the end; merged into history
+     * like {@link setDraft}.
+     * @param text - plain text to add.
+     */
+    appendDraft(text: string): void;
     /**
      * Insert pasted plain text over the current editor selection
      * (placeholder-sanitized). The paste event's own default is suppressed by
@@ -113,6 +121,12 @@ export declare class DraftEditorRuntime {
      * @returns whether the range mapped and the edit applied.
      */
     insertCommand(span: DetectSpan, claim: CommandClaim, tail: string, mergeHistory?: boolean): boolean;
+    /**
+     * Insert an ordered file-reference batch after the live selection without deleting it.
+     * @param references - validated references in source order.
+     * @returns whether the live insertion position accepted the batch.
+     */
+    insertFileReferences(references: readonly ReferenceInsert[]): boolean;
     /**
      * Clear committed content using the model's suffix decision inside the editor update.
      * @param prefixLength - returns the clipboard-prefix length to remove, or null to clear the root.

package/lib/types/client/input/editor/view-binding.d.ts

@@ -11,7 +11,7 @@ interface DraftViewGate {
     running: boolean;
     steeringAvailable: boolean;
     busyEnter: BusyEnterBehavior;
-    intakeFiles: (files: readonly File[]) => void;
+    intakeFiles: (files: readonly File[], directories?: ReadonlySet<File>) => void;
     uploadsPending: boolean;
     showToast: (text: string) => void;
     t: ComposerBarProps['t'];

package/lib/types/client/input/facade.d.ts

@@ -14,7 +14,7 @@ import { type ObservableSnapshot, type SnapshotStore } from '@qilin-agent/client
 import type { LexicalEditor } from 'lexical';
 import type { CommandClaim, ConsumeTokenRequest, DraftAttachmentId, DraftInitializationOptions, DraftInitializationResult, InputActions, InputNotice, InputState, InputTriggerController, SessionInput, SubmitAttachment, SubmitOutcome } from '../contract/input.ts';
 import type { ArbitrateKey, ArbitrateOutcome, ComposerKeyboard, DraftInput, DraftSnapshot, ReferenceInsert, TokenSpan } from '../contract/draft-editor.ts';
-import type { InputSubmitMode } from '../contract/composer-submission.ts';
+import type { InputSubmitMode, MessageSubmission, MessageSubmissionState } from '../contract/composer-submission.ts';
 /** Popup face the shell needs (dismissal only; typed structurally to avoid a value import). */
 export interface PopupDismissFace {
     dismiss(): void;
@@ -50,6 +50,10 @@ export interface SessionInputDeps {
         /** Localized composer notice for a claimed command that does not accept attachments. */
         unsupportedNotice(token: string): string;
     };
+    /** Capture the Session facts an ordinary-message notification reports; optional observations cannot interrupt submission. */
+    submissionState?: () => MessageSubmissionState;
+    /** Receive the ordinary-message occurrence once, before reference serialization. */
+    messageSubmitted?: (submission: MessageSubmission) => void;
 }
 /**
  * The per-session input facade: scoped-event application verbs +
@@ -125,13 +129,21 @@ export declare class SessionInputShell implements SessionInput {
     persistCurrentDraft(): void;
     /**
      * Apply one new-task request to this already-initialized input model.
-     * @param options - replacement content and explicit permission to clear existing text.
-     * @returns whether text changed, was preserved, or submission prevented editing.
+     * @param options - content to adopt and the handling of an existing draft.
+     * @returns applied when the requested text is adopted, even if unchanged;
+     * preserved when the current draft is kept; blocked after disposal or during a pending submission.
      */
     requestDraftInitialization(options: DraftInitializationOptions): DraftInitializationResult;
     private draftInitializationBlocked;
     /** Append ordered attachment ids unless an admission transaction is locked. */
     addAttachments(ids: readonly DraftAttachmentId[]): boolean;
+    /**
+     * Add validated file references and attachment ids while admission is editable.
+     * @param references - reference chips in source order.
+     * @param ids - newly allocated attachment ids.
+     * @returns false when admission is locked or the editor refuses the insertion.
+     */
+    addFiles(references: readonly ReferenceInsert[], ids: readonly DraftAttachmentId[]): boolean;
     /**
      * Remove one attachment id from this draft. Busy admission phases refuse, like
      * {@link addAttachments}: a removal landing while a command submit serializes
@@ -310,6 +322,17 @@ export declare class SessionInputShell implements SessionInput {
      * its editor snapshot. Chip-free drafts skip the async detour.
      */
     private sinkSerialized;
+    /**
+     * Capture the notification's Session facts; an observation failure leaves them unknown.
+     * @param mode - delivery mode requested for this attempt.
+     * @returns the immutable occurrence.
+     */
+    private submissionFor;
+    /**
+     * Hand one occurrence to the notification consumer; a consumer failure cannot interrupt sending.
+     * @param submission - captured occurrence.
+     */
+    private notifySubmission;
     /** Settle one detached default send independently of other sends. */
     private settleSink;
     /** Restore one failed detached send without overwriting text entered after a restoration. */

package/lib/types/client/input/hub.d.ts

@@ -1,12 +1,3 @@
-/**
- * InputHub: the SessionInputResolver implementation (`ctx.conversation.input`) — one
- * SessionInputShell per session, created inside the uiSession provide
- * materialization (the 'input' standard-kit entry IS the
- * creation trigger) and torn down by the scope disposer (instance-and-scope
- * share one lifecycle). The hub registers the scoped input-mutation
- * listeners on each Session context and owns the default-sink choreography: every session is a
- * real host entity, so the sink is one unconditional prompt path.
- */
 import type { Context } from '@qilin-agent/kylin';
 import type { SessionBinding } from '@qilin-agent/api-session-controller/client';
 import type { SessionId } from '@qilin-agent/session/types';

package/lib/types/client/input/submission-analytics.d.ts

@@ -0,0 +1,10 @@
+/** Maps ordinary message occurrences to Desktop product events. */
+import type { Context } from '@qilin-agent/kylin';
+import type { MessageSubmission } from '../contract/composer-submission.ts';
+/**
+ * Report the original message occurrence without reading newer Session facts.
+ * @param ctx - client context.
+ * @param submission - occurrence, delivery mode, and captured Session facts.
+ */
+export declare function reportMessageSubmission(ctx: Context, submission: MessageSubmission): void;
+//# sourceMappingURL=submission-analytics.d.ts.map

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

@@ -29,6 +29,9 @@ export declare const zh: {
     'attachment.dropTitle': string;
     'attachment.dropDesc': string;
     'attachment.dropBlocked': string;
+    'attachment.directoryDesktopOnly': string;
+    'attachment.pathUnavailable': string;
+    'attachment.pathUnsupported': string;
     'image.pending': string;
     'image.openOriginal': string;
     'image.openOriginalLabel': string;
@@ -72,6 +75,8 @@ export declare const zh: {
     'hero.greeting.evening': string;
     'hero.chooseWorkspace': string;
     'session.hierarchy': string;
+    'session.moreViews': string;
+    'session.moreViewsCurrent': string;
     'todo.title': string;
     'todo.progress.done': string;
     'todo.progress.active': string;
@@ -407,6 +412,9 @@ export declare const en: {
     'attachment.dropTitle': string;
     'attachment.dropDesc': string;
     'attachment.dropBlocked': string;
+    'attachment.directoryDesktopOnly': string;
+    'attachment.pathUnavailable': string;
+    'attachment.pathUnsupported': string;
     'image.pending': string;
     'image.openOriginal': string;
     'image.openOriginalLabel': string;
@@ -450,6 +458,8 @@ export declare const en: {
     'hero.greeting.evening': string;
     'hero.chooseWorkspace': string;
     'session.hierarchy': string;
+    'session.moreViews': string;
+    'session.moreViewsCurrent': string;
     'todo.title': string;
     'todo.progress.done': string;
     'todo.progress.active': string;

package/lib/types/client/skeleton/ConversationSession.d.ts

@@ -10,7 +10,7 @@ export type ConversationSessionHeaderProps = ConversationSessionHeaderSlotProps;
  * @param props - Session identity, parent-owned chrome visibility, view ledger, navigation, render, and locale shares.
  * @returns the title row and, with more than one View, the tab strip.
  */
-export declare function ConversationSessionHeader({ sessionId, hideChrome, useSessions, useConversationViews, useStore, renderSlot, open, selectView, t, }: ConversationSessionHeaderProps): import("react").JSX.Element;
+export declare function ConversationSessionHeader({ sessionId, hideChrome, useSessions, useConversationViews, useStore, renderSlot, open, selectView, setPinned, t, useEntryPins, useEntryActions, }: ConversationSessionHeaderProps): import("react").JSX.Element;
 /**
  * Renders the active Session view inside the resident scrollport and keeps
  * the input draft mirrored while blank Hero chrome is visible.

package/lib/types/client/skeleton/InputBar.d.ts

@@ -14,5 +14,5 @@
  */
 import type { ComposerBarProps } from '../contract/slots.ts';
 export type InputBarProps = ComposerBarProps;
-export declare const InputBar: import("react").MemoExoticComponent<({ useSession, useInput, inputActions, keyboard, addFiles, removeAttachment, resolveDraftAttachments, retryFileUpload, toggleCommandMenu, stop, t, renderSlot, useBusyEnter, useFileUploads, useNotices, useLexicon, useMenuLauncher, useProjection, sessionId, variant, disabled: inert, blocked, workspacePickerOpen, onRequestWorkspace, placeholder, accessory, }: InputBarProps) => import("react").JSX.Element>;
+export declare const InputBar: import("react").MemoExoticComponent<({ useSession, useInput, inputActions, keyboard, addFiles, removeAttachment, resolveDraftAttachments, retryFileUpload, toggleCommandMenu, stop, t, renderSlot, useBusyEnter, useFileUploads, useNotices, useLexicon, useMenuLauncher, useStopShortcut, useProjection, sessionId, variant, disabled: inert, blocked, workspacePickerOpen, onRequestWorkspace, placeholder, accessory, }: InputBarProps) => import("react").JSX.Element>;
 //# sourceMappingURL=InputBar.d.ts.map

package/lib/types/client/view-pins.d.ts

@@ -0,0 +1,22 @@
+/** In-memory pin choices for the Conversation View tabs. */
+import { type ObservableSnapshot } from '@qilin-agent/client-store';
+/** View whose tab always shows and never enters the customization list. */
+export declare const FIXED_VIEW_ID = "chat";
+/** Unpinned View ids and their only mutation. */
+export interface ViewPins {
+    /** Unpinned View ids; ids of Views that are not registered stay listed. */
+    readonly unpinned: ObservableSnapshot<readonly string[]>;
+    /**
+     * Pin or unpin one View tab; the fixed View is ignored. A pinned tab still
+     * enters More when the header's width budget cannot hold it.
+     * @param id - View id.
+     * @param pinned - Whether the tab is manually pinned.
+     */
+    readonly setPinned: (id: string, pinned: boolean) => void;
+}
+/**
+ * Create the in-memory View pin list; the snapshot keeps its reference until the list changes.
+ * @returns Unpinned View ids and the pin mutation.
+ */
+export declare function createViewPins(): ViewPins;
+//# sourceMappingURL=view-pins.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-ui-conversation",
   "description": "Target-neutral Conversation assembly, shell, composer, queue, and view navigation",
-  "version": "3.1.6",
+  "version": "3.1.7",
   "publishConfig": {
     "access": "public"
   },
@@ -64,38 +64,40 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "zod": "^4.4.3",
-    "@qilin-agent/agent": "3.1.6",
-    "@qilin-agent/api-remotes": "3.1.6",
-    "@qilin-agent/api-session-controller": "3.1.6",
-    "@qilin-agent/api-workspace-controller": "3.1.6",
-    "@qilin-agent/attachment": "3.1.6",
-    "@qilin-agent/brand": "3.1.6",
-    "@qilin-agent/client-locale": "3.1.6",
-    "@qilin-agent/client-file-upload": "3.1.6",
-    "@qilin-agent/client-shortcuts": "3.1.6",
-    "@qilin-agent/client-store": "3.1.6",
-    "@qilin-agent/client-ui-layout": "3.1.6",
-    "@qilin-agent/client-test-runtime": "3.1.6",
-    "@qilin-agent/client-ui-primitives": "3.1.6",
-    "@qilin-agent/client-ui-renderer": "3.1.6",
-    "@qilin-agent/client-ui-session": "3.1.6",
-    "@qilin-agent/client-ui-workspace": "3.1.6",
-    "@qilin-agent/client-ui-slots": "3.1.6",
-    "@qilin-agent/commands": "3.1.6",
-    "@qilin-agent/goal": "3.1.6",
+    "@qilin-agent/api-remotes": "3.1.7",
+    "@qilin-agent/agent": "3.1.7",
+    "@qilin-agent/api-session-controller": "3.1.7",
+    "@qilin-agent/attachment": "3.1.7",
+    "@qilin-agent/api-workspace-controller": "3.1.7",
+    "@qilin-agent/brand": "3.1.7",
+    "@qilin-agent/client-file-upload": "3.1.7",
+    "@qilin-agent/client-locale": "3.1.7",
+    "@qilin-agent/client-shortcuts": "3.1.7",
+    "@qilin-agent/client-store": "3.1.7",
+    "@qilin-agent/client-test-runtime": "3.1.7",
+    "@qilin-agent/client-ui-layout": "3.1.7",
+    "@qilin-agent/client-product-analytics": "3.1.7",
+    "@qilin-agent/goal": "3.1.7",
+    "@qilin-agent/plan-mode": "3.1.7",
+    "@qilin-agent/client-ui-primitives": "3.1.7",
+    "@qilin-agent/client-ui-renderer": "3.1.7",
+    "@qilin-agent/client-ui-session": "3.1.7",
+    "@qilin-agent/client-ui-workspace": "3.1.7",
+    "@qilin-agent/client-ui-slots": "3.1.7",
+    "@qilin-agent/commands": "3.1.7",
+    "@qilin-agent/client-ui-settings": "3.1.7",
+    "@qilin-agent/file-reference": "3.1.7",
     "@qilin-agent/kylin": "~4.0.5",
-    "@qilin-agent/client-ui-settings": "3.1.6",
-    "@qilin-agent/llm": "3.1.6",
-    "@qilin-agent/session": "3.1.6",
-    "@qilin-agent/settings": "3.1.6",
-    "@qilin-agent/llm-retry": "3.1.6",
-    "@qilin-agent/plan-mode": "3.1.6",
-    "@qilin-agent/util-values": "3.1.6",
-    "@qilin-agent/util-crypto": "3.1.6",
-    "@qilin-agent/tool-todo": "3.1.6",
-    "@qilin-agent/token-meter": "3.1.6",
-    "@qilin-agent/util-workspace-path": "3.1.6",
-    "@qilin-agent/workspace": "3.1.6"
+    "@qilin-agent/llm": "3.1.7",
+    "@qilin-agent/llm-retry": "3.1.7",
+    "@qilin-agent/session": "3.1.7",
+    "@qilin-agent/token-meter": "3.1.7",
+    "@qilin-agent/tool-todo": "3.1.7",
+    "@qilin-agent/util-values": "3.1.7",
+    "@qilin-agent/util-crypto": "3.1.7",
+    "@qilin-agent/settings": "3.1.7",
+    "@qilin-agent/util-workspace-path": "3.1.7",
+    "@qilin-agent/workspace": "3.1.7"
   },
   "files": [
     "lib/index.js",