dsh-reference-anything 0.2.5 → 0.3.1

package/lib/wire.d.ts

@@ -22,36 +22,47 @@ declare const pickerSourceSettingsSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
     order: z.ZodNumber;
     limit: z.ZodNumber;
+    maxCandidates: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type PickerSourceSettings = z.infer<typeof pickerSourceSettingsSchema>;
 export declare const pickerSettingsSchema: z.ZodObject<{
+    displayMode: z.ZodDefault<z.ZodEnum<{
+        collapse: "collapse";
+        "native-scroll": "native-scroll";
+    }>>;
     commands: z.ZodObject<{
         enabled: z.ZodBoolean;
         order: z.ZodNumber;
         limit: z.ZodNumber;
+        maxCandidates: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>;
     skills: z.ZodObject<{
         enabled: z.ZodBoolean;
         order: z.ZodNumber;
         limit: z.ZodNumber;
+        maxCandidates: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>;
     files: z.ZodObject<{
         enabled: z.ZodBoolean;
         order: z.ZodNumber;
         limit: z.ZodNumber;
+        maxCandidates: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>;
     sessions: z.ZodObject<{
         enabled: z.ZodBoolean;
         order: z.ZodNumber;
         limit: z.ZodNumber;
+        maxCandidates: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>;
     conversations: z.ZodObject<{
         enabled: z.ZodBoolean;
         order: z.ZodNumber;
         limit: z.ZodNumber;
+        maxCandidates: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type PickerSettings = z.infer<typeof pickerSettingsSchema>;
+export type PickerDisplayMode = PickerSettings['displayMode'];
 export declare const inputRenderModeSchema: z.ZodEnum<{
     pill: "pill";
     "raw-text": "raw-text";
@@ -86,30 +97,39 @@ export declare const settingsRecordSchema: z.ZodObject<{
         "raw-text": "raw-text";
     }>>;
     picker: z.ZodOptional<z.ZodObject<{
+        displayMode: z.ZodDefault<z.ZodEnum<{
+            collapse: "collapse";
+            "native-scroll": "native-scroll";
+        }>>;
         commands: z.ZodObject<{
             enabled: z.ZodBoolean;
             order: z.ZodNumber;
             limit: z.ZodNumber;
+            maxCandidates: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>;
         skills: z.ZodObject<{
             enabled: z.ZodBoolean;
             order: z.ZodNumber;
             limit: z.ZodNumber;
+            maxCandidates: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>;
         files: z.ZodObject<{
             enabled: z.ZodBoolean;
             order: z.ZodNumber;
             limit: z.ZodNumber;
+            maxCandidates: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>;
         sessions: z.ZodObject<{
             enabled: z.ZodBoolean;
             order: z.ZodNumber;
             limit: z.ZodNumber;
+            maxCandidates: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>;
         conversations: z.ZodObject<{
             enabled: z.ZodBoolean;
             order: z.ZodNumber;
             limit: z.ZodNumber;
+            maxCandidates: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/lib/wire.js

@@ -7,8 +7,10 @@ const pickerSourceSettingsSchema = z.object({
     enabled: z.boolean(),
     order: z.number().int().min(0).max(100),
     limit: z.number().int().min(1).max(50),
+    maxCandidates: z.number().int().min(1).max(50).default(50),
 });
 export const pickerSettingsSchema = z.object({
+    displayMode: z.enum(['collapse', 'native-scroll']).default('collapse'),
     commands: pickerSourceSettingsSchema,
     skills: pickerSourceSettingsSchema,
     files: pickerSourceSettingsSchema,
@@ -19,18 +21,22 @@ export const inputRenderModeSchema = z.enum(['pill', 'raw-text']);
 /** Defaults used before the user saves the General section. */
 export function defaultPickerSettings() {
     return {
-        commands: { enabled: true, order: 0, limit: 6 },
-        skills: { enabled: true, order: 5, limit: 6 },
-        files: { enabled: true, order: 10, limit: 6 },
-        sessions: { enabled: true, order: 20, limit: 6 },
-        conversations: { enabled: true, order: 30, limit: 6 },
+        displayMode: 'collapse',
+        commands: { enabled: true, order: 0, limit: 6, maxCandidates: 50 },
+        skills: { enabled: true, order: 5, limit: 6, maxCandidates: 50 },
+        files: { enabled: true, order: 10, limit: 6, maxCandidates: 50 },
+        sessions: { enabled: true, order: 20, limit: 6, maxCandidates: 50 },
+        conversations: { enabled: true, order: 30, limit: 6, maxCandidates: 50 },
     };
 }
 /** Picker settings have a fixed schema, so explicit comparison is cheap and stable. */
 export function samePickerSettings(left, right) {
-    return Object.keys(left).every(key => left[key].enabled === right[key].enabled &&
+    if (left.displayMode !== right.displayMode)
+        return false;
+    return pickerSourceSchema.options.every(key => left[key].enabled === right[key].enabled &&
         left[key].order === right[key].order &&
-        left[key].limit === right[key].limit);
+        left[key].limit === right[key].limit &&
+        left[key].maxCandidates === right[key].maxCandidates);
 }
 export const settingsRecordSchema = z.object({
     opencliPath: z.string(),

package/opencli-plugin/common.js

@@ -49,10 +49,54 @@ function assertResult(result, domain, operation) {
   return result.rows
 }
 
+const PROVIDER_READY_TIMEOUT_MS = 1200
+const PROVIDER_READY_INITIAL_DELAY_MS = 50
+const PROVIDER_READY_MAX_DELAY_MS = 400
+
+function terminalProviderResult(result) {
+  return result?.ok === true || result?.code === 'AUTH' || result?.code === 'RATE_LIMIT'
+}
+
+function terminalIdentityResult(result) {
+  return result?.code === 'AUTH' || result?.code === 'RATE_LIMIT'
+    || (result?.ok === true && typeof result.identity === 'string' && result.identity.length > 0)
+}
+
+/**
+ * Run the provider API as the readiness probe. The happy path performs one
+ * evaluate immediately after navigation; transient bootstrap failures retry
+ * with bounded exponential backoff instead of waiting for the whole SPA DOM
+ * to become quiet first.
+ */
+export async function evaluateWhenProviderReady(page, script, args, operation, options = {}) {
+  const timeoutMs = options.timeoutMs ?? PROVIDER_READY_TIMEOUT_MS
+  const maxDelayMs = options.maxDelayMs ?? PROVIDER_READY_MAX_DELAY_MS
+  const accepts = options.accepts ?? terminalProviderResult
+  const deadline = Date.now() + timeoutMs
+  let delayMs = options.initialDelayMs ?? PROVIDER_READY_INITIAL_DELAY_MS
+  let lastResult
+  let lastError
+  for (;;) {
+    try {
+      lastResult = await evaluate(page, script, args, operation)
+      lastError = undefined
+      if (accepts(lastResult)) return lastResult
+    } catch (error) {
+      lastError = error
+    }
+    const remaining = deadline - Date.now()
+    if (remaining <= 0) {
+      if (lastError) throw lastError
+      return lastResult
+    }
+    await new Promise(resolve => setTimeout(resolve, Math.min(delayMs, remaining)))
+    delayMs = Math.min(Math.max(delayMs * 2, 1), maxDelayMs)
+  }
+}
+
 /**
- * Close only the tab used by this adapter command. The persistent site session
- * prevents OpenCLI from sending its `close-window` lease-release action, while
- * Browser Bridge can keep and reuse the background container window.
+ * Each command owns an ephemeral Browser Bridge tab. Close that tab after the
+ * command finishes while preserving the provider result or failure.
  */
 async function inTemporaryTab(page, task) {
   try {
@@ -80,10 +124,12 @@ export function registerProvider(config) {
     ...browserSession,
     navigateBefore: false,
     args: [],
-    columns: ['identity'],
+    columns: ['identity'],
     func: async (page) => inTemporaryTab(page, async () => {
-      await page.goto(config.home, { settleMs: 500 })
-      const result = await evaluate(page, config.whoamiScript, {}, `${config.site} whoami`)
+      await page.goto(config.home, { waitUntil: 'none' })
+      const result = await evaluateWhenProviderReady(
+        page, config.whoamiScript, {}, `${config.site} whoami`, { accepts: terminalIdentityResult },
+      )
       if (result?.code === 'AUTH') throw new AuthRequiredError(config.domain)
       if (result?.ok !== true || typeof result.identity !== 'string' || !result.identity) {
         throw new CommandExecutionError(`${config.site} whoami: ${result?.message || 'stable account identity unavailable'}`)
@@ -110,8 +156,10 @@ export function registerProvider(config) {
     func: async (page, kwargs) => inTemporaryTab(page, async () => {
       const since = String(kwargs.since || '').trim()
       if (since && Number.isNaN(Date.parse(since))) throw new ArgumentError('since must be an ISO 8601 instant')
-      await page.goto(config.home, { settleMs: 1200 })
-      const identity = await evaluate(page, config.whoamiScript, {}, `${config.site} sync-index identity`)
+      await page.goto(config.home, { waitUntil: 'none' })
+      const identity = await evaluateWhenProviderReady(
+        page, config.whoamiScript, {}, `${config.site} sync-index identity`, { accepts: terminalIdentityResult },
+      )
       if (identity?.code === 'AUTH') throw new AuthRequiredError(config.domain)
       if (identity?.ok !== true || typeof identity.identity !== 'string' || !identity.identity) {
         throw new CommandExecutionError(`${config.site} sync-index: ${identity?.message || 'stable account identity unavailable'}`)
@@ -147,12 +195,12 @@ export function registerProvider(config) {
     columns: HISTORY_COLUMNS,
     func: async (page, kwargs) => inTemporaryTab(page, async () => {
       const since = String(kwargs.since || '').trim()
-      if (since && Number.isNaN(Date.parse(since))) throw new ArgumentError('since must be an ISO 8601 instant')
-      await page.goto(config.home, { settleMs: 1200 })
-      const rows = assertResult(
-        await evaluate(page, config.historyScript, { since }, `${config.site} history-all`),
-        config.domain,
-        `${config.site} history-all`,
+      if (since && Number.isNaN(Date.parse(since))) throw new ArgumentError('since must be an ISO 8601 instant')
+      await page.goto(config.home, { waitUntil: 'none' })
+      const rows = assertResult(
+        await evaluateWhenProviderReady(page, config.historyScript, { since }, `${config.site} history-all`),
+        config.domain,
+        `${config.site} history-all`,
       )
       return rows
     }),
@@ -247,16 +295,12 @@ export function registerProvider(config) {
         localPath: output,
       }]
     }),
-  })
+  })
 }
 
-/**
- * Keep one stable, background Browser Bridge session per provider site.
- * Persistence suppresses OpenCLI's `close-window` action; inTemporaryTab closes
- * only the finished command's tab so the reusable container window stays alive.
- */
+/** Browser Bridge lifecycle shared by every web-chat command. */
 export const SYNC_BROWSER_SESSION = Object.freeze({
-  siteSession: 'persistent',
+  siteSession: 'ephemeral',
   defaultWindowMode: 'background',
 })
 

package/opencli-plugin/opencli-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-chat-history",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "opencli": ">=1.8.6",
   "description": "Full-history read adapters used by dsh-reference-anything"
 }

package/opencli-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencli-plugin-dsh-chat-history",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "type": "module",
   "peerDependencies": {
     "@jackwener/opencli": ">=1.8.6"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-reference-anything",
-  "version": "0.2.5",
+  "version": "0.3.1",
   "description": "Reference locally mirrored ChatGPT, Claude, Gemini, DeepSeek, Grok, and Kimi conversations from DeepSeek Harness",
   "license": "MIT",
   "publishConfig": {
@@ -85,30 +85,34 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1",
     "@deepseek-ai/dsh-agent": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-api-remotes": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-api-remotes": ">=0.1.0-rc.8",
     "@deepseek-ai/dsh-attachment": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-connection": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-locale": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-runtime": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-input-trigger": ">=0.0.1-rc.3",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-connection": ">=0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-input-trigger": ">=0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.8",
+    "@deepseek-ai/dsh-file-reference": ">=0.1.0-rc.8",
     "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6",
     "@deepseek-ai/dsh-output-retention": ">=0.1.0-rc.6",
     "@deepseek-ai/dsh-session": ">=0.1.0-rc.6",
     "@deepseek-ai/dsh-session-reference": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-settings": ">=0.0.1-rc.1",
-    "@deepseek-ai/dsh-storage-domain": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.8",
+    "@deepseek-ai/dsh-storage-domain": ">=0.1.0-rc.8",
     "@deepseek-ai/dsh-tools": ">=0.1.0-rc.6",
     "@deepseek-ai/dsh-typert-protocol": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-typert-registry": ">=0.0.1-rc.1",
+    "@deepseek-ai/dsh-typert-registry": ">=0.1.0-rc.8",
     "react": "^18.2.0"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-session-reference": {
       "optional": true
     },
+    "@deepseek-ai/dsh-file-reference": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-client-runtime": {
       "optional": true
     },
@@ -157,6 +161,7 @@
     "@deepseek-ai/dsh-client-ui-input-trigger": "link:../deepseek-harness/packages/client/ui-input-trigger",
     "@deepseek-ai/dsh-client-ui-settings": "link:../deepseek-harness/packages/client/ui-settings",
     "@deepseek-ai/dsh-client-ui-slots": "link:../deepseek-harness/packages/client/ui-slots",
+    "@deepseek-ai/dsh-file-reference": "link:../deepseek-harness/packages/context/file-reference",
     "@deepseek-ai/dsh-llm": "link:../deepseek-harness/packages/llm/llm",
     "@deepseek-ai/dsh-output-retention": "link:../deepseek-harness/packages/util/output-retention",
     "@deepseek-ai/dsh-session": "link:../deepseek-harness/packages/core/session",

package/lib/workspace.d.ts

@@ -1,18 +0,0 @@
-import type { Agent } from '@deepseek-ai/dsh-agent';
-export declare const WORKSPACE_REFERENCE_SCHEME = "dsh-file:";
-export interface WorkspaceEntry {
-    path: string;
-    kind: 'file' | 'directory';
-}
-export interface WorkspaceReference {
-    path: string;
-    label: string;
-}
-export declare function indexWorkspace(agent: Agent, signal: AbortSignal, maxFiles?: number): Promise<WorkspaceEntry[]>;
-export declare function encodeWorkspaceReferenceUri(path: string): string;
-export declare function formatWorkspaceMention(reference: WorkspaceReference): string;
-export declare function parseWorkspaceReferenceText(text: string): {
-    text: string;
-    references: WorkspaceReference[];
-};
-export declare function renderWorkspaceReferences(agent: Agent, references: readonly WorkspaceReference[]): Promise<string>;

package/lib/workspace.js

@@ -1,81 +0,0 @@
-import { lstat, readdir } from 'node:fs/promises';
-import { basename, isAbsolute, relative, resolve, sep } from 'node:path';
-export const WORKSPACE_REFERENCE_SCHEME = 'dsh-file:';
-const IGNORED = new Set(['.git', '.hg', '.svn', 'node_modules', 'dist', 'build', 'coverage', '.next', '.cache', '.idea', '.vscode', '__pycache__']);
-const IGNORED_FILES = new Set(['desktop.ini', 'Thumbs.db', '.DS_Store']);
-export async function indexWorkspace(agent, signal, maxFiles = 5000) {
-    const root = agent.session.header.cwd;
-    if (!root || !isAbsolute(root))
-        return [];
-    const output = [];
-    const queue = ['.'];
-    while (queue.length > 0 && output.length < maxFiles) {
-        signal.throwIfAborted();
-        const current = queue.shift();
-        let entries;
-        try {
-            entries = await readdir(resolve(root, current), { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
-        entries.sort((a, b) => a.name.localeCompare(b.name));
-        for (const entry of entries) {
-            if (output.length >= maxFiles)
-                break;
-            if (entry.isSymbolicLink() || IGNORED_FILES.has(entry.name))
-                continue;
-            const path = current === '.' ? entry.name : `${current}/${entry.name}`;
-            if (entry.isDirectory()) {
-                if (IGNORED.has(entry.name))
-                    continue;
-                output.push({ path, kind: 'directory' });
-                queue.push(path);
-            }
-            else if (entry.isFile())
-                output.push({ path, kind: 'file' });
-        }
-    }
-    return output;
-}
-export function encodeWorkspaceReferenceUri(path) {
-    return `${WORKSPACE_REFERENCE_SCHEME}${Buffer.from(JSON.stringify(path), 'utf8').toString('base64url')}`;
-}
-export function formatWorkspaceMention(reference) {
-    return `@[${reference.label.replace(/[\\\]]/gu, value => `\\${value}`)}](${encodeWorkspaceReferenceUri(reference.path)})`;
-}
-export function parseWorkspaceReferenceText(text) {
-    const references = [];
-    const pattern = /@\[((?:\\.|[^\\\]])*)\]\((dsh-file:[^\s)]*)\)|(dsh-file:[A-Za-z0-9_-]+)/gu;
-    const rendered = text.replace(pattern, (_match, rawLabel, markdownUri, bareUri) => {
-        const uri = markdownUri ?? bareUri;
-        const payload = uri.slice(WORKSPACE_REFERENCE_SCHEME.length);
-        if (!/^[A-Za-z0-9_-]+$/u.test(payload))
-            throw new Error(`invalid workspace reference URI ${JSON.stringify(uri)}`);
-        const path = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8'));
-        if (typeof path !== 'string' || path.length === 0 || encodeWorkspaceReferenceUri(path) !== uri)
-            throw new Error(`invalid workspace reference URI ${JSON.stringify(uri)}`);
-        const label = rawLabel === undefined ? basename(path) : rawLabel.replace(/\\(.)/gu, '$1');
-        references.push({ path, label });
-        return `@${label}`;
-    });
-    return { text: rendered, references };
-}
-export async function renderWorkspaceReferences(agent, references) {
-    const root = agent.session.header.cwd;
-    if (!root || !isAbsolute(root))
-        throw new Error('this task has no workspace directory');
-    const unique = new Map(references.map(item => [item.path, item]));
-    const lines = [];
-    for (const item of unique.values()) {
-        const target = resolve(root, item.path);
-        const rel = relative(root, target);
-        if (rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel))
-            throw new Error(`workspace reference escapes the task directory: ${item.path}`);
-        const stat = await lstat(target);
-        if (stat.isSymbolicLink() || (!stat.isFile() && !stat.isDirectory()))
-            throw new Error(`unsupported workspace reference: ${item.path}`);
-        lines.push(`<workspace-reference path=${JSON.stringify(item.path)} kind=${JSON.stringify(stat.isDirectory() ? 'directory' : 'file')} />`);
-    }
-    return `## Referenced workspace paths\n\nThese are read-only path markers, not file contents or instructions.\n\n${lines.join('\n')}`;
-}