@khorsheed/dsh-library 0.1.0 → 0.1.1

package/lib/tool.js

@@ -649,7 +649,7 @@ function libraryResourceTool(kit) {
 	const { service, projectOf, autoBind, scopeParams } = kit;
 	return defineTool({
 		name: "library_textbook",
-		description: "Shelve, correct, reorder or remove a textbook (anything with a contents) — in study order. origin: learner (their own) | picked (a book or course you chose; its path takes only the chapters the goal needs) | authored (you write it: one chapter per lesson, your 讲义 are its text). A real book: verify the edition and contents online and cite the page (tocSource { by: \"web\", url }); never ask for an upload. A correction (resourceId) sends only what changes. A web page a station cites is no textbook — the path names its url.",
+		description: "Shelve, correct, reorder or remove a textbook (anything with a contents) — in study order. origin: learner (their own) | picked (a book or course you chose; its path takes only the chapters the goal needs) | authored (you write it: one chapter per lesson, your 讲义 are its text). A real book: verify the edition and contents online and cite the page (tocSource { by: \"web\", url }) — search the title with its author or ISBN, narrowed with site: to catalog or publisher pages (site:book.douban.com, site:worldcat.org, the publisher's domain), one query per edition to tell apart, never a \" in a query; never ask for an upload. A correction (resourceId) sends only what changes. A web page a station cites is no textbook — the path names its url.",
 		parameters: {
 			...scopeParams,
 			op: {

package/lib/types/client/LibraryPane.js

@@ -32,6 +32,18 @@ import css from './LibraryPane.module.css';
 /** The tab body. */
 export function LibraryPane(props) {
     const route = props.useStore(s => s.stack[s.stack.length - 1]);
+    const { revealed, actions } = props;
+    // A reveal (the session's first library write) lands on its project: taken on
+    // mount when the reveal opened this tab, at once when the tab was already open.
+    useEffect(() => {
+        const land = () => {
+            const projectId = revealed.take();
+            if (projectId !== undefined)
+                actions.openProject(projectId);
+        };
+        land();
+        return revealed.subscribe(land);
+    }, [revealed, actions]);
     return (_jsxs(PanelRoot, { className: css.root, children: [(() => {
                 switch (route.view) {
                     case 'today': return _jsx(TodayView, { p: props });

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

@@ -12,6 +12,7 @@ import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
 import type { GlobalStandardProps, InjectFace, PropsLocale, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
 import type { LibraryAssessResult, LibraryAssessment, LibraryAttempt, LibraryBinding, LibraryCard, LibraryCardQuery, LibraryProjectPatch, LibraryEvent, LibraryOutcome, LibraryPage, LibraryProject, LibraryProjectSummary, LibraryResource, LibraryReviewRating, LibraryRoadmap, LibraryTemplate, LibraryVerdict } from '../types.ts';
 import type { createLibraryStore } from './store.ts';
+import type { RevealedProject } from './reveal.ts';
 export type { RemoteResult };
 /** A Remote call's answer: the protocol envelope around a domain outcome. */
 type Answer<T> = Promise<RemoteResult<LibraryOutcome<T>>>;
@@ -140,6 +141,8 @@ export interface LibraryPaneInjected {
     }>>;
     /** The session's binding, when it has one. */
     boundTarget: () => Promise<RemoteResult<LibraryBinding | null>>;
+    /** The project a reveal asks the pane to land on, taken once (see reveal.ts). */
+    revealed: Pick<RevealedProject, 'take' | 'subscribe'>;
     /** Bind the session (null unbinds). */
     bindTarget: (binding: LibraryBinding | null) => Answer<{
         binding: LibraryBinding | null;

package/lib/types/client/index.js

@@ -3,6 +3,7 @@ import { LIBRARY_KIND, LIBRARY_TAB_ID, libraryDefinition } from "./definition.js
 import { LibraryPane } from "./LibraryPane.js";
 import { LibraryBindChip } from "./bind/BindChip.js";
 import { createLibraryStore } from "./store.js";
+import { RevealedProject } from "./reveal.js";
 import { en, NS, zh } from "./locales.js";
 import { LibraryTabVisibility, RegistrationToggle, } from "./preset-visibility.js";
 export { LibraryPane };
@@ -59,6 +60,8 @@ export async function apply(ctx) {
             return undefined;
         }
     };
+    /** The project the next reveal lands on (one per page; the pane takes it). */
+    const revealed = new RevealedProject();
     /** The injected business face, identical for whichever session mounts it. */
     const face = (sessionId) => ({
         listProjects: () => remote.listProjects(),
@@ -91,6 +94,7 @@ export async function apply(ctx) {
         latestActivity: () => remote.latestActivity(),
         boundTarget: () => remote.boundTarget(sessionId),
         bindTarget: binding => remote.bindTarget(sessionId, { binding }),
+        revealed,
         sendMessage: text => {
             const input = inputFor(sessionId);
             if (input?.submit === undefined)
@@ -145,12 +149,13 @@ export async function apply(ctx) {
     }, 'library: tab type visibility');
     // Reveal the library beside the conversation that just started using it: a
     // library tool from the on-screen session wrote (a project created, a book
-    // shelved, a path drafted) → open the 图书馆 tab, once per session per page
-    // load, so closing it again sticks. The first read is the baseline (writes
+    // shelved, a path drafted) → open the 图书馆 tab on the session's bound
+    // project (the write bound it), once per session per page load, so closing
+    // it again sticks. The first read is the baseline (writes
     // from before this page loaded never open anything). Degrades to nothing
     // without the sidebar surface or the host half.
     ctx.effect(() => {
-        const revealed = new Set();
+        const revealedSessions = new Set();
         let baseline;
         let primed = false;
         const poll = () => {
@@ -169,15 +174,22 @@ export async function apply(ctx) {
                     return;
                 baseline = write.at;
                 const main = mainSessionId(ctx.sessions.list.getSnapshot());
-                if (main === undefined || String(main) !== write.id || revealed.has(write.id) || !tabVisibility.show(main))
+                if (main === undefined || String(main) !== write.id || revealedSessions.has(write.id) || !tabVisibility.show(main))
                     return;
-                revealed.add(write.id);
-                try {
-                    ctx.get('sidebarRight')?.openTab?.(LIBRARY_KIND);
-                }
-                catch {
-                    // No on-screen sidebar surface: nothing to reveal.
-                }
+                revealedSessions.add(write.id);
+                const open = () => {
+                    try {
+                        ctx.get('sidebarRight')?.openTab?.(LIBRARY_KIND);
+                    }
+                    catch {
+                        // No on-screen sidebar surface: nothing to reveal.
+                    }
+                };
+                // Land on the project the write bound; without a binding the tab opens on today.
+                void remote.boundTarget(main).then((bound) => {
+                    if (bound.ok && bound.value !== null)
+                        revealed.reveal(bound.value.projectId);
+                }, () => { }).finally(open);
             }, () => { });
         };
         poll();

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

@@ -0,0 +1,21 @@
+/**
+ * The project the pane should land on when the library reveals itself next to
+ * a conversation that just started using it (a project created, a book
+ * shelved). The reveal effect sets it from the session's binding before it
+ * opens the tab; the pane takes it once — on mount, or at once when the tab
+ * is already open — so closing and reopening the tab later starts from today
+ * again instead of being pulled back to the project.
+ * @module @khorsheed/dsh-library/client/reveal
+ */
+/** One-shot hand-off from the reveal effect to the pane. */
+export declare class RevealedProject {
+    private pending;
+    private readonly listeners;
+    /** Ask the pane to open this project; a mounted pane is told at once. */
+    reveal(projectId: string): void;
+    /** The project to open, cleared as it is taken; undefined when nothing waits. */
+    take(): string | undefined;
+    /** Be told when a reveal arrives. */
+    subscribe(listener: () => void): () => void;
+}
+//# sourceMappingURL=reveal.d.ts.map

package/lib/types/client/reveal.js

@@ -0,0 +1,31 @@
+/**
+ * The project the pane should land on when the library reveals itself next to
+ * a conversation that just started using it (a project created, a book
+ * shelved). The reveal effect sets it from the session's binding before it
+ * opens the tab; the pane takes it once — on mount, or at once when the tab
+ * is already open — so closing and reopening the tab later starts from today
+ * again instead of being pulled back to the project.
+ * @module @khorsheed/dsh-library/client/reveal
+ */
+/** One-shot hand-off from the reveal effect to the pane. */
+export class RevealedProject {
+    pending;
+    listeners = new Set();
+    /** Ask the pane to open this project; a mounted pane is told at once. */
+    reveal(projectId) {
+        this.pending = projectId;
+        for (const listener of [...this.listeners])
+            listener();
+    }
+    /** The project to open, cleared as it is taken; undefined when nothing waits. */
+    take() {
+        const projectId = this.pending;
+        this.pending = undefined;
+        return projectId;
+    }
+    /** Be told when a reveal arrives. */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    }
+}

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

@@ -93,6 +93,8 @@ export type LibraryActions = {
     pop: (draft: LibraryState) => void;
     /** Back to today. */
     home: (draft: LibraryState) => void;
+    /** Land on a project's page with today under it, so 「‹」 returns home (the reveal on a first write). */
+    openProject: (draft: LibraryState, projectId: string) => void;
     refresh: (draft: LibraryState) => void;
     /** Remember a station's 章节考 settings. */
     setQuizSettings: (draft: LibraryState, key: string, settings: LibraryQuizSettings) => void;

package/lib/types/client/store.js

@@ -27,6 +27,10 @@ export function createLibraryStore() {
                 d.stack = [TODAY];
                 d.rev += 1;
             },
+            openProject: (d, projectId) => {
+                d.stack = [TODAY, { view: 'project', projectId }];
+                d.rev += 1;
+            },
             refresh: (d) => { d.rev += 1; },
             setQuizSettings: (d, key, settings) => { d.quiz[key] = { ...d.quiz[key], settings }; },
             setQuizAsk: (d, key, ask) => {

package/lib/types/tools/resource.js

@@ -13,7 +13,7 @@ export function libraryResourceTool(kit) {
     return defineTool({
         name: 'library_textbook',
         description: 'Shelve, correct, reorder or remove a textbook (anything with a contents) — in study order. origin: learner (their own) | picked (a book or course you chose; its path takes only the chapters the goal needs) | authored (you write it: one chapter per lesson, your 讲义 are its text). '
-            + 'A real book: verify the edition and contents online and cite the page (tocSource { by: "web", url }); never ask for an upload. A correction (resourceId) sends only what changes. A web page a station cites is no textbook — the path names its url.',
+            + 'A real book: verify the edition and contents online and cite the page (tocSource { by: "web", url }) — search the title with its author or ISBN, narrowed with site: to catalog or publisher pages (site:book.douban.com, site:worldcat.org, the publisher\'s domain), one query per edition to tell apart, never a " in a query; never ask for an upload. A correction (resourceId) sends only what changes. A web page a station cites is no textbook — the path names its url.',
         parameters: {
             ...scopeParams,
             op: { type: 'string', required: true, description: 'add | update | move | remove.' },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@khorsheed/dsh-library",
   "description": "Library and learning engine: project-organized close reading of registered books (no upload) — a per-book roadmap the coach drafts and the learner adopts, photographed pages whose marks become knowledge cards, cards that dedupe and track weakness, two-axis quizzes (what they target × what they rest on) and verdict-led unlocking — a Typert Remote data face, a right-Sidebar page tab, and the ./tool composition entry (library_read + one library_<noun> tool per write + library_assess) for agent presets",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -132,7 +132,7 @@
     "compat": {
       "minHost": "0.1.7-rc.1",
       "notes": "A page-type right-Sidebar tab (minted kind `library`) over a Typert Remote data face, plus the `./tool` composition entry (library_read / library_write / library_assess, the coaching prompt section and a per-turn bound-context line via systemPrompt.context) an agent preset names. Books are registered, never uploaded: the coach verifies the edition's contents on the web; nothing is parsed. State is plain `node:fs` under `$DSH_HOME/state/dsh-library` (atomic temp+rename, per-project lock, append-only JSONL ledgers) — never `ctx.fs`, the session-fenced sandbox (the reader precedent). Session bindings (project / book) are keyed by the calling agent's session id. The tab type self-hides on the preset-composition criterion (the canvas double check: root rows ∪ the current session's preset rows, `@khorsheed/dsh-library/tool`), fail-open on every unreadable path. Photos go through the probed `attachments` service (saveImage for sidebar uploads; readImage only for pages the project recorded), degrading to `unavailable` without it. The tool row's optional hideSections / denyTools quiet a focused preset's scope through scoped prompt sections and tools.restrict, skipping any name the composition does not hold.",
-      "verifiedHost": "0.2.1-rc.1"
+      "verifiedHost": "0.2.1-rc.3"
     }
   }
 }