@qilin-agent/client-ui-workspace 3.1.5 → 3.1.7

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

@@ -190,7 +190,33 @@ export type WorkspaceBrowserInjected = {
     createWorkspace: (input: {
         path: string;
     }) => Promise<WorkspaceView>;
+    /** Copy the complete Session id and report acceptance or failure through the keyed notice. */
+    copySessionId: (sessionId: SessionId) => Promise<void>;
 };
+/** One transient Workspace notice rendered by the overlay toast entry. */
+export type RowToast = {
+    kind: 'sessionIdCopied';
+} | {
+    kind: 'sessionIdCopyFailed';
+} | {
+    kind: 'createFailed';
+    message: string;
+};
+/** The notice on display; `seq` keys remounts so a repeated notice restarts its hold. */
+export type RowToastState = RowToast & {
+    seq: number;
+};
+/** Existing overlay share: the current notice and its dismissal. */
+export interface RowToastInjected {
+    hooks: {
+        /** The notice on display, or none. */
+        toast: HostObservable<RowToastState | null>;
+    };
+    /** Take the notice down. */
+    dismissToast: () => void;
+}
+/** Props of the existing overlay's keyed notice dispatcher. */
+export type RowToastProps = PropsRuntime<'shell.overlay'> & PropsRenderSlots<'workspace.toast'> & Pick<RowToastInjected, 'dismissToast'> & PropsHooks<RowToastInjected['hooks']>;
 /** Full browser props: shell owner share + viewing store + injected actions + the locale seat. */
 export type WorkspaceBrowserProps = PropsRuntime<'sidebar.workspaces'> & PropsRenderSlots<'sidebar.workspaces.directoryFlow' | 'sidebar.session.row.leading' | 'sidebar.session.row.hover'> & PropsStore<ReturnType<typeof createWorkspaceViewStore>> & Omit<WorkspaceBrowserInjected, 'hooks'> & PropsHooks<WorkspaceBrowserInjected['hooks']> & PropsLocale<'workspace'>;
 /**

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

@@ -0,0 +1,55 @@
+/** Keyed Workspace notices and the shared Toast Factory's display data. */
+import type { FactoryComponentPropsOf, InjectFace, PropsLocale, PropsRenderFactories, PropsRuntime } from '@qilin-agent/client-ui-slots';
+import type { RowToastState } from './slots.ts';
+/** Business key of one existing Workspace notice. */
+export type ToastKind = RowToastState['kind'];
+/** Notice payload selected by the keyed registration. */
+export type ToastNotice<K extends ToastKind> = Extract<RowToastState, {
+    kind: K;
+}>;
+/** Plain display fields consumed by the shared Factory. */
+export interface ToastDisplay {
+    text: string;
+    tone: 'plain' | 'warning' | 'success';
+}
+/** Per-display identity and dismissal; neither changes when localized content updates. */
+export interface ToastOccurrence extends ToastDisplay {
+    seq: number;
+    onDone: () => void;
+}
+/** Pure localized display mapping owned by a keyed notice registration. */
+export interface ToastDisplayInjected<K extends ToastKind> {
+    display: (notice: ToastNotice<K>, t: PropsLocale<'workspace'>['t'], dismiss: () => void) => ToastDisplay;
+}
+/** Shared adapter props; each registration narrows its notice payload. */
+export type ToastEntryProps<P extends PropsRuntime<'workspace.toast'>> = P & PropsLocale<'workspace'> & PropsRenderFactories & InjectFace<{
+    display: (notice: P, t: PropsLocale<'workspace'>['t'], dismiss: () => void) => ToastDisplay;
+}>;
+/** Complete props of the shared Workspace Toast Factory. */
+export type WorkspaceToastProps = FactoryComponentPropsOf<'workspace.toast.content'>;
+/** Owner operations available to every keyed Workspace notice. */
+export interface WorkspaceToastOwnerProps {
+    /** Dismiss the displayed notice. */
+    dismissToast: () => void;
+}
+declare module '@qilin-agent/client-ui-slots' {
+    interface SlotMap {
+        /** Workspace notices selected by their existing business discriminator. */
+        'workspace.toast': {
+            kind: 'keyed';
+            scope: 'root';
+            owner: WorkspaceToastOwnerProps;
+            keyProps: {
+                [K in ToastKind]: ToastNotice<K>;
+            };
+        };
+    }
+    interface SlotFactoryMap {
+        /** Shared Toast presentation; business registrations supply only display data and callbacks. */
+        'workspace.toast.content': {
+            scope: 'root';
+            props: ToastOccurrence;
+        };
+    }
+}
+//# sourceMappingURL=toast.d.ts.map

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

@@ -12,7 +12,7 @@ import type { Context } from '@qilin-agent/kylin';
 import type { WorkspaceSnapshot } from '@qilin-agent/api-workspace-controller/client';
 import type { SnapshotSelectorHook } from '@qilin-agent/client-ui-slots';
 import { type WorkspaceKey } from './locales.ts';
-export type { MainSelection, UiWorkspace } from './navigation.ts';
+export type { MainSelection, StartSessionOptions, UiWorkspace } from './navigation.ts';
 export type { DirectoryFlowOwnerProps, DirectoryFlowSlotName, DirectoryPickingHooks, DirectoryPickingInjected, SessionRowScheduleOwnerProps, WorkspaceBrowserInjected, WorkspaceBrowserProps, WorkspacePickerInjected, WorkspacePickerProps, } from './contract/slots.ts';
 export type { WorkspaceKey } from './locales.ts';
 declare module '@qilin-agent/client-ui-slots' {

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

@@ -5,6 +5,8 @@
  */
 /** Simplified Chinese dictionary (the key-set source of truth). */
 export declare const zh: {
+    'draft.workspaceRequired': string;
+    'draft.initializationFailed': string;
     'group.ungrouped': string;
     'session.new': string;
     'session.untitled': string;
@@ -52,12 +54,16 @@ export declare const zh: {
     'menu.unpinSession': string;
     'menu.fork': string;
     'menu.archiveSession': string;
+    'menu.sessionId': string;
+    'toast.sessionIdCopied': string;
+    'toast.sessionIdCopyFailed': string;
     'row.pinned': string;
     'sessions.count.one': string;
     'sessions.count.other': string;
     'actions.workspace.aria': string;
     'actions.session.aria': string;
     'actions.newSession.aria': string;
+    'actions.archive': string;
     'actions.pin': string;
     'actions.unpin': string;
     'status.running': string;
@@ -83,6 +89,8 @@ export declare const zh: {
 export type WorkspaceKey = keyof typeof zh;
 /** English dictionary, checked complete against the zh key set. */
 export declare const en: {
+    'draft.workspaceRequired': string;
+    'draft.initializationFailed': string;
     'group.ungrouped': string;
     'session.new': string;
     'session.untitled': string;
@@ -130,12 +138,16 @@ export declare const en: {
     'menu.unpinSession': string;
     'menu.fork': string;
     'menu.archiveSession': string;
+    'menu.sessionId': string;
+    'toast.sessionIdCopied': string;
+    'toast.sessionIdCopyFailed': string;
     'row.pinned': string;
     'sessions.count.one': string;
     'sessions.count.other': string;
     'actions.workspace.aria': string;
     'actions.session.aria': string;
     'actions.newSession.aria': string;
+    'actions.archive': string;
     'actions.pin': string;
     'actions.unpin': string;
     'status.running': string;

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

@@ -6,12 +6,19 @@ import { type ObservableSnapshot } from '@qilin-agent/client-store';
 import type { SubagentAddress } from '@qilin-agent/subagent/client';
 import type { IWorkspaces, WorkspaceId } from '@qilin-agent/api-workspace-controller/client';
 import type { SessionId } from '@qilin-agent/session/types';
+import type { DraftInitializationOptions } from '@qilin-agent/client-ui-conversation/client';
+import type { RowToast } from './contract/slots.ts';
 import type { WorkspaceViewStoreActions } from './stores.ts';
 /** The main-pane selection a navigation action publishes: one Session, or one direct-parent subagent address. */
 export interface MainSelection {
     readonly sessionId?: SessionId;
     readonly subagentAddress?: SubagentAddress;
 }
+/** Content preparation and Agent preset for the Session a Workspace flow opens. */
+export interface StartSessionOptions extends DraftInitializationOptions {
+    /** Agent preset the Session runs; the Host default when omitted. */
+    readonly agentPreset?: string;
+}
 /** Workspace archive and directory operations consumed by Client UI domains. */
 export interface UiWorkspace {
     /**
@@ -30,9 +37,10 @@ export interface UiWorkspace {
      * @param workspaceId - target Workspace.
      * @param beforeOpen - optional synchronous preparation for the selected Session,
      * skipped after supersession; a throw aborts the open and releases the retained reference.
+     * @param options - choices for the Session the connection creates or reuses.
      * @returns completion; a superseded request may create a Session but does not open it.
      */
-    openWorkspace(workspaceId: WorkspaceId, beforeOpen?: (sessionId: SessionId) => void): Promise<void>;
+    openWorkspace(workspaceId: WorkspaceId, beforeOpen?: (sessionId: SessionId) => void, options?: Pick<StartSessionOptions, 'agentPreset'>): Promise<void>;
     /**
      * Fork a Session and open the child unless a later navigation supersedes it.
      * @param sessionId - source Session.
@@ -42,14 +50,17 @@ export interface UiWorkspace {
     /**
      * Resolve the reusable or newly created blank Session for a Workspace.
      * @param workspaceId - target Workspace.
+     * @param options - choices for the created or reused Session, including the Agent preset.
      * @returns a Session already addressable through the Session Controller.
      */
-    connectWorkspace(workspaceId: WorkspaceId): Promise<SessionId>;
+    connectWorkspace(workspaceId: WorkspaceId, options?: Pick<StartSessionOptions, 'agentPreset'>): Promise<SessionId>;
     /**
      * Start a New Session flow and navigate to its Session.
      * @param workspaceId - explicit target; absent inherits the current or most recent Workspace.
+     * @param options - initial content, the Agent preset, and `whenDraftExists`;
+     * existing text or attachments are preserved unless that handling replaces them.
      */
-    startSession(workspaceId?: WorkspaceId): void;
+    startSession(workspaceId?: WorkspaceId, options?: StartSessionOptions): void;
     /**
      * Archive a Session and clear it when it is the current selection.
      * @param sessionId - Session to archive.
@@ -109,6 +120,7 @@ declare class UiWorkspaceService extends Service implements UiWorkspace {
     private readonly workspaces;
     private readonly sessions;
     private readonly view;
+    private readonly notify;
     private readonly connecting;
     private readonly lifetime;
     /**
@@ -124,13 +136,16 @@ declare class UiWorkspaceService extends Service implements UiWorkspace {
      * @param workspaces - pure Workspace Controller.
      * @param sessions - pure Session Controller.
      * @param view - the browser's viewing-store write set, which owns saved Session order.
+     * @param notify - show one notice through the Workspace notice channel.
      */
-    constructor(ctx: Context, directoryPicker: ClientRemote['directoryPicker'], workspaces: IWorkspaces, sessions: ISessions, view: Pick<WorkspaceViewStoreActions, 'pinSessionOrder'>);
-    connectWorkspace(workspaceId: WorkspaceId): Promise<SessionId>;
+    constructor(ctx: Context, directoryPicker: ClientRemote['directoryPicker'], workspaces: IWorkspaces, sessions: ISessions, view: Pick<WorkspaceViewStoreActions, 'pinSessionOrder'>, notify: (toast: RowToast) => void);
+    connectWorkspace(workspaceId: WorkspaceId, options?: Pick<StartSessionOptions, 'agentPreset'>): Promise<SessionId>;
     openSession(target: SessionTarget): void;
-    openWorkspace(workspaceId: WorkspaceId, beforeOpen?: (sessionId: SessionId) => void): Promise<void>;
+    openWorkspace(workspaceId: WorkspaceId, beforeOpen?: (sessionId: SessionId) => void, options?: Pick<StartSessionOptions, 'agentPreset'>): Promise<void>;
     forkSession(sessionId: SessionId): Promise<void>;
-    startSession(workspaceId?: WorkspaceId): void;
+    startSession(workspaceId?: WorkspaceId, options?: StartSessionOptions): void;
+    private prepareDraft;
+    private draftPreparationFailed;
     archiveSession(sessionId: SessionId): Promise<void>;
     unarchiveSession(sessionId: SessionId): Promise<void>;
     pinSession(sessionId: SessionId): Promise<void>;

package/lib/types/client/rows/Rows.d.ts

@@ -73,8 +73,9 @@ export declare function SearchResultItem({ result, currentId, onOpen, t }: {
     t: RowTranslate;
 }): import("react").JSX.Element;
 /**
- * One top-level 34px session row: status dot (pending user interaction outranks
- * own or descendant activity), title, relative time, and the row actions menu.
+ * One top-level 32px session row: status dot (pending user interaction outranks
+ * own or descendant activity), a title that marquees while the row is hovered,
+ * relative time, and the hover action strip (menu, archive, pin).
  * @param props.node - derived session node.
  * @param props.currentId - selected session id (row highlight).
  * @param props.now - epoch ms for relative-time formatting.
@@ -82,6 +83,7 @@ export declare function SearchResultItem({ result, currentId, onOpen, t }: {
  * @param props.onRename - open the session rename dialog (id + current title).
  * @param props.onFork - fork a session at its last completed turn.
  * @param props.onArchive - archive a session by id.
+ * @param props.onCopyId - copy a session's complete id without opening it.
  * @param props.onPin - pin a session by id (leading its group and the flat list).
  * @param props.onUnpin - drop a session's pin.
  * @param props.onReveal - scroll this row into view after search navigation, then acknowledge it.
@@ -89,7 +91,7 @@ export declare function SearchResultItem({ result, currentId, onOpen, t }: {
  * @param props.t - the browser root's locale seat.
  * @returns the session row.
  */
-export declare function SessionNodeItem({ node, currentId, now, onOpen, onRename, onFork, onArchive, onPin, onUnpin, onReveal, drag, renderSlot, t, }: {
+export declare function SessionNodeItem({ node, currentId, now, onOpen, onRename, onFork, onArchive, onCopyId, onPin, onUnpin, onReveal, drag, renderSlot, t, }: {
     node: SessionNode;
     currentId: string | undefined;
     now: number;
@@ -100,6 +102,8 @@ export declare function SessionNodeItem({ node, currentId, now, onOpen, onRename
     onFork: (id: SessionNode['id']) => void;
     /** Archive this session (row menu action; commits without a dialog). */
     onArchive: (id: SessionNode['id']) => void;
+    /** Copy this session's complete id without opening it (row menu action). */
+    onCopyId: (id: SessionNode['id']) => void;
     /** Pin this session ahead of unpinned rows (row menu and hover action). */
     onPin: (id: SessionNode['id']) => void;
     /** Drop this session's pin (row menu and hover action). */

package/lib/types/client/rows/WorkspaceBrowser.d.ts

@@ -4,5 +4,5 @@ import type { WorkspaceBrowserProps } from '../contract/slots.ts';
  * @param props - composed slot props (shell owner share + store + injected actions).
  * @returns the region element tree.
  */
-export declare function WorkspaceBrowser({ wide, usePanelInfo, expandSidebar, useSessions, useSessionStatus, useWorkspaces, useStore, actions, startSession, open, renameSession, forkSession, renameWorkspace, deleteWorkspace, insertWorkspaceBefore, archiveSession, pinSession, unpinSession, createWorkspace, searchSessions, searchResultLimit, requestSearch, requestAddWorkspace, closeAddWorkspace, closeRenameRequest, setDirectoryBusy, useDirectoryFlow, useHostInfo, useWorkspaceShortcuts, useShortcuts, renderSlot, t, }: WorkspaceBrowserProps): import("react").JSX.Element;
+export declare function WorkspaceBrowser({ wide, usePanelInfo, expandSidebar, useSessions, useSessionStatus, useWorkspaces, useStore, actions, startSession, open, renameSession, forkSession, renameWorkspace, deleteWorkspace, insertWorkspaceBefore, archiveSession, copySessionId, pinSession, unpinSession, createWorkspace, searchSessions, searchResultLimit, requestSearch, requestAddWorkspace, closeAddWorkspace, closeRenameRequest, setDirectoryBusy, useDirectoryFlow, useHostInfo, useWorkspaceShortcuts, useShortcuts, renderSlot, t, }: WorkspaceBrowserProps): import("react").JSX.Element;
 //# sourceMappingURL=WorkspaceBrowser.d.ts.map

package/lib/types/client/toast/RowActionToast.d.ts

@@ -0,0 +1,9 @@
+/** The existing overlay dispatches the latest Workspace notice to its keyed presentation. */
+import type { RowToastProps } from '../contract/slots.ts';
+/**
+ * Dispatch the current notice without interpreting its business payload.
+ * @param props - Current notice, dismissal, and the declared keyed renderer.
+ * @returns The selected notice presentation, or nothing.
+ */
+export declare function RowActionToast({ useToast, dismissToast, renderSlot }: RowToastProps): import("react").ReactNode;
+//# sourceMappingURL=RowActionToast.d.ts.map

package/lib/types/client/toast/Toast.d.ts

@@ -0,0 +1,15 @@
+import type { PropsRuntime } from '@qilin-agent/client-ui-slots';
+import type { ToastEntryProps, WorkspaceToastProps } from '../contract/toast.ts';
+/**
+ * Render one notice using the shared Factory.
+ * @param props - Keyed payload, injected display mapping, locale, and Factory renderer.
+ * @returns The shared Toast occurrence.
+ */
+export declare function ToastEntry<P extends PropsRuntime<'workspace.toast'>>(props: ToastEntryProps<P>): import("react").ReactNode;
+/**
+ * Present plain display data with the shared primitive's timing and portal.
+ * @param props - Localized display fields, display identity, and dismissal.
+ * @returns One Toast, remounted only for a new display identity.
+ */
+export declare function WorkspaceToast({ seq, text, tone, onDone }: WorkspaceToastProps): import("react").JSX.Element;
+//# sourceMappingURL=Toast.d.ts.map

package/lib/types/client/toast/register.d.ts

@@ -0,0 +1,8 @@
+/** Business-owned mappings into the keyed Workspace Toast slot. */
+import type { Context } from '@qilin-agent/kylin';
+/**
+ * Register notice presentations with their business-owned display fields.
+ * @param ctx - Workspace plugin context.
+ */
+export declare function registerToasts(ctx: Context): void;
+//# sourceMappingURL=register.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-ui-workspace",
   "description": "Workspace picker plugin: one WorkspacePicker registered into the sidebar and empty-state workspace slots",
-  "version": "3.1.5",
+  "version": "3.1.7",
   "publishConfig": {
     "access": "public"
   },
@@ -48,33 +48,33 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/kylin": "~4.0.5"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "clsx": "^2.0.0",
     "react": "^18.2.0",
-    "@qilin-agent/api-remotes": "3.1.5",
-    "@qilin-agent/api-session-controller": "3.1.5",
-    "@qilin-agent/client-shortcuts": "3.1.5",
-    "@qilin-agent/client-locale": "3.1.5",
-    "@qilin-agent/client-connection": "3.1.5",
-    "@qilin-agent/api-workspace-controller": "3.1.5",
-    "@qilin-agent/client-store": "3.1.5",
-    "@qilin-agent/client-test-runtime": "3.1.5",
-    "@qilin-agent/client-ui-conversation": "3.1.5",
-    "@qilin-agent/client-ui-layout": "3.1.5",
-    "@qilin-agent/client-ui-primitives": "3.1.5",
-    "@qilin-agent/client-ui-renderer": "3.1.5",
-    "@qilin-agent/client-ui-sidebar": "3.1.5",
-    "@qilin-agent/client-ui-slots": "3.1.5",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/client-ui-session": "3.1.5",
-    "@qilin-agent/schedule": "3.1.5",
-    "@qilin-agent/subagent": "3.1.5",
-    "@qilin-agent/typert-protocol": "3.1.5",
-    "@qilin-agent/session": "3.1.5",
-    "@qilin-agent/util-workspace-path": "3.1.5"
+    "@qilin-agent/api-remotes": "3.1.7",
+    "@qilin-agent/api-session-controller": "3.1.7",
+    "@qilin-agent/api-workspace-controller": "3.1.7",
+    "@qilin-agent/client-connection": "3.1.7",
+    "@qilin-agent/client-shortcuts": "3.1.7",
+    "@qilin-agent/client-locale": "3.1.7",
+    "@qilin-agent/client-test-runtime": "3.1.7",
+    "@qilin-agent/client-store": "3.1.7",
+    "@qilin-agent/client-ui-conversation": "3.1.7",
+    "@qilin-agent/client-ui-layout": "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-sidebar": "3.1.7",
+    "@qilin-agent/client-ui-slots": "3.1.7",
+    "@qilin-agent/schedule": "3.1.7",
+    "@qilin-agent/session": "3.1.7",
+    "@qilin-agent/subagent": "3.1.7",
+    "@qilin-agent/typert-protocol": "3.1.7",
+    "@qilin-agent/util-workspace-path": "3.1.7",
+    "@qilin-agent/kylin": "~4.0.5"
   },
   "files": [
     "lib/index.js",