yiyan-browser-agent 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 doubao-browser-agent contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,145 @@
+# doubao-browser-agent
+
+NPM package for interacting with Doubao (豆包) web version via Playwright.
+
+## Features
+
+- Automated browser interaction with Doubao web version
+- Automatic Chrome profile management for login persistence
+- Retry mechanism for network failures
+- CLI and Node.js API support
+- TypeScript support with full type definitions
+
+## Prerequisites
+
+1. **Chrome browser** installed on your system
+2. **Logged into Doubao** (https://www.doubao.com/chat/) in your Chrome browser at least once
+
+The package uses your Chrome profile to maintain login state, so you need to login manually first.
+
+## Installation
+
+```bash
+npm install doubao-browser-agent
+```
+
+## Node.js API Usage
+
+```typescript
+import { DoubaoAgent } from 'doubao-browser-agent';
+
+// Create agent instance
+const agent = new DoubaoAgent({
+  timeout: 120000,    // Timeout in milliseconds (default: 120000)
+  retryCount: 3,      // Retry count (default: 3)
+});
+
+// Send a question and get answer
+try {
+  const answer = await agent.ask('What is TypeScript?');
+  console.log('Answer:', answer);
+} catch (error) {
+  console.error('Error:', error.message);
+}
+
+// Check login status
+const status = agent.status();
+console.log('Logged in:', status.loggedIn);
+console.log('Profile path:', status.profilePath);
+
+// Clear saved profile (if needed)
+await agent.reset();
+```
+
+## CLI Usage
+
+```bash
+# Send a question
+doubao-agent ask "What is TypeScript?"
+
+# With options
+doubao-agent ask "Explain Promise" --timeout 60000 --retry 5
+
+# Check login status
+doubao-agent status
+
+# Clear saved profile
+doubao-agent reset
+
+# Show help
+doubao-agent --help
+```
+
+## API Documentation
+
+### `DoubaoAgent`
+
+Main class for interacting with Doubao.
+
+#### Constructor
+
+```typescript
+new DoubaoAgent(options?: DoubaoAgentOptions)
+```
+
+**Options:**
+- `timeout?: number` - Timeout in milliseconds (default: 120000)
+- `retryCount?: number` - Number of retry attempts (default: 3)
+- `profileDir?: string` - Custom directory for storing Chrome profile copy
+- `chromePath?: string` - Custom Chrome executable path
+
+#### Methods
+
+##### `ask(question: string): Promise<string>`
+
+Send a question to Doubao and return the answer.
+
+##### `status(): { loggedIn: boolean; profilePath: string }`
+
+Check the login status (whether profile exists).
+
+##### `reset(): Promise<void>`
+
+Clear the saved profile copy.
+
+### Error Types
+
+The package throws `DoubaoAgentError` with the following error types:
+
+| Type | Description |
+|------|-------------|
+| `BROWSER_LAUNCH` | Failed to launch Chrome browser |
+| `PROFILE_COPY` | Failed to copy Chrome profile |
+| `TIMEOUT` | Timeout while waiting for response |
+| `NETWORK` | Network or connection error |
+
+```typescript
+import { DoubaoAgentError } from 'doubao-browser-agent';
+
+try {
+  const answer = await agent.ask('Hello');
+} catch (error) {
+  if (error instanceof DoubaoAgentError) {
+    console.log('Error type:', error.type);
+    console.log('Error message:', error.message);
+  }
+}
+```
+
+## How It Works
+
+1. On first run, the package copies your Chrome profile to a temporary directory
+2. Launches Chrome in headless mode with the copied profile
+3. Navigates to Doubao chat page
+4. Sends your question and waits for response
+5. Extracts the response and closes the browser
+
+## Supported Platforms
+
+- Windows (Chrome paths: `C:/Program Files/Google/Chrome/Application/chrome.exe`)
+- macOS (Chrome paths: `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`)
+- Linux (Chrome paths: `/usr/bin/google-chrome`, `/usr/bin/chrome`)
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,26 @@
+import { C as CliOutput } from './types-BhQ78DYf.js';
+
+/** CLI 帮助信息 */
+declare function printHelp(): void;
+/** 解析后的 CLI 参数 */
+interface ParsedArgs {
+    command: 'ask' | 'status' | 'reset' | 'login' | 'help' | null;
+    question?: string;
+    timeout?: number;
+    retry?: number;
+    headless?: boolean;
+}
+/**
+ * 解析 CLI 参数
+ */
+declare function parseCliArgs(args: string[]): ParsedArgs;
+/**
+ * 格式化 CLI 输出为 JSON
+ */
+declare function formatCliOutput(output: CliOutput): string;
+/**
+ * CLI 主入口
+ */
+declare function runCli(args: string[]): Promise<void>;
+
+export { formatCliOutput, parseCliArgs, printHelp, runCli };