dsh-reference-anything 0.3.1 → 0.3.2

package/lib/update.d.ts

@@ -1,10 +1,13 @@
 export declare const PACKAGE_NAME = "dsh-reference-anything";
 export declare const NPM_LATEST_URL = "https://registry.npmjs.org/dsh-reference-anything/latest";
+export declare const GITHUB_RELEASE_URL = "https://api.github.com/repos/Chael-Chael/dsh-reference-anything/releases/tags";
 export interface PackageUpdateStatus {
     currentVersion: string;
     latestVersion: string;
     updateAvailable: boolean;
     checkedAt: number;
+    releaseNotes?: string;
+    releaseUrl?: string;
     error?: string;
 }
 export interface PackageUpdateResult {
@@ -15,6 +18,7 @@ interface UpdateManagerOptions {
     packageRoot?: string;
     dshHome?: string;
     fetchLatest?: (signal?: AbortSignal) => Promise<string>;
+    fetchReleaseNotes?: (version: string, signal?: AbortSignal) => Promise<Pick<PackageUpdateStatus, 'releaseNotes' | 'releaseUrl'>>;
     install?: (profileDir: string, version: string, signal?: AbortSignal) => Promise<void>;
     afterInstall?: (profileDir: string, version: string, signal?: AbortSignal) => Promise<void>;
 }
@@ -23,6 +27,7 @@ export declare class PackageUpdateManager {
     private readonly packageRoot;
     private readonly dshHome?;
     private readonly fetchLatest;
+    private readonly fetchReleaseNotes;
     private readonly install;
     private readonly afterInstall?;
     private cached?;
@@ -37,6 +42,7 @@ export declare class PackageUpdateManager {
     private runCheck;
 }
 export declare function fetchLatestVersion(signal?: AbortSignal): Promise<string>;
+export declare function fetchGitHubReleaseNotes(version: string, signal?: AbortSignal): Promise<Pick<PackageUpdateStatus, 'releaseNotes' | 'releaseUrl'>>;
 export declare function readPackageVersion(packageRoot?: string): Promise<string>;
 /** Find the profile that owns this exact installed package, including pnpm links. */
 export declare function findOwningProfileDir(packageRoot?: string, configuredDshHome?: string): Promise<string>;

package/lib/update.js

@@ -7,6 +7,7 @@ import { promisify } from 'node:util';
 const execFile = promisify(nodeExecFile);
 export const PACKAGE_NAME = 'dsh-reference-anything';
 export const NPM_LATEST_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+export const GITHUB_RELEASE_URL = 'https://api.github.com/repos/Chael-Chael/dsh-reference-anything/releases/tags';
 const PACKAGE_ROOT = resolve(fileURLToPath(new URL('../', import.meta.url)));
 const UPDATE_TIMEOUT_MS = 5 * 60_000;
 const CHECK_TIMEOUT_MS = 10_000;
@@ -15,6 +16,7 @@ export class PackageUpdateManager {
     packageRoot;
     dshHome;
     fetchLatest;
+    fetchReleaseNotes;
     install;
     afterInstall;
     cached;
@@ -23,6 +25,7 @@ export class PackageUpdateManager {
         this.packageRoot = resolve(options.packageRoot ?? PACKAGE_ROOT);
         this.dshHome = options.dshHome;
         this.fetchLatest = options.fetchLatest ?? fetchLatestVersion;
+        this.fetchReleaseNotes = options.fetchReleaseNotes ?? fetchGitHubReleaseNotes;
         this.install = options.install ?? installPackageVersion;
         this.afterInstall = options.afterInstall;
     }
@@ -60,6 +63,8 @@ export class PackageUpdateManager {
             latestVersion: status.latestVersion,
             updateAvailable: false,
             checkedAt: Date.now(),
+            releaseNotes: status.releaseNotes,
+            releaseUrl: status.releaseUrl,
         };
         return { version: status.latestVersion, restartRequired: true };
     }
@@ -69,11 +74,18 @@ export class PackageUpdateManager {
         try {
             currentVersion = await readPackageVersion(this.packageRoot);
             const latestVersion = await this.fetchLatest(signal);
+            const updateAvailable = compareVersions(latestVersion, currentVersion) > 0;
+            let release = {};
+            try {
+                release = await this.fetchReleaseNotes(latestVersion, signal);
+            }
+            catch { /* Release notes are advisory. */ }
             const status = {
                 currentVersion,
                 latestVersion,
-                updateAvailable: compareVersions(latestVersion, currentVersion) > 0,
+                updateAvailable,
                 checkedAt,
+                ...release,
             };
             this.cached = status;
             return status;
@@ -107,6 +119,22 @@ export async function fetchLatestVersion(signal) {
         throw new Error('npm registry returned an invalid version');
     return body.version;
 }
+export async function fetchGitHubReleaseNotes(version, signal) {
+    if (!isVersion(version))
+        throw new Error('refusing to request an invalid release version');
+    const timeout = AbortSignal.timeout(CHECK_TIMEOUT_MS);
+    const response = await fetch(`${GITHUB_RELEASE_URL}/v${version}`, {
+        headers: { accept: 'application/vnd.github+json', 'user-agent': PACKAGE_NAME, 'x-github-api-version': '2022-11-28' },
+        signal: signal ? AbortSignal.any([signal, timeout]) : timeout,
+    });
+    if (!response.ok)
+        throw new Error(`GitHub returned HTTP ${String(response.status)}`);
+    const body = await response.json();
+    return {
+        releaseNotes: typeof body.body === 'string' ? body.body.trim().slice(0, 12_000) || undefined : undefined,
+        releaseUrl: typeof body.html_url === 'string' ? body.html_url : undefined,
+    };
+}
 export async function readPackageVersion(packageRoot = PACKAGE_ROOT) {
     const manifest = await readJson(join(packageRoot, 'package.json'));
     if (typeof manifest.version !== 'string' || !isVersion(manifest.version))

package/lib/web.js

@@ -1,7 +1,11 @@
 import { ReferenceAnythingRemote } from "./host.js";
 import { TYPERT_MANIFEST } from "./typert.js";
 export const name = 'reference-anything-web';
-export const inject = ['typert', 'referenceChatHistory'];
+// `referenceCloudDrive` is consumed lazily by ReferenceAnythingRemote when the
+// composer asks for @drive candidates. Declare it here so Cordis exposes the
+// sibling service in this plugin scope instead of making driveSearch silently
+// look like an unconfigured installation.
+export const inject = ['typert', 'referenceChatHistory', 'openListManager', 'referenceCloudDrive'];
 export function apply(ctx) {
     new ReferenceAnythingRemote(ctx);
     ctx.effect(() => {

package/lib/wire.d.ts

@@ -10,12 +10,33 @@ export declare const providerSchema: z.ZodEnum<{
 }>;
 export type ChatProvider = z.infer<typeof providerSchema>;
 export declare const ALL_PROVIDERS: readonly ChatProvider[];
+export declare const localAgentSchema: z.ZodEnum<{
+    kimi: "kimi";
+    "claude-code": "claude-code";
+    codex: "codex";
+    cursor: "cursor";
+    qoder: "qoder";
+    reasonix: "reasonix";
+    openclaw: "openclaw";
+    grokbuild: "grokbuild";
+    hermes: "hermes";
+    "gemini-cli": "gemini-cli";
+    pi: "pi";
+    opencode: "opencode";
+    mimocode: "mimocode";
+    zcode: "zcode";
+}>;
+export type LocalAgent = z.infer<typeof localAgentSchema>;
+export declare const ALL_LOCAL_AGENTS: readonly LocalAgent[];
+export declare const LOCAL_AGENT_LABEL: Readonly<Record<LocalAgent, string>>;
 export declare const pickerSourceSchema: z.ZodEnum<{
     commands: "commands";
     skills: "skills";
     files: "files";
     sessions: "sessions";
+    agents: "agents";
     conversations: "conversations";
+    drives: "drives";
 }>;
 export type PickerSource = z.infer<typeof pickerSourceSchema>;
 declare const pickerSourceSettingsSchema: z.ZodObject<{
@@ -54,12 +75,24 @@ export declare const pickerSettingsSchema: z.ZodObject<{
         limit: z.ZodNumber;
         maxCandidates: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>;
+    agents: z.ZodDefault<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>;
+    drives: z.ZodDefault<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'];
@@ -75,6 +108,7 @@ export declare function samePickerSettings(left: PickerSettings, right: PickerSe
 export declare const settingsRecordSchema: z.ZodObject<{
     opencliPath: z.ZodString;
     profile: z.ZodString;
+    cloudDriveDownloadDirectory: z.ZodDefault<z.ZodString>;
     detailConcurrency: z.ZodNumber;
     autoSync: z.ZodDefault<z.ZodBoolean>;
     syncOnStartup: z.ZodDefault<z.ZodBoolean>;
@@ -83,6 +117,7 @@ export declare const settingsRecordSchema: z.ZodObject<{
         "metadata-only": "metadata-only";
         "offline-mirror": "offline-mirror";
     }>>;
+    syncHistoryDays: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
     enabledProviders: z.ZodDefault<z.ZodArray<z.ZodEnum<{
         chatgpt: "chatgpt";
         claude: "claude";
@@ -91,6 +126,39 @@ export declare const settingsRecordSchema: z.ZodObject<{
         grok: "grok";
         kimi: "kimi";
     }>>>;
+    enabledAgents: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        kimi: "kimi";
+        "claude-code": "claude-code";
+        codex: "codex";
+        cursor: "cursor";
+        qoder: "qoder";
+        reasonix: "reasonix";
+        openclaw: "openclaw";
+        grokbuild: "grokbuild";
+        hermes: "hermes";
+        "gemini-cli": "gemini-cli";
+        pi: "pi";
+        opencode: "opencode";
+        mimocode: "mimocode";
+        zcode: "zcode";
+    }>>>;
+    agentDirectories: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        kimi: "kimi";
+        "claude-code": "claude-code";
+        codex: "codex";
+        cursor: "cursor";
+        qoder: "qoder";
+        reasonix: "reasonix";
+        openclaw: "openclaw";
+        grokbuild: "grokbuild";
+        hermes: "hermes";
+        "gemini-cli": "gemini-cli";
+        pi: "pi";
+        opencode: "opencode";
+        mimocode: "mimocode";
+        zcode: "zcode";
+    }> & z.core.$partial, z.ZodString>>;
+    enabledDriveMounts: z.ZodOptional<z.ZodArray<z.ZodString>>;
     maxReadTurns: z.ZodDefault<z.ZodNumber>;
     inputRenderMode: z.ZodDefault<z.ZodEnum<{
         pill: "pill";
@@ -125,12 +193,24 @@ export declare const settingsRecordSchema: z.ZodObject<{
             limit: z.ZodNumber;
             maxCandidates: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>;
+        agents: z.ZodDefault<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>;
+        drives: z.ZodDefault<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>;
 export type SettingsRecord = z.infer<typeof settingsRecordSchema>;

package/lib/wire.js

@@ -2,7 +2,14 @@
 import { z } from 'zod';
 export const providerSchema = z.enum(['chatgpt', 'claude', 'gemini', 'deepseek', 'grok', 'kimi']);
 export const ALL_PROVIDERS = providerSchema.options;
-export const pickerSourceSchema = z.enum(['commands', 'skills', 'files', 'sessions', 'conversations']);
+export const localAgentSchema = z.enum(['claude-code', 'codex', 'cursor', 'qoder', 'reasonix', 'openclaw', 'kimi', 'grokbuild', 'hermes', 'gemini-cli', 'pi', 'opencode', 'mimocode', 'zcode']);
+export const ALL_LOCAL_AGENTS = localAgentSchema.options;
+export const LOCAL_AGENT_LABEL = {
+    'claude-code': 'Claude Code', codex: 'Codex', cursor: 'Cursor', qoder: 'Qoder', reasonix: 'Reasonix',
+    openclaw: 'OpenClaw', kimi: 'Kimi', grokbuild: 'Grok Build', hermes: 'Hermes', 'gemini-cli': 'Gemini CLI',
+    pi: 'Pi', opencode: 'opencode', mimocode: 'mimocode', zcode: 'zcode',
+};
+export const pickerSourceSchema = z.enum(['commands', 'skills', 'files', 'sessions', 'agents', 'conversations', 'drives']);
 const pickerSourceSettingsSchema = z.object({
     enabled: z.boolean(),
     order: z.number().int().min(0).max(100),
@@ -15,7 +22,15 @@ export const pickerSettingsSchema = z.object({
     skills: pickerSourceSettingsSchema,
     files: pickerSourceSettingsSchema,
     sessions: pickerSourceSettingsSchema,
+    // Defaulted, unlike its neighbours, because this key arrived after settings
+    // were already on disk. `settingsRecordSchema` is the durable read boundary:
+    // a saved record that has `picker` but predates this key would fail the whole
+    // parse without it, and the medium — every setting in it — would be rejected.
+    // Any key added here from now on needs the same treatment.
+    agents: pickerSourceSettingsSchema.default({ enabled: true, order: 25, limit: 6, maxCandidates: 50 }),
     conversations: pickerSourceSettingsSchema,
+    // Defaulted for the same reason as `agents` above: it arrived later still.
+    drives: pickerSourceSettingsSchema.default({ enabled: true, order: 35, limit: 6, maxCandidates: 50 }),
 });
 export const inputRenderModeSchema = z.enum(['pill', 'raw-text']);
 /** Defaults used before the user saves the General section. */
@@ -26,7 +41,9 @@ export function defaultPickerSettings() {
         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 },
+        agents: { enabled: true, order: 25, limit: 6, maxCandidates: 50 },
         conversations: { enabled: true, order: 30, limit: 6, maxCandidates: 50 },
+        drives: { enabled: true, order: 35, limit: 6, maxCandidates: 50 },
     };
 }
 /** Picker settings have a fixed schema, so explicit comparison is cheap and stable. */
@@ -41,12 +58,24 @@ export function samePickerSettings(left, right) {
 export const settingsRecordSchema = z.object({
     opencliPath: z.string(),
     profile: z.string(),
+    /** Empty keeps the original system-temporary-directory behavior. */
+    cloudDriveDownloadDirectory: z.string().max(4096).default(''),
     detailConcurrency: z.number().int().min(1).max(8),
     autoSync: z.boolean().default(false),
     syncOnStartup: z.boolean().default(false),
     autoSyncMinutes: z.number().int().min(15).max(1440).default(60),
     historyMode: z.enum(['metadata-only', 'offline-mirror']).default('metadata-only'),
+    /** Null keeps all web-chat history; old settings default to that upgrade-safe behavior. */
+    syncHistoryDays: z.number().int().min(1).max(36500).nullable().default(null),
     enabledProviders: z.array(providerSchema).default([...ALL_PROVIDERS]),
+    enabledAgents: z.array(localAgentSchema).default([...ALL_LOCAL_AGENTS]),
+    /** One optional additional transcript root per local Agent. */
+    agentDirectories: z.partialRecord(localAgentSchema, z.string().max(4096)).optional(),
+    /**
+     * OpenList mount paths shown by the drive picker. Undefined preserves the
+     * legacy behaviour (all enabled mounts); an explicit empty array means none.
+     */
+    enabledDriveMounts: z.array(z.string().startsWith('/')).optional(),
     maxReadTurns: z.number().int().min(1).max(100).default(10),
     inputRenderMode: inputRenderModeSchema.default('pill'),
     // Optional keeps existing on-disk settings forward-compatible. The client

package/opencli-plugin/chatgpt.js

@@ -1,23 +1,23 @@
-import { domFallbackScript, registerProvider, sinceGuardSource } from './common.js'
-// OpenCLI discovery marker: registerProvider below performs the cli() calls.
-
-export const timestampSource = String.raw`value => {
-  if (value === undefined || value === null || value === '') return ''
-  if (typeof value === 'string' && Number.isNaN(Number(value))) {
-    const parsed = Date.parse(value)
-    return Number.isNaN(parsed) ? '' : new Date(parsed).toISOString()
-  }
-  const numeric = Number(value)
-  if (!Number.isFinite(numeric) || numeric <= 0) return ''
-  const milliseconds = numeric < 1e11 ? numeric * 1000
-    : numeric < 1e14 ? numeric : numeric < 1e17 ? numeric / 1000 : numeric / 1e6
-  const date = new Date(milliseconds)
-  return Number.isNaN(date.getTime()) ? '' : date.toISOString()
-}`
-
-export const historyScript = String.raw`async function (args) {
-  const stopEarly = (${sinceGuardSource})(args && args.since)
-  const toIso = (${timestampSource})
+import { domFallbackScript, registerProvider, sinceGuardSource } from './common.js'
+// OpenCLI discovery marker: registerProvider below performs the cli() calls.
+
+export const timestampSource = String.raw`value => {
+  if (value === undefined || value === null || value === '') return ''
+  if (typeof value === 'string' && Number.isNaN(Number(value))) {
+    const parsed = Date.parse(value)
+    return Number.isNaN(parsed) ? '' : new Date(parsed).toISOString()
+  }
+  const numeric = Number(value)
+  if (!Number.isFinite(numeric) || numeric <= 0) return ''
+  const milliseconds = numeric < 1e11 ? numeric * 1000
+    : numeric < 1e14 ? numeric : numeric < 1e17 ? numeric / 1000 : numeric / 1e6
+  const date = new Date(milliseconds)
+  return Number.isNaN(date.getTime()) ? '' : date.toISOString()
+}`
+
+export const historyScript = String.raw`async function (args) {
+  const stopEarly = (${sinceGuardSource})(args && args.since)
+  const toIso = (${timestampSource})
   const fallback = () => Array.from(document.querySelectorAll('a[href*="/c/"]')).map((a, i) => {
     const match = a.href.match(/\/c\/([^/?#]+)/)
     return match ? { provider: 'chatgpt', accountScope: '', id: match[1], title: (a.innerText || a.textContent || 'Untitled').trim(), url: a.href, createdAt: '', updatedAt: '', messageCount: '', cursor: '', partial: true } : null
@@ -40,8 +40,8 @@ export const historyScript = String.raw`async function (args) {
       for (const item of items) rows.push({
         provider: 'chatgpt', accountScope: '', id: String(item.id), title: item.title || 'Untitled Conversation',
         url: location.origin + '/c/' + item.id,
-        createdAt: toIso(item.create_time),
-        updatedAt: toIso(item.update_time),
+        createdAt: toIso(item.create_time),
+        updatedAt: toIso(item.update_time),
         messageCount: item.message_count || item.messageCount || '', cursor: '', partial: false,
       })
       if (items.length < 100) return JSON.stringify({ ok: true, rows })
@@ -110,16 +110,19 @@ const detailScript = String.raw`async function (args) {
   }
 }`
 
-registerProvider({
-  site: 'dsh-chatgpt', provider: 'ChatGPT', domain: 'chatgpt.com', home: 'https://chatgpt.com/',
-  conversationUrl: id => `https://chatgpt.com/c/${encodeURIComponent(id)}`,
-  whoamiScript: String.raw`async function () {
+export const whoamiScript = String.raw`async function () {
     const response = await fetch('/api/auth/session', { credentials: 'include' })
     if (response.status === 401 || response.status === 403) return JSON.stringify({ ok: false, code: 'AUTH' })
+    if (response.status === 429) return JSON.stringify({ ok: false, code: 'RATE_LIMIT' })
     if (!response.ok) return JSON.stringify({ ok: false, message: 'session HTTP ' + response.status })
     const payload = await response.json(); const user = payload.user || payload.account || {}
     const identity = String(user.id || user.account_id || user.email || '')
     return JSON.stringify({ ok: Boolean(identity), identity, code: identity ? undefined : 'AUTH' })
-  }`,
+  }`
+
+registerProvider({
+  site: 'dsh-chatgpt', provider: 'ChatGPT', domain: 'chatgpt.com', home: 'https://chatgpt.com/',
+  conversationUrl: id => `https://chatgpt.com/c/${encodeURIComponent(id)}`,
+  whoamiScript,
   historyScript, detailScript, fallbackScript: domFallbackScript,
 })

package/opencli-plugin/claude.js

@@ -119,16 +119,20 @@ const detailScript = String.raw`async function (args) {
   }
 }`
 
+export const whoamiScript = String.raw`async function () {
+  const response = await fetch('/api/account', { credentials: 'include', headers: { Accept: 'application/json' } })
+  if (response.status === 401 || response.status === 403) return JSON.stringify({ ok: false, code: 'AUTH' })
+  if (response.status === 429) return JSON.stringify({ ok: false, code: 'RATE_LIMIT' })
+  if (!response.ok) return JSON.stringify({ ok: false, message: 'account HTTP ' + response.status })
+  const payload = await response.json()
+  const identity = typeof payload.email_address === 'string' ? payload.email_address.trim() : ''
+  if (!identity) return JSON.stringify({ ok: false, message: 'Claude stable account identity unavailable' })
+  return JSON.stringify({ ok: true, identity })
+}`
+
 registerProvider({
   site: 'dsh-claude', provider: 'Claude', domain: 'claude.ai', home: 'https://claude.ai/',
   conversationUrl: id => `https://claude.ai/chat/${encodeURIComponent(id)}`,
-  whoamiScript: String.raw`async function () {
-    const response = await fetch('/api/organizations', { credentials: 'include' })
-    if (response.status === 401 || response.status === 403) return JSON.stringify({ ok: false, code: 'AUTH' })
-    if (!response.ok) return JSON.stringify({ ok: false, message: 'organizations HTTP ' + response.status })
-    const payload = await response.json(); const values = Array.isArray(payload) ? payload : payload.organizations || []
-    const item = values.find(value => value && (value.uuid || value.id)); const identity = String(item && (item.uuid || item.id) || '')
-    return JSON.stringify({ ok: Boolean(identity), identity, code: identity ? undefined : 'AUTH' })
-  }`,
+  whoamiScript,
   historyScript, detailScript, fallbackScript: domFallbackScript,
 })