dsh-reference-anything 0.4.3 → 0.5.0

package/lib/uri.d.ts

@@ -1,16 +1,7 @@
-/**
- * Canonical `dsh-ref:` URI and the inline mention that carries it.
- *
- * A reference is two opaque strings, either of which may contain any character
- * a JavaScript string can hold. JSON-encoding the pair before base64url means
- * quotes, slashes, backslashes, newlines, and astral characters all survive
- * without a delimiter the payload could itself spell.
- *
- * @module dsh-reference-anything/uri
- */
 import type { ReferenceInput, ReferenceRef } from './types.ts';
 import { encodeReferenceUri, REFERENCE_SCHEME } from './uri-codec.ts';
 export { encodeReferenceUri, REFERENCE_SCHEME };
+export declare function referenceReadHandle(ref: ReferenceRef): string;
 /**
  * Decode one canonical reference URI.
  *

package/lib/uri.js

@@ -1,3 +1,4 @@
+import { LOCAL_REFERENCE_SCHEME, LOCAL_REFERENCE_OPEN, LOCAL_REFERENCE_CLOSE, localLocatorId, localLocatorFromId, validateLocalLocator } from "./local-locator.js";
 /**
  * Canonical `dsh-ref:` URI and the inline mention that carries it.
  *
@@ -9,8 +10,12 @@
  * @module dsh-reference-anything/uri
  */
 import { ReferenceAnythingError } from "./errors.js";
-import { decodeReferenceUriUnchecked, encodeReferenceUri, REFERENCE_SCHEME } from "./uri-codec.js";
+import { createHash } from 'node:crypto';
+import { decodeReferenceUriUnchecked, encodeReferenceUri, encodeLegacyReferenceUri, REFERENCE_SCHEME } from "./uri-codec.js";
 export { encodeReferenceUri, REFERENCE_SCHEME };
+export function referenceReadHandle(ref) {
+    return `ref:${createHash('sha256').update(encodeLegacyReferenceUri(ref)).digest('hex').slice(0, 24)}`;
+}
 /**
  * Decode one canonical reference URI.
  *
@@ -52,13 +57,19 @@ export function formatReferenceMention(ref, label) {
  */
 export function parseReferenceText(text) {
     const references = [];
-    const pattern = /@\[((?:\\.|[^\\\]])*)\]\((dsh-ref:[^\s)]*)\)|(dsh-ref:[A-Za-z0-9_-]+)/gu;
-    const rendered = text.replace(pattern, (_match, rawLabel, markdownUri, bareUri) => {
+    const withLocators = text.replace(/<local-agent-reference>([\s\S]*?)<\/local-agent-reference>/gu, (_match, json) => {
+        const value = JSON.parse(json);
+        const locator = validateLocalLocator(value);
+        references.push({ ref: { source: 'local-agent', id: localLocatorId(locator) }, label: typeof value.label === 'string' ? value.label : locator.sessionId });
+        return `@${typeof value.label === 'string' ? value.label : locator.sessionId}`;
+    });
+    const pattern = /@\[((?:\\.|[^\\\]])*)\]\(((?:dsh-ref:|dsh-local:)[^\s)]*)\)|((?:dsh-ref:[A-Za-z0-9_-]+|dsh-local:\?[^\s<>]+))/gu;
+    const rendered = withLocators.replace(pattern, (_match, rawLabel, markdownUri, bareUri) => {
         const uri = markdownUri ?? bareUri;
         if (uri === undefined)
             throw invalidUri(String(_match));
         const ref = decodeReferenceUri(uri);
-        const label = rawLabel === undefined ? ref.id : unescapeLabel(rawLabel);
+        const label = rawLabel === undefined ? (ref.source === 'local-agent' ? localLocatorFromId(ref.id).sessionId : ref.id) : unescapeLabel(rawLabel);
         references.push({ ref, label });
         return `@${label}`;
     });
@@ -73,7 +84,7 @@ export function parseReferenceText(text) {
  * @returns whether a full parse is worth running.
  */
 export function mayContainReference(text) {
-    return text.includes(REFERENCE_SCHEME);
+    return text.includes(REFERENCE_SCHEME) || text.includes(LOCAL_REFERENCE_SCHEME) || (text.includes(LOCAL_REFERENCE_OPEN) && text.includes(LOCAL_REFERENCE_CLOSE));
 }
 function escapeLabel(label) {
     return label.replace(/[\\\]]/gu, match => `\\${match}`);

package/lib/web.js

@@ -1,12 +1,14 @@
 import { ReferenceAnythingRemote } from "./host.js";
 import { TYPERT_MANIFEST } from "./typert.js";
+import { createPluginReferenceSource } from "./local-plugins.js";
 export const name = 'reference-anything-web';
 // ReferenceAnythingRemote looks up optional sources through ctx.get(). Making
 // cloud drives a required injection blocks all conversation endpoints when
 // that source is disabled or unavailable in the active profile.
-export const inject = ['typert', 'referenceChatHistory', 'openListManager'];
+export const inject = ['typert', 'referenceChatHistory', 'openListManager', 'references'];
 export function apply(ctx) {
     new ReferenceAnythingRemote(ctx);
+    ctx.effect(() => ctx.references.registerSource(createPluginReferenceSource(ctx)), 'reference-anything-web.plugin-source');
     ctx.effect(() => {
         const dispose = ctx.typert.register(TYPERT_MANIFEST);
         return () => { void dispose(); };

package/lib/wire.d.ts

@@ -10,7 +10,10 @@ export declare const providerSchema: z.ZodEnum<{
 }>;
 export type ChatProvider = z.infer<typeof providerSchema>;
 export declare const ALL_PROVIDERS: readonly ChatProvider[];
+export declare const READABLE_LOCAL_AGENTS: readonly ["claude-code", "codex", "cursor", "qoder", "reasonix", "openclaw", "kimi", "grokbuild", "hermes", "gemini-cli", "pi", "opencode", "mimocode", "zcode"];
+export declare const IMPORT_ONLY_AGENTS: readonly ["antigravity", "kilocode", "chatgpt", "workbuddy", "qwen", "continue", "cline", "goose", "dsh4", "zed", "crush", "teleagent", "trae", "vibe", "dsh"];
 export declare const localAgentSchema: z.ZodEnum<{
+    chatgpt: "chatgpt";
     kimi: "kimi";
     "claude-code": "claude-code";
     codex: "codex";
@@ -25,6 +28,20 @@ export declare const localAgentSchema: z.ZodEnum<{
     opencode: "opencode";
     mimocode: "mimocode";
     zcode: "zcode";
+    antigravity: "antigravity";
+    kilocode: "kilocode";
+    workbuddy: "workbuddy";
+    qwen: "qwen";
+    continue: "continue";
+    cline: "cline";
+    goose: "goose";
+    dsh4: "dsh4";
+    zed: "zed";
+    crush: "crush";
+    teleagent: "teleagent";
+    trae: "trae";
+    vibe: "vibe";
+    dsh: "dsh";
 }>;
 export type LocalAgent = z.infer<typeof localAgentSchema>;
 export declare const ALL_LOCAL_AGENTS: readonly LocalAgent[];
@@ -37,15 +54,34 @@ export declare const pickerSourceSchema: z.ZodEnum<{
     agents: "agents";
     conversations: "conversations";
     drives: "drives";
+    plugins: "plugins";
 }>;
 export type PickerSource = z.infer<typeof pickerSourceSchema>;
+export declare const pickerSortSchema: z.ZodEnum<{
+    name: "name";
+    updated: "updated";
+}>;
+export type PickerSort = z.infer<typeof pickerSortSchema>;
 declare const pickerSourceSettingsSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
     order: z.ZodNumber;
     limit: z.ZodNumber;
     maxCandidates: z.ZodDefault<z.ZodNumber>;
+    sort: z.ZodDefault<z.ZodEnum<{
+        name: "name";
+        updated: "updated";
+    }>>;
+    shortcut: z.ZodDefault<z.ZodString>;
+    aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 export type PickerSourceSettings = z.infer<typeof pickerSourceSettingsSchema>;
+export declare const agentActionsSchema: z.ZodObject<{
+    showImport: z.ZodDefault<z.ZodBoolean>;
+    showSummary: z.ZodDefault<z.ZodBoolean>;
+    skipConfirmation: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type AgentActionsSettings = z.infer<typeof agentActionsSchema>;
 export declare const pickerSettingsSchema: z.ZodObject<{
     displayMode: z.ZodDefault<z.ZodEnum<{
         collapse: "collapse";
@@ -56,42 +92,109 @@ export declare const pickerSettingsSchema: z.ZodObject<{
         order: z.ZodNumber;
         limit: z.ZodNumber;
         maxCandidates: z.ZodDefault<z.ZodNumber>;
+        sort: z.ZodDefault<z.ZodEnum<{
+            name: "name";
+            updated: "updated";
+        }>>;
+        shortcut: z.ZodDefault<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
     skills: z.ZodObject<{
         enabled: z.ZodBoolean;
         order: z.ZodNumber;
         limit: z.ZodNumber;
         maxCandidates: z.ZodDefault<z.ZodNumber>;
+        sort: z.ZodDefault<z.ZodEnum<{
+            name: "name";
+            updated: "updated";
+        }>>;
+        shortcut: z.ZodDefault<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
     files: z.ZodObject<{
         enabled: z.ZodBoolean;
         order: z.ZodNumber;
         limit: z.ZodNumber;
         maxCandidates: z.ZodDefault<z.ZodNumber>;
+        sort: z.ZodDefault<z.ZodEnum<{
+            name: "name";
+            updated: "updated";
+        }>>;
+        shortcut: z.ZodDefault<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
     sessions: z.ZodObject<{
         enabled: z.ZodBoolean;
         order: z.ZodNumber;
         limit: z.ZodNumber;
         maxCandidates: z.ZodDefault<z.ZodNumber>;
+        sort: z.ZodDefault<z.ZodEnum<{
+            name: "name";
+            updated: "updated";
+        }>>;
+        shortcut: z.ZodDefault<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
     agents: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodBoolean;
         order: z.ZodNumber;
         limit: z.ZodNumber;
         maxCandidates: z.ZodDefault<z.ZodNumber>;
+        sort: z.ZodDefault<z.ZodEnum<{
+            name: "name";
+            updated: "updated";
+        }>>;
+        shortcut: z.ZodDefault<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+        showImport: z.ZodDefault<z.ZodBoolean>;
+        showSummary: z.ZodDefault<z.ZodBoolean>;
+        skipConfirmation: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
     conversations: z.ZodObject<{
         enabled: z.ZodBoolean;
         order: z.ZodNumber;
         limit: z.ZodNumber;
         maxCandidates: z.ZodDefault<z.ZodNumber>;
+        sort: z.ZodDefault<z.ZodEnum<{
+            name: "name";
+            updated: "updated";
+        }>>;
+        shortcut: z.ZodDefault<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
     drives: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodBoolean;
         order: z.ZodNumber;
         limit: z.ZodNumber;
         maxCandidates: z.ZodDefault<z.ZodNumber>;
+        sort: z.ZodDefault<z.ZodEnum<{
+            name: "name";
+            updated: "updated";
+        }>>;
+        shortcut: z.ZodDefault<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>>;
+    plugins: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        order: z.ZodNumber;
+        limit: z.ZodNumber;
+        maxCandidates: z.ZodDefault<z.ZodNumber>;
+        sort: z.ZodDefault<z.ZodEnum<{
+            name: "name";
+            updated: "updated";
+        }>>;
+        shortcut: z.ZodDefault<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+        onlyLive: z.ZodDefault<z.ZodBoolean>;
+        showDeepSeek: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type PickerSettings = z.infer<typeof pickerSettingsSchema>;
@@ -127,6 +230,7 @@ export declare const settingsRecordSchema: z.ZodObject<{
         kimi: "kimi";
     }>>>;
     enabledAgents: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        chatgpt: "chatgpt";
         kimi: "kimi";
         "claude-code": "claude-code";
         codex: "codex";
@@ -141,8 +245,23 @@ export declare const settingsRecordSchema: z.ZodObject<{
         opencode: "opencode";
         mimocode: "mimocode";
         zcode: "zcode";
+        antigravity: "antigravity";
+        kilocode: "kilocode";
+        workbuddy: "workbuddy";
+        qwen: "qwen";
+        continue: "continue";
+        cline: "cline";
+        goose: "goose";
+        dsh4: "dsh4";
+        zed: "zed";
+        crush: "crush";
+        teleagent: "teleagent";
+        trae: "trae";
+        vibe: "vibe";
+        dsh: "dsh";
     }>>>;
     agentDirectories: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        chatgpt: "chatgpt";
         kimi: "kimi";
         "claude-code": "claude-code";
         codex: "codex";
@@ -157,6 +276,20 @@ export declare const settingsRecordSchema: z.ZodObject<{
         opencode: "opencode";
         mimocode: "mimocode";
         zcode: "zcode";
+        antigravity: "antigravity";
+        kilocode: "kilocode";
+        workbuddy: "workbuddy";
+        qwen: "qwen";
+        continue: "continue";
+        cline: "cline";
+        goose: "goose";
+        dsh4: "dsh4";
+        zed: "zed";
+        crush: "crush";
+        teleagent: "teleagent";
+        trae: "trae";
+        vibe: "vibe";
+        dsh: "dsh";
     }> & z.core.$partial, z.ZodString>>;
     enabledDriveMounts: z.ZodOptional<z.ZodArray<z.ZodString>>;
     maxReadTurns: z.ZodDefault<z.ZodNumber>;
@@ -174,42 +307,109 @@ export declare const settingsRecordSchema: z.ZodObject<{
             order: z.ZodNumber;
             limit: z.ZodNumber;
             maxCandidates: z.ZodDefault<z.ZodNumber>;
+            sort: z.ZodDefault<z.ZodEnum<{
+                name: "name";
+                updated: "updated";
+            }>>;
+            shortcut: z.ZodDefault<z.ZodString>;
+            aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
         }, z.core.$strip>;
         skills: z.ZodObject<{
             enabled: z.ZodBoolean;
             order: z.ZodNumber;
             limit: z.ZodNumber;
             maxCandidates: z.ZodDefault<z.ZodNumber>;
+            sort: z.ZodDefault<z.ZodEnum<{
+                name: "name";
+                updated: "updated";
+            }>>;
+            shortcut: z.ZodDefault<z.ZodString>;
+            aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
         }, z.core.$strip>;
         files: z.ZodObject<{
             enabled: z.ZodBoolean;
             order: z.ZodNumber;
             limit: z.ZodNumber;
             maxCandidates: z.ZodDefault<z.ZodNumber>;
+            sort: z.ZodDefault<z.ZodEnum<{
+                name: "name";
+                updated: "updated";
+            }>>;
+            shortcut: z.ZodDefault<z.ZodString>;
+            aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
         }, z.core.$strip>;
         sessions: z.ZodObject<{
             enabled: z.ZodBoolean;
             order: z.ZodNumber;
             limit: z.ZodNumber;
             maxCandidates: z.ZodDefault<z.ZodNumber>;
+            sort: z.ZodDefault<z.ZodEnum<{
+                name: "name";
+                updated: "updated";
+            }>>;
+            shortcut: z.ZodDefault<z.ZodString>;
+            aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
         }, z.core.$strip>;
         agents: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodBoolean;
             order: z.ZodNumber;
             limit: z.ZodNumber;
             maxCandidates: z.ZodDefault<z.ZodNumber>;
+            sort: z.ZodDefault<z.ZodEnum<{
+                name: "name";
+                updated: "updated";
+            }>>;
+            shortcut: z.ZodDefault<z.ZodString>;
+            aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+            showImport: z.ZodDefault<z.ZodBoolean>;
+            showSummary: z.ZodDefault<z.ZodBoolean>;
+            skipConfirmation: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>;
         conversations: z.ZodObject<{
             enabled: z.ZodBoolean;
             order: z.ZodNumber;
             limit: z.ZodNumber;
             maxCandidates: z.ZodDefault<z.ZodNumber>;
+            sort: z.ZodDefault<z.ZodEnum<{
+                name: "name";
+                updated: "updated";
+            }>>;
+            shortcut: z.ZodDefault<z.ZodString>;
+            aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
         }, z.core.$strip>;
         drives: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodBoolean;
             order: z.ZodNumber;
             limit: z.ZodNumber;
             maxCandidates: z.ZodDefault<z.ZodNumber>;
+            sort: z.ZodDefault<z.ZodEnum<{
+                name: "name";
+                updated: "updated";
+            }>>;
+            shortcut: z.ZodDefault<z.ZodString>;
+            aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+        }, z.core.$strip>>;
+        plugins: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodBoolean;
+            order: z.ZodNumber;
+            limit: z.ZodNumber;
+            maxCandidates: z.ZodDefault<z.ZodNumber>;
+            sort: z.ZodDefault<z.ZodEnum<{
+                name: "name";
+                updated: "updated";
+            }>>;
+            shortcut: z.ZodDefault<z.ZodString>;
+            aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sourceAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+            onlyLive: z.ZodDefault<z.ZodBoolean>;
+            showDeepSeek: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/lib/wire.js

@@ -2,19 +2,34 @@
 import { z } from 'zod';
 export const providerSchema = z.enum(['chatgpt', 'claude', 'gemini', 'deepseek', 'grok', 'kimi']);
 export const ALL_PROVIDERS = providerSchema.options;
-export const localAgentSchema = z.enum(['claude-code', 'codex', 'cursor', 'qoder', 'reasonix', 'openclaw', 'kimi', 'grokbuild', 'hermes', 'gemini-cli', 'pi', 'opencode', 'mimocode', 'zcode']);
+export const READABLE_LOCAL_AGENTS = ['claude-code', 'codex', 'cursor', 'qoder', 'reasonix', 'openclaw', 'kimi', 'grokbuild', 'hermes', 'gemini-cli', 'pi', 'opencode', 'mimocode', 'zcode'];
+export const IMPORT_ONLY_AGENTS = ['antigravity', 'kilocode', 'chatgpt', 'workbuddy', 'qwen', 'continue', 'cline', 'goose', 'dsh4', 'zed', 'crush', 'teleagent', 'trae', 'vibe', 'dsh'];
+export const localAgentSchema = z.enum([...READABLE_LOCAL_AGENTS, ...IMPORT_ONLY_AGENTS]);
 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',
+    antigravity: 'Antigravity', kilocode: 'Kilo Code', chatgpt: 'ChatGPT', workbuddy: 'WorkBuddy', qwen: 'Qwen Code',
+    continue: 'Continue', cline: 'Cline', goose: 'Goose', dsh4: 'DSH4', zed: 'Zed', crush: 'Crush', teleagent: 'TeleAgent', trae: 'Trae Work', vibe: 'Mistral Vibe', dsh: 'DSH',
 };
-export const pickerSourceSchema = z.enum(['commands', 'skills', 'files', 'sessions', 'agents', 'conversations', 'drives']);
+export const pickerSourceSchema = z.enum(['commands', 'skills', 'files', 'sessions', 'agents', 'conversations', 'drives', 'plugins']);
+export const pickerSortSchema = z.enum(['name', 'updated']);
 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),
+    sort: pickerSortSchema.default('updated'),
+    /** Optional extra token for `@token:` scoped searches. */
+    shortcut: z.string().regex(/^[^@:\s/]*(,[^@:\s/]+)*$/u).max(32).default(''),
+    aliases: z.array(z.string().regex(/^[^@:\s/]+$/u).max(32)).optional(),
+    sourceAliases: z.record(z.string(), z.array(z.string().regex(/^[^@:\s/]+$/u).max(32))).optional(),
+});
+export const agentActionsSchema = z.object({
+    showImport: z.boolean().default(true),
+    showSummary: z.boolean().default(false),
+    skipConfirmation: z.boolean().default(false),
 });
 export const pickerSettingsSchema = z.object({
     displayMode: z.enum(['collapse', 'native-scroll']).default('collapse'),
@@ -27,33 +42,43 @@ export const pickerSettingsSchema = z.object({
     // 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 }),
+    agents: pickerSourceSettingsSchema.extend(agentActionsSchema.shape).default({ showImport: true, showSummary: false, skipConfirmation: false, enabled: true, order: 25, limit: 6, maxCandidates: 50, sort: 'updated', shortcut: '', aliases: ['agent', 'cc', 'claude-code', 'codex', 'cursor', 'gemini-cli', 'qoder', 'reasonix', 'openclaw', 'hermes', 'pi', 'grokbuild', 'grok-build', 'kimi-cli', 'kimi-code', 'opencode', 'mimocode', 'mimo', 'zcode'] }),
     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 }),
+    drives: pickerSourceSettingsSchema.default({ enabled: true, order: 35, limit: 6, maxCandidates: 50, sort: 'updated', shortcut: '', aliases: ['drive'] }),
+    plugins: pickerSourceSettingsSchema.extend({
+        onlyLive: z.boolean().default(false),
+        showDeepSeek: z.boolean().default(true),
+    }).default({ enabled: true, order: 40, limit: 6, maxCandidates: 50, sort: 'updated', shortcut: '', aliases: ['plugin'], onlyLive: false, showDeepSeek: true }),
 });
 export const inputRenderModeSchema = z.enum(['pill', 'raw-text']);
 /** Defaults used before the user saves the General section. */
 export function defaultPickerSettings() {
     return {
         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 },
-        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 },
+        commands: { enabled: true, order: 0, limit: 6, maxCandidates: 50, sort: 'updated', shortcut: '', aliases: ['command'] },
+        skills: { enabled: true, order: 5, limit: 6, maxCandidates: 50, sort: 'updated', shortcut: '', aliases: ['skill'] },
+        files: { enabled: true, order: 10, limit: 6, maxCandidates: 50, sort: 'updated', shortcut: '', aliases: ['file'] },
+        sessions: { enabled: true, order: 20, limit: 6, maxCandidates: 50, sort: 'updated', shortcut: '', aliases: ['session'] },
+        agents: { showImport: true, showSummary: false, skipConfirmation: false, enabled: true, order: 25, limit: 6, maxCandidates: 50, sort: 'updated', shortcut: '', aliases: ['agent', 'cc', 'claude-code', 'codex', 'cursor', 'gemini-cli', 'qoder', 'reasonix', 'openclaw', 'hermes', 'pi', 'grokbuild', 'grok-build', 'kimi-cli', 'kimi-code', 'opencode', 'mimocode', 'mimo', 'zcode'] },
+        conversations: { enabled: true, order: 30, limit: 6, maxCandidates: 50, sort: 'updated', shortcut: '', aliases: ['chat'] },
+        drives: { enabled: true, order: 35, limit: 6, maxCandidates: 50, sort: 'updated', shortcut: '', aliases: ['drive'] },
+        plugins: { enabled: true, order: 40, limit: 6, maxCandidates: 50, sort: 'updated', shortcut: '', aliases: ['plugin'], onlyLive: false, showDeepSeek: true },
     };
 }
 /** Picker settings have a fixed schema, so explicit comparison is cheap and stable. */
 export function samePickerSettings(left, right) {
-    if (left.displayMode !== right.displayMode)
+    if (left.displayMode !== right.displayMode || left.agents.showImport !== right.agents.showImport || left.agents.showSummary !== right.agents.showSummary || left.agents.skipConfirmation !== right.agents.skipConfirmation)
         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].maxCandidates === right[key].maxCandidates);
+        left[key].maxCandidates === right[key].maxCandidates &&
+        left[key].sort === right[key].sort &&
+        left[key].shortcut === right[key].shortcut &&
+        JSON.stringify(left[key].aliases) === JSON.stringify(right[key].aliases) &&
+        JSON.stringify(left[key].sourceAliases) === JSON.stringify(right[key].sourceAliases) &&
+        (key !== 'plugins' || (left.plugins.onlyLive === right.plugins.onlyLive && left.plugins.showDeepSeek === right.plugins.showDeepSeek)));
 }
 export const settingsRecordSchema = z.object({
     opencliPath: z.string(),

package/opencli-plugin/common.js

@@ -77,7 +77,7 @@ function assertIdentityResult(result, domain, operation) {
   return result.identity
 }
 
-const PROVIDER_READY_TIMEOUT_MS = 1200
+const PROVIDER_READY_TIMEOUT_MS = 10_000
 const PROVIDER_READY_INITIAL_DELAY_MS = 50
 const PROVIDER_READY_MAX_DELAY_MS = 400
 
@@ -264,14 +264,16 @@ export function registerProvider(config) {
       await navigate(page, config.home, { settleMs: 600 })
       const expectedScope = parseExpectedAccountScope(kwargs.accountScope)
       if (expectedScope) {
-        const identity = await evaluate(page, config.whoamiScript, {}, `${config.site} detail identity`)
+        const identity = await evaluateWhenProviderReady(
+          page, config.whoamiScript, {}, `${config.site} detail identity`, { accepts: terminalIdentityResult },
+        )
         const stableIdentity = assertIdentityResult(identity, config.domain, `${config.site} detail`)
         const actualScope = createHash('sha256').update(`${config.provider.toLocaleLowerCase()}\0${stableIdentity}`).digest('hex')
         if (actualScope !== expectedScope) {
           throw new CommandExecutionError(`DSH_ACCOUNT_SCOPE_MISMATCH: ${config.site} detail: conversation belongs to a different logged-in account`)
         }
       }
-      let result = await evaluate(page, config.detailScript, { id }, `${config.site} detail`)
+      let result = await evaluateWhenProviderReady(page, config.detailScript, { id }, `${config.site} detail`)
       if (result?.ok !== true && result?.code !== 'AUTH' && result?.code !== 'RATE_LIMIT' && config.fallbackScript) {
         await navigate(page, config.conversationUrl(id), { settleMs: 1800 })
         result = await evaluate(page, config.fallbackScript, { id }, `${config.site} detail fallback`)

package/opencli-plugin/opencli-plugin.json

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

package/opencli-plugin/package.json

@@ -3,6 +3,6 @@
   "version": "0.2.3",
   "type": "module",
   "peerDependencies": {
-    "@jackwener/opencli": ">=1.8.6"
+    "@jackwener/opencli": ">=2.0.0"
   }
 }