@huyuan-ai/cli 1.0.4 → 1.2.0

package/vendor/opencli/dist/clis/douyin/_shared/tos-upload.js

@@ -9,7 +9,7 @@ import * as crypto from 'node:crypto';
 import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
-import { CommandExecutionError } from '../../../errors.js';
+import { CommandExecutionError } from '@jackwener/opencli/errors';
 const PART_SIZE = 5 * 1024 * 1024; // 5 MB minimum per TOS/S3 spec
 const RESUME_DIR = path.join(os.homedir(), '.opencli', 'douyin-resume');
 // ── Resume file helpers ──────────────────────────────────────────────────────

package/vendor/opencli/dist/clis/douyin/_shared/transcode.d.ts

@@ -5,7 +5,7 @@
  * Douyin transcodes the video asynchronously. This module polls the transcode
  * status endpoint until encode=2 (complete) or a timeout is reached.
  */
-import type { IPage } from '../../../types.js';
+import type { IPage } from '@jackwener/opencli/types';
 import type { TranscodeResult } from './types.js';
 type BrowserFetchFn = (page: IPage, method: 'GET' | 'POST', url: string) => Promise<unknown>;
 /**

package/vendor/opencli/dist/clis/douyin/_shared/transcode.js

@@ -5,7 +5,7 @@
  * Douyin transcodes the video asynchronously. This module polls the transcode
  * status endpoint until encode=2 (complete) or a timeout is reached.
  */
-import { TimeoutError } from '../../../errors.js';
+import { TimeoutError } from '@jackwener/opencli/errors';
 import { browserFetch } from './browser-fetch.js';
 const POLL_INTERVAL_MS = 3_000;
 const DEFAULT_TIMEOUT_MS = 300_000;

package/vendor/opencli/dist/clis/douyin/_shared/transcode.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it, vi } from 'vitest';
-import { TimeoutError } from '../../../errors.js';
+import { TimeoutError } from '@jackwener/opencli/errors';
 import { pollTranscodeWithFetch } from './transcode.js';
 // ── Helpers ──────────────────────────────────────────────────────────────────
 function makePage() {

package/vendor/opencli/dist/clis/douyin/activities.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { browserFetch } from './_shared/browser-fetch.js';
 cli({
     site: 'douyin',

package/vendor/opencli/dist/clis/douyin/activities.test.js

@@ -5,7 +5,7 @@ const { browserFetchMock } = vi.hoisted(() => ({
 vi.mock('./_shared/browser-fetch.js', () => ({
     browserFetch: browserFetchMock,
 }));
-import { getRegistry } from '../../registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './activities.js';
 describe('douyin activities registration', () => {
     beforeEach(() => {

package/vendor/opencli/dist/clis/douyin/collections.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { browserFetch } from './_shared/browser-fetch.js';
 cli({
     site: 'douyin',

package/vendor/opencli/dist/clis/douyin/collections.test.js

@@ -5,7 +5,7 @@ const { browserFetchMock } = vi.hoisted(() => ({
 vi.mock('./_shared/browser-fetch.js', () => ({
     browserFetch: browserFetchMock,
 }));
-import { getRegistry } from '../../registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './collections.js';
 describe('douyin collections', () => {
     beforeEach(() => {

package/vendor/opencli/dist/clis/douyin/delete.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { browserFetch } from './_shared/browser-fetch.js';
 cli({
     site: 'douyin',

package/vendor/opencli/dist/clis/douyin/delete.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { getRegistry } from '../../registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './delete.js';
 describe('douyin delete registration', () => {
     it('registers the delete command', () => {

package/vendor/opencli/dist/clis/douyin/draft.js

@@ -7,8 +7,8 @@
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { cli, Strategy } from '../../registry.js';
-import { ArgumentError, CommandExecutionError } from '../../errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { ArgumentError, CommandExecutionError } from '@jackwener/opencli/errors';
 const VISIBILITY_LABELS = {
     public: '公开',
     friends: '好友可见',

package/vendor/opencli/dist/clis/douyin/draft.test.js

@@ -2,8 +2,8 @@ import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
 import { afterAll, describe, expect, it, vi } from 'vitest';
-import { wrapForEval } from '../../browser/utils.js';
-import { getRegistry } from '../../registry.js';
+import { wrapForEval } from '@jackwener/opencli/browser/utils';
+import { getRegistry } from '@jackwener/opencli/registry';
 import { buildCoverCheckPanelTextJs } from './draft.js';
 // ─── Shared test helpers ────────────────────────────────────────────
 const tempDirs = [];

package/vendor/opencli/dist/clis/douyin/drafts.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { browserFetch } from './_shared/browser-fetch.js';
 cli({
     site: 'douyin',

package/vendor/opencli/dist/clis/douyin/drafts.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { getRegistry } from '../../registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './drafts.js';
 describe('douyin drafts registration', () => {
     it('registers the drafts command', () => {

package/vendor/opencli/dist/clis/douyin/hashtag.js

@@ -1,6 +1,6 @@
-import { cli, Strategy } from '../../registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { browserFetch } from './_shared/browser-fetch.js';
-import { ArgumentError } from '../../errors.js';
+import { ArgumentError } from '@jackwener/opencli/errors';
 cli({
     site: 'douyin',
     name: 'hashtag',

package/vendor/opencli/dist/clis/douyin/hashtag.test.js

@@ -5,7 +5,7 @@ const { browserFetchMock } = vi.hoisted(() => ({
 vi.mock('./_shared/browser-fetch.js', () => ({
     browserFetch: browserFetchMock,
 }));
-import { getRegistry } from '../../registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './hashtag.js';
 describe('douyin hashtag', () => {
     beforeEach(() => {

package/vendor/opencli/dist/clis/douyin/location.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { browserFetch } from './_shared/browser-fetch.js';
 cli({
     site: 'douyin',

package/vendor/opencli/dist/clis/douyin/location.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { getRegistry } from '../../registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './location.js';
 describe('douyin location registration', () => {
     it('registers the location command', () => {

package/vendor/opencli/dist/clis/douyin/profile.js

@@ -1,6 +1,6 @@
-import { cli, Strategy } from '../../registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { browserFetch } from './_shared/browser-fetch.js';
-import { CommandExecutionError } from '../../errors.js';
+import { CommandExecutionError } from '@jackwener/opencli/errors';
 cli({
     site: 'douyin',
     name: 'profile',

package/vendor/opencli/dist/clis/douyin/profile.test.js

@@ -5,7 +5,7 @@ const { browserFetchMock } = vi.hoisted(() => ({
 vi.mock('./_shared/browser-fetch.js', () => ({
     browserFetch: browserFetchMock,
 }));
-import { getRegistry } from '../../registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './profile.js';
 describe('douyin profile registration', () => {
     beforeEach(() => {

package/vendor/opencli/dist/clis/douyin/publish.js

@@ -13,8 +13,8 @@
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { cli, Strategy } from '../../registry.js';
-import { ArgumentError, CommandExecutionError } from '../../errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { ArgumentError, CommandExecutionError } from '@jackwener/opencli/errors';
 import { getSts2Credentials } from './_shared/sts2.js';
 import { tosUpload } from './_shared/tos-upload.js';
 import { imagexUpload } from './_shared/imagex-upload.js';

package/vendor/opencli/dist/clis/douyin/publish.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { getRegistry } from '../../registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './publish.js';
 describe('douyin publish registration', () => {
     it('registers the publish command', () => {

package/vendor/opencli/dist/clis/douyin/stats.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { browserFetch } from './_shared/browser-fetch.js';
 cli({
     site: 'douyin',

package/vendor/opencli/dist/clis/douyin/stats.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { getRegistry } from '../../registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './stats.js';
 describe('douyin stats registration', () => {
     it('registers the stats command', () => {

package/vendor/opencli/dist/clis/douyin/update.js

@@ -1,5 +1,5 @@
-import { cli, Strategy } from '../../registry.js';
-import { ArgumentError } from '../../errors.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { ArgumentError } from '@jackwener/opencli/errors';
 import { browserFetch } from './_shared/browser-fetch.js';
 import { toUnixSeconds, validateTiming } from './_shared/timing.js';
 cli({

package/vendor/opencli/dist/clis/douyin/update.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { getRegistry } from '../../registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './update.js';
 describe('douyin update registration', () => {
     it('registers the update command', () => {

package/vendor/opencli/dist/clis/douyin/user-videos.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { fetchDouyinComments, fetchDouyinUserVideos } from './_shared/public-api.js';
 export const MAX_USER_VIDEOS_LIMIT = 20;
 export const USER_VIDEO_COMMENT_CONCURRENCY = 4;

package/vendor/opencli/dist/clis/douyin/user-videos.test.js

@@ -7,7 +7,7 @@ vi.mock('./_shared/public-api.js', () => ({
     fetchDouyinUserVideos: fetchDouyinUserVideosMock,
     fetchDouyinComments: fetchDouyinCommentsMock,
 }));
-import { getRegistry } from '../../registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import { DEFAULT_COMMENT_LIMIT, MAX_USER_VIDEOS_LIMIT, normalizeCommentLimit, normalizeUserVideosLimit } from './user-videos.js';
 describe('douyin user-videos', () => {
     beforeEach(() => {

package/vendor/opencli/dist/clis/douyin/videos.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { browserFetch } from './_shared/browser-fetch.js';
 function normalizeVideoStatus(status, publicTime) {
     if (typeof status === 'number')

package/vendor/opencli/dist/clis/douyin/videos.test.js

@@ -5,7 +5,7 @@ const { browserFetchMock } = vi.hoisted(() => ({
 vi.mock('./_shared/browser-fetch.js', () => ({
     browserFetch: browserFetchMock,
 }));
-import { getRegistry } from '../../registry.js';
+import { getRegistry } from '@jackwener/opencli/registry';
 import './videos.js';
 describe('douyin videos', () => {
     beforeEach(() => {

package/vendor/opencli/dist/clis/facebook/search.test.js

@@ -7,7 +7,7 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import yaml from 'js-yaml';
 import { describe, expect, it, vi } from 'vitest';
-import { executePipeline } from '../../pipeline/index.js';
+import { executePipeline } from '@jackwener/opencli/pipeline';
 /**
  * Minimal browser mock for pipeline execution tests.
  * Only methods touched by this adapter path are implemented.

package/vendor/opencli/dist/clis/gemini/ask.d.ts

@@ -1 +1 @@
-export declare const askCommand: import("../../registry.js").CliCommand;
+export declare const askCommand: import("@jackwener/opencli/registry").CliCommand;

package/vendor/opencli/dist/clis/gemini/ask.js

@@ -1,4 +1,4 @@
-import { cli, Strategy } from '../../registry.js';
+import { cli, Strategy } from '@jackwener/opencli/registry';
 import { GEMINI_DOMAIN, readGeminiSnapshot, sendGeminiMessage, startNewGeminiChat, waitForGeminiResponse, waitForGeminiSubmission } from './utils.js';
 function normalizeBooleanFlag(value) {
     if (typeof value === 'boolean')

package/vendor/opencli/dist/clis/gemini/deep-research-result.d.ts

@@ -0,0 +1 @@
+export declare const deepResearchResultCommand: import("@jackwener/opencli/registry").CliCommand;

package/vendor/opencli/dist/clis/gemini/deep-research-result.js

@@ -0,0 +1,91 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { GEMINI_DOMAIN, clickGeminiConversationByTitle, exportGeminiDeepResearchReport, getLatestGeminiAssistantResponse, getGeminiPageState, parseGeminiConversationUrl, parseGeminiTitleMatchMode, readGeminiSnapshot, resolveGeminiConversationForQuery, waitForGeminiTranscript, getGeminiConversationList, } from './utils.js';
+const DEEP_RESEARCH_WAITING_MESSAGE = 'Deep Research is still running. Please wait and retry later.';
+const DEEP_RESEARCH_NO_DOCS_MESSAGE = 'No Docs URL found. Please check Share & Export -> Export to Docs in Gemini UI.';
+const DEEP_RESEARCH_PENDING_MESSAGE = 'Deep Research may still be running or preparing export. Please wait and retry later.';
+function isDeepResearchInProgress(text) {
+    return /\bresearching(?:\s+websites?)?\b|research in progress|working on your research|generating research plan|gathering sources|creating report|planning research|正在研究|研究中|调研中|生成研究计划|搜集资料|请稍候|稍候|请等待/i.test(text);
+}
+function isDeepResearchCompleted(text) {
+    return /\bcompleted\b|research complete|completed research|report completed|已完成|研究完成|完成了研究|报告已完成/i.test(text);
+}
+async function resolveDeepResearchExportResponse(page, timeoutSeconds) {
+    const exported = await exportGeminiDeepResearchReport(page, timeoutSeconds);
+    if (exported.url)
+        return exported.url;
+    const snapshot = await readGeminiSnapshot(page).catch(() => null);
+    if (snapshot?.isGenerating)
+        return DEEP_RESEARCH_WAITING_MESSAGE;
+    const latest = await getLatestGeminiAssistantResponse(page).catch(() => '');
+    const turnTail = Array.isArray(snapshot?.turns)
+        ? snapshot.turns.slice(-6).map((turn) => String(turn?.Text ?? '')).join('\n')
+        : '';
+    const transcriptTail = Array.isArray(snapshot?.transcriptLines)
+        ? snapshot.transcriptLines.slice(-30).join('\n')
+        : '';
+    const statusText = [latest, turnTail, transcriptTail]
+        .map((value) => String(value ?? '').trim())
+        .filter(Boolean)
+        .join('\n');
+    if (statusText && isDeepResearchInProgress(statusText) && !isDeepResearchCompleted(statusText)) {
+        return DEEP_RESEARCH_WAITING_MESSAGE;
+    }
+    if (statusText && isDeepResearchCompleted(statusText)) {
+        return DEEP_RESEARCH_NO_DOCS_MESSAGE;
+    }
+    return DEEP_RESEARCH_PENDING_MESSAGE;
+}
+export const deepResearchResultCommand = cli({
+    site: 'gemini',
+    name: 'deep-research-result',
+    description: 'Export Deep Research report URL from a Gemini conversation',
+    domain: GEMINI_DOMAIN,
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    defaultFormat: 'plain',
+    args: [
+        { name: 'query', positional: true, required: false, help: 'Conversation title or URL (optional; defaults to latest conversation)' },
+        { name: 'match', required: false, default: 'contains', choices: ['contains', 'exact'], help: 'Match mode' },
+        { name: 'timeout', type: 'int', required: false, default: 120, help: 'Max seconds to wait for Docs export (default: 120)' },
+    ],
+    columns: ['response'],
+    func: async (page, kwargs) => {
+        const query = String(kwargs.query ?? '').trim();
+        const matchMode = parseGeminiTitleMatchMode(kwargs.match);
+        const timeoutRaw = Number.parseInt(String(kwargs.timeout ?? ''), 10);
+        const timeoutSeconds = Number.isFinite(timeoutRaw) && timeoutRaw > 0 ? timeoutRaw : 120;
+        if (!matchMode) {
+            return [{ response: 'Invalid match mode. Use contains or exact.' }];
+        }
+        const state = await getGeminiPageState(page);
+        if (state.isSignedIn === false) {
+            return [{ response: 'Not signed in to Gemini.' }];
+        }
+        const conversationUrl = parseGeminiConversationUrl(query);
+        if (conversationUrl) {
+            await page.goto(conversationUrl, { waitUntil: 'load', settleMs: 2500 });
+            await page.wait(1);
+            await waitForGeminiTranscript(page);
+            return [{ response: await resolveDeepResearchExportResponse(page, timeoutSeconds) }];
+        }
+        const conversations = await getGeminiConversationList(page);
+        const picked = resolveGeminiConversationForQuery(conversations, query, matchMode);
+        if (picked?.Url) {
+            await page.goto(picked.Url, { waitUntil: 'load', settleMs: 2500 });
+            await page.wait(1);
+            await waitForGeminiTranscript(page);
+        }
+        else if (query) {
+            if (matchMode === 'exact') {
+                return [{ response: `No conversation matched: ${query}` }];
+            }
+            const clicked = await clickGeminiConversationByTitle(page, query);
+            if (!clicked) {
+                return [{ response: `No conversation matched: ${query}` }];
+            }
+            await waitForGeminiTranscript(page);
+        }
+        return [{ response: await resolveDeepResearchExportResponse(page, timeoutSeconds) }];
+    },
+});

package/vendor/opencli/dist/clis/gemini/deep-research-result.test.js

@@ -0,0 +1,154 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { mockClickGeminiConversationByTitle, mockExportGeminiDeepResearchReport, mockGetGeminiConversationList, mockGetGeminiPageState, mockGetLatestGeminiAssistantResponse, mockReadGeminiSnapshot, mockResolveGeminiConversationForQuery, mockWaitForGeminiTranscript, } = vi.hoisted(() => ({
+    mockClickGeminiConversationByTitle: vi.fn(),
+    mockExportGeminiDeepResearchReport: vi.fn(),
+    mockGetGeminiConversationList: vi.fn(),
+    mockGetGeminiPageState: vi.fn(),
+    mockGetLatestGeminiAssistantResponse: vi.fn(),
+    mockReadGeminiSnapshot: vi.fn(),
+    mockResolveGeminiConversationForQuery: vi.fn(),
+    mockWaitForGeminiTranscript: vi.fn(),
+}));
+vi.mock('./utils.js', () => ({
+    GEMINI_DOMAIN: 'gemini.google.com',
+    clickGeminiConversationByTitle: mockClickGeminiConversationByTitle,
+    exportGeminiDeepResearchReport: mockExportGeminiDeepResearchReport,
+    getGeminiConversationList: mockGetGeminiConversationList,
+    getGeminiPageState: mockGetGeminiPageState,
+    getLatestGeminiAssistantResponse: mockGetLatestGeminiAssistantResponse,
+    readGeminiSnapshot: mockReadGeminiSnapshot,
+    parseGeminiConversationUrl: (value) => {
+        const raw = String(value ?? '').trim();
+        return raw.startsWith('https://gemini.google.com/app/') ? raw : null;
+    },
+    parseGeminiTitleMatchMode: (value) => {
+        const raw = String(value ?? 'contains').trim().toLowerCase();
+        if (raw === 'contains' || raw === 'exact')
+            return raw;
+        return null;
+    },
+    resolveGeminiConversationForQuery: mockResolveGeminiConversationForQuery,
+    waitForGeminiTranscript: mockWaitForGeminiTranscript,
+}));
+import { deepResearchResultCommand } from './deep-research-result.js';
+describe('gemini/deep-research-result', () => {
+    const page = {
+        goto: vi.fn().mockResolvedValue(undefined),
+        wait: vi.fn().mockResolvedValue(undefined),
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockGetGeminiPageState.mockResolvedValue({ isSignedIn: true });
+        mockGetGeminiConversationList.mockResolvedValue([{ Title: 'A title', Url: 'https://gemini.google.com/app/abc' }]);
+        mockResolveGeminiConversationForQuery.mockReturnValue({ Title: 'A title', Url: 'https://gemini.google.com/app/abc' });
+        mockClickGeminiConversationByTitle.mockResolvedValue(true);
+        mockWaitForGeminiTranscript.mockResolvedValue(['line']);
+        mockExportGeminiDeepResearchReport.mockResolvedValue({ url: 'https://files.example.com/report.md', source: 'network' });
+        mockGetLatestGeminiAssistantResponse.mockResolvedValue('Final answer');
+        mockReadGeminiSnapshot.mockResolvedValue({
+            turns: [],
+            transcriptLines: [],
+            composerHasText: false,
+            isGenerating: false,
+            structuredTurnsTrusted: true,
+        });
+    });
+    it('uses latest conversation when query is empty', async () => {
+        const result = await deepResearchResultCommand.func(page, { query: '   ' });
+        expect(page.goto).toHaveBeenCalledWith('https://gemini.google.com/app/abc', { waitUntil: 'load', settleMs: 2500 });
+        expect(result).toEqual([{ response: 'https://files.example.com/report.md' }]);
+    });
+    it('falls back to current page response when query is empty and sidebar has no conversations', async () => {
+        mockGetGeminiConversationList.mockResolvedValue([]);
+        mockResolveGeminiConversationForQuery.mockReturnValue(null);
+        const result = await deepResearchResultCommand.func(page, { query: '' });
+        expect(page.goto).not.toHaveBeenCalled();
+        expect(result).toEqual([{ response: 'https://files.example.com/report.md' }]);
+    });
+    it('returns a validation message when match mode is invalid', async () => {
+        const result = await deepResearchResultCommand.func(page, { query: 'A', match: 'prefix' });
+        expect(result).toEqual([{ response: 'Invalid match mode. Use contains or exact.' }]);
+    });
+    it('returns a signed-out message when Gemini page state indicates logged out', async () => {
+        mockGetGeminiPageState.mockResolvedValue({ isSignedIn: false });
+        const result = await deepResearchResultCommand.func(page, { query: 'A' });
+        expect(result).toEqual([{ response: 'Not signed in to Gemini.' }]);
+    });
+    it('opens matched conversation by URL and returns exported report url', async () => {
+        const result = await deepResearchResultCommand.func(page, { query: 'A title', match: 'exact' });
+        expect(page.goto).toHaveBeenCalledWith('https://gemini.google.com/app/abc', { waitUntil: 'load', settleMs: 2500 });
+        expect(result).toEqual([{ response: 'https://files.example.com/report.md' }]);
+    });
+    it('accepts a direct conversation URL and reads response from that page', async () => {
+        const url = 'https://gemini.google.com/app/direct-id';
+        const result = await deepResearchResultCommand.func(page, { query: url, match: 'contains' });
+        expect(page.goto).toHaveBeenCalledWith(url, { waitUntil: 'load', settleMs: 2500 });
+        expect(result).toEqual([{ response: 'https://files.example.com/report.md' }]);
+    });
+    it('passes query and mode into resolveGeminiConversationForQuery', async () => {
+        const result = await deepResearchResultCommand.func(page, { query: 'title', match: 'contains' });
+        expect(mockResolveGeminiConversationForQuery).toHaveBeenCalledWith([{ Title: 'A title', Url: 'https://gemini.google.com/app/abc' }], 'title', 'contains');
+        expect(result).toEqual([{ response: 'https://files.example.com/report.md' }]);
+    });
+    it('falls back to click-by-title and returns not-found when click fails', async () => {
+        mockResolveGeminiConversationForQuery.mockReturnValue(null);
+        mockClickGeminiConversationByTitle.mockResolvedValue(false);
+        const result = await deepResearchResultCommand.func(page, { query: 'missing', match: 'contains' });
+        expect(result).toEqual([{ response: 'No conversation matched: missing' }]);
+    });
+    it('returns pending message when export url is unavailable and completion is not confirmed', async () => {
+        mockExportGeminiDeepResearchReport.mockResolvedValue({ url: '', source: 'none' });
+        const result = await deepResearchResultCommand.func(page, { query: 'A title' });
+        expect(result).toEqual([{ response: 'Deep Research may still be running or preparing export. Please wait and retry later.' }]);
+    });
+    it('returns waiting message when deep research is still generating', async () => {
+        mockExportGeminiDeepResearchReport.mockResolvedValue({ url: '', source: 'none' });
+        mockReadGeminiSnapshot.mockResolvedValue({
+            turns: [],
+            transcriptLines: [],
+            composerHasText: false,
+            isGenerating: true,
+            structuredTurnsTrusted: true,
+        });
+        const result = await deepResearchResultCommand.func(page, { query: 'A title' });
+        expect(result).toEqual([{ response: 'Deep Research is still running. Please wait and retry later.' }]);
+    });
+    it('returns waiting message when assistant response indicates research in progress', async () => {
+        mockExportGeminiDeepResearchReport.mockResolvedValue({ url: '', source: 'none' });
+        mockGetLatestGeminiAssistantResponse.mockResolvedValue('正在研究中，请稍候。');
+        const result = await deepResearchResultCommand.func(page, { query: 'A title' });
+        expect(result).toEqual([{ response: 'Deep Research is still running. Please wait and retry later.' }]);
+    });
+    it('returns waiting message when transcript indicates in-progress status', async () => {
+        mockExportGeminiDeepResearchReport.mockResolvedValue({ url: '', source: 'none' });
+        mockGetLatestGeminiAssistantResponse.mockResolvedValue('');
+        mockReadGeminiSnapshot.mockResolvedValue({
+            turns: [],
+            transcriptLines: ['生成研究计划中，请稍候。'],
+            composerHasText: false,
+            isGenerating: false,
+            structuredTurnsTrusted: true,
+        });
+        const result = await deepResearchResultCommand.func(page, { query: 'A title' });
+        expect(result).toEqual([{ response: 'Deep Research is still running. Please wait and retry later.' }]);
+    });
+    it('returns no-docs message when text indicates completed state', async () => {
+        mockExportGeminiDeepResearchReport.mockResolvedValue({ url: '', source: 'none' });
+        mockGetLatestGeminiAssistantResponse.mockResolvedValue('Researching websites... Completed');
+        mockReadGeminiSnapshot.mockResolvedValue({
+            turns: [],
+            transcriptLines: [],
+            composerHasText: false,
+            isGenerating: false,
+            structuredTurnsTrusted: true,
+        });
+        const result = await deepResearchResultCommand.func(page, { query: 'A title' });
+        expect(result).toEqual([{ response: 'No Docs URL found. Please check Share & Export -> Export to Docs in Gemini UI.' }]);
+    });
+    it('returns pending message when assistant response is empty', async () => {
+        mockExportGeminiDeepResearchReport.mockResolvedValue({ url: '', source: 'none' });
+        mockGetLatestGeminiAssistantResponse.mockResolvedValue('');
+        const result = await deepResearchResultCommand.func(page, { query: 'A title' });
+        expect(result).toEqual([{ response: 'Deep Research may still be running or preparing export. Please wait and retry later.' }]);
+    });
+});

package/vendor/opencli/dist/clis/gemini/deep-research.d.ts

@@ -0,0 +1 @@
+export declare const deepResearchCommand: import("@jackwener/opencli/registry").CliCommand;