@dccxx/auggiegw 1.0.18 → 1.0.20

package/CLAUDE.md

@@ -0,0 +1,148 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+`@dccxx/auggiegw` is a CLI tool for managing Augment Gateway authentication, proxy configuration, and custom prompts. It authenticates with Augment Gateway, fetches proxy configurations, manages custom prompts, and integrates with the Auggie CLI.
+
+## Build & Development Commands
+
+```bash
+# Install dependencies
+bun install
+
+# Build TypeScript to dist/ (uses Bun's native build with Node.js target)
+bun run build
+
+# Lint with Biome (auto-fix enabled)
+bun run lint
+
+# Clean dist directory
+bun run clean
+
+# Development: run CLI commands directly
+bun run src/cli.ts login
+bun run src/cli.ts fetch
+bun run src/cli.ts auggie --print "hi"
+
+# Publish workflow (bumps version, lints, builds, publishes)
+bun run publish:auto
+# Or using justfile:
+just release
+```
+
+## Package Manager
+
+**ALWAYS use Bun** - never npm, yarn, or pnpm.
+
+## Architecture
+
+Single-file CLI application (`src/cli.ts`) using Commander.js. All logic is contained in one file with clear separation:
+
+1. **Type Definitions** (lines 18-139): All interfaces for API responses and internal data structures
+2. **Constants** (lines 141-145): File paths for auth and session storage
+3. **Utility Functions** (lines 147-227): Config loading, auth data management
+4. **API Functions** (lines 238-472): HTTP calls to Augment Gateway API
+5. **Command Handlers** (lines 474-770): Business logic for each CLI command
+6. **CLI Setup** (lines 772-823): Commander.js program definition
+
+### Key File Locations
+
+- Auth credentials: `~/.auggiegw/auth.json`
+- Augment session: `~/.augment/session.json`
+- Custom prompts: `~/.augment/commands/*.md`
+- Auggie sessions: `~/.augment/sessions/*.json`
+
+## Special Logic & Non-Obvious Implementations
+
+### Proxy Password Parsing (lines 544-550)
+
+The proxy password contains an `@` symbol as a delimiter. The actual password is extracted by taking everything before the first `@`:
+
+```typescript
+const atIndex = rawPassword.indexOf('@');
+const proxyPassword = rawPassword.substring(0, atIndex);
+```
+
+### Session Deletion Logic (lines 564-639)
+
+When `shouldDeleteSession()` returns true, the code performs a complex session reset:
+
+1. Reads all JSON files from `~/.augment/sessions/`
+2. Sorts by modification time (most recent first)
+3. Deletes all files except the most recent
+4. For the most recent file:
+   - Generates a new UUID for `sessionId`
+   - Replaces all `"request_id"` keys with `"request_id_temp"` (invalidates old requests)
+   - Saves with new filename matching the new UUID
+   - Deletes the old file
+
+If this fails, falls back to `auggie session delete` command.
+
+### Session Options Priority (lines 169-182)
+
+Session deletion follows this precedence:
+1. CLI flags (`--preserve-session` / `--delete-session`)
+2. Environment variable `AUGGIEGW_DELETE_SESSION`
+3. Default: delete session (true)
+
+### Refresh Commands Logic (--refresh-commands flag)
+
+When `--refresh-commands` is provided:
+1. Deletes all existing `.md` files in `~/.augment/commands/`
+2. Fetches all prompts from the API using `getAllPrompts()`
+3. Saves the fetched prompts to `~/.augment/commands/`
+
+When `--refresh-commands` is NOT provided (default):
+- Skips prompt fetching entirely for faster operation
+- Only performs authentication
+
+The `--auth-only` flag takes precedence over `--refresh-commands` (if both are provided, prompts are skipped).
+
+### Account Switching Logic (lines 714-770)
+
+The `switch-account` command:
+- Fetches accounts sorted by `purchased_at` descending (newest first)
+- Finds current account (status "in-use")
+- Switches to the account at index `currentIndex - 1` (the newer one)
+- After switching, calls `handleFetch({ authOnly: true, deleteSession: true })`
+
+### Prompt File Format (lines 305-319)
+
+Prompts are saved as markdown with YAML frontmatter:
+
+```markdown
+---
+description: {prompt.name}
+---
+
+{prompt.content}
+```
+
+### Authentication Token Resolution (lines 197-205)
+
+`getAuthToken()` checks environment variable `AUGGIEGW_AUTH_TOKEN` first, then falls back to reading from `~/.auggiegw/auth.json`.
+
+### Paginated Prompt Fetching (lines 264-303)
+
+`getAllPrompts()` fetches prompts page by page (limit=10) with 500ms delay between requests to avoid rate limiting.
+
+## Environment Variables
+
+- `AUGMENT_GATEWAY_URL`: API base URL (default: `https://augmentgateway.1app.space`)
+- `AUGGIEGW_AUTH_TOKEN`: Auth token (bypasses login requirement)
+- `AUGGIEGW_DELETE_SESSION`: Control session deletion (`false` to preserve)
+
+## Quality Assurance
+
+After any code changes:
+1. Run `bun run lint` - Biome linter, never use `--unsafe`
+2. Run `bun run build` - Uses Bun's native bundler with Node.js target + tsc for type declarations
+
+## Protected Files
+
+Never edit:
+- `*.http` files
+- Files in `.idea/` directory
+

package/auggie_shell_conversation.txt

@@ -0,0 +1,96 @@
+================================================================================
+[2025-11-27T21:14:57.407Z]
+Refactor the delete session logic in `src/cli.ts` at lines 564-570. Currently it calls `auggie session delete` command, but we need a completely new implementation.
+
+**New Logic Requirements:**
+
+1. Read all JSON files from the directory: `~\.augment\sessions` (use os.homedir() to get home directory)
+
+2. Sort files by their modified time (use fs.stat or similar to get mtime)
+
+3. Delete ALL files EXCEPT the most recently modified one
+
+4. For the most recently modified file that is kept:
+   - Generate a new random UUID v4
+   - Update the `sessionId` field inside the JSON content to this new UUID
+   - Replace ALL occurrences of the key `"request_id"` with `"request_id_temp"` by:
+     - Converting JSON to string
+     - Using string replace (text replacement)
+     - Converting back to JSON
+   - Rename the file to match the new UUID (e.g., `{new-uuid}.json`)
+
+**Example:**
+If there are files:
+- `C:\Users\0x317\.augment\sessions\3ac2b36f-7328-444a-a1ec-a1d5cb81c0f1.json`
+- `C:\Users\0x317\.augment\sessions\3ac2b36f-7328-444a-a1ec-a1d5cb81c0f2.json`
+
+Keep only the most recently modified one, change its sessionId to a new UUID, replace all "request_id" keys with "request_id_temp", and rename the file to the new UUID.
+
+Make sure to:
+- Use the `uuid` package for generating UUID v4 (check if already imported, if not add it)
+- Handle edge cases (no files, only one file, directory doesn't exist)
+- Keep the try-catch wrapper for silent error handling
+- Use async/await properly with fs/promises
+
+After implementation, run `bun run lint` and `bun run build` to verify the code quality and build.
+
+Do not create or modify any markdown document files or code examples.
+
+================================================================================
+[2025-11-27T21:18:39.385Z]
+In `src/cli.ts`, modify the catch block at lines 629-631 to add a fallback to the old logic.
+
+Currently:
+```
+} catch {
+  // Silently ignore session management errors
+}
+```
+
+Change it to:
+```
+} catch {
+  // Fallback to old logic if new session management fails
+  try {
+    await execAsync('auggie session delete');
+  } catch {
+    // Silently ignore fallback errors
+  }
+}
+```
+
+This requires re-adding the `execAsync` utility that was previously removed. Add back:
+- Import `exec` from `node:child_process`
+- Import `promisify` from `node:util`  
+- Create `const execAsync = promisify(exec);`
+
+After changes, run `bun run lint` and `bun run build` to verify.
+
+Do not create or modify any markdown document files or code examples.
+
+================================================================================
+[2025-11-27T21:21:34.938Z]
+Revert the delete session logic in `src/cli.ts` back to the original simple implementation.
+
+The current implementation (around lines 564-635) has complex logic for reading session files, sorting by mtime, etc. 
+
+Revert it back to the original simple code:
+
+```
+if (shouldDeleteSession(options)) {
+  try {
+    await execAsync('auggie session delete');
+  } catch {
+    // Silently ignore auggie session delete errors
+  }
+}
+```
+
+Also:
+- Remove the `uuid` import (`import { v4 as uuidv4 } from 'uuid';`) since it's no longer needed
+- Keep the `exec`, `promisify`, and `execAsync` since they are needed for the original logic
+
+After changes, run `bun run lint` and `bun run build` to verify.
+
+Do not create or modify any markdown document files or code examples.
+

package/auggie_shell_user_request.txt

@@ -0,0 +1,23 @@
+Revert the delete session logic in `src/cli.ts` back to the original simple implementation.
+
+The current implementation (around lines 564-635) has complex logic for reading session files, sorting by mtime, etc. 
+
+Revert it back to the original simple code:
+
+```
+if (shouldDeleteSession(options)) {
+  try {
+    await execAsync('auggie session delete');
+  } catch {
+    // Silently ignore auggie session delete errors
+  }
+}
+```
+
+Also:
+- Remove the `uuid` import (`import { v4 as uuidv4 } from 'uuid';`) since it's no longer needed
+- Keep the `exec`, `promisify`, and `execAsync` since they are needed for the original logic
+
+After changes, run `bun run lint` and `bun run build` to verify.
+
+Do not create or modify any markdown document files or code examples.

package/auggiegw/https---d16.api.augmentcode.com-get-credit-info.bru

@@ -0,0 +1,32 @@
+meta {
+  name: https://d16.api.augmentcode.com/get-credit-info
+  type: http
+  seq: 3
+}
+
+post {
+  url: https://0.dathttps//d16.api.augmentcode.com/get-credit-info
+  body: none
+  auth: inherit
+}
+
+headers {
+  host: d16.api.augmentcode.com
+  connection: keep-alive
+  Content-Type: application/json
+  User-Agent: Augment.vscode-augment/0.654.1 (win32; x64; 10.0.26100) vscode/1.106.3
+  x-request-id: f9b882d5-8be9-4745-aa80-66d19cd17d75
+  x-request-session-id: 334da8ee-d3cd-4881-8ec8-a1fcd08f6eef
+  Authorization: Bearer d5351ac0bea26c7a5f4d956af9aa4cb3e5bf8da889447357df0e45ee725fc8bc
+  accept: */*
+  accept-language: *
+  sec-fetch-mode: cors
+  accept-encoding: br, gzip, deflate
+  sentry-trace: 7ff8be7e699ff3d88421c3242cf48d82-baca496bfa68b990
+  baggage: sentry-environment=production,sentry-release=vscode-extension%400.654.1,sentry-public_key=65b77c01171371d3328fc9a6d5941e00,sentry-trace_id=7ff8be7e699ff3d88421c3242cf48d82,sentry-org_id=4509262619082752
+  content-length: 2
+}
+
+settings {
+  encodeUrl: false
+}