openpets 1.0.4

package/README.md

@@ -0,0 +1,373 @@
+# Pets CLI
+
+A command-line interface for managing OpenCode pets plugins. This tool allows you to validate plugins and display information about available pets listed in the local `opencode.json` file.
+
+## Installation
+
+The CLI is included in the `pets` package. To build and use it:
+
+```bash
+# Build the CLI
+npm run build-cli
+
+# Use directly
+./pets.sh <command> [options]
+
+# Or use with node
+node src/core/cli.js <command> [options]
+```
+
+## Commands
+
+### `validate`
+Validate plugins in current directory or pets directory.
+
+**Options:**
+- `-a, --all` - Validate all plugins in pets directory
+- `-p, --plugin <name>` - Validate a specific plugin by name
+- `-d, --directory <path>` - Specify pets directory (default: ./pets)
+
+**Examples:**
+```bash
+# Validate current directory
+pets validate
+
+# Validate all plugins in ./pets
+pets validate --all
+
+# Validate specific plugin
+pets validate --plugin jira
+
+# Validate with custom directory
+pets validate --all --directory ./my-plugins
+```
+
+### `list`
+List available pets from local `opencode.json` file.
+
+**Options:**
+- `-d, --directory <path>` - Specify directory to search for `opencode.json` (default: .)
+
+**Examples:**
+```bash
+# List pets from current directory
+pets list
+
+# List from custom directory
+pets list --directory ./config
+```
+
+### `info`
+Run validation and list available pets in one command.
+
+**Options:**
+- `-d, --directory <path>` - Specify directory to search (default: .)
+- `-p, --pets-dir <path>` - Specify pets directory (default: ./pets)
+
+**Examples:**
+```bash
+# Run validation and list pets
+pets info
+
+# Use custom directories
+pets info --directory ./config --pets-dir ./my-plugins
+```
+
+### `init`
+Create a new `pets.json` configuration file.
+
+**Options:**
+- `-d, --directory <path>` - Specify directory to create `pets.json` (default: .)
+- `-f, --force` - Overwrite existing `pets.json`
+- `-t, --template <type>` - Template to use: `basic`, `full`, `development` (default: basic)
+
+**Templates:**
+- `basic`: Minimal configuration with version and plugins array
+- `full`: Complete configuration with settings and metadata
+- `development`: Development-focused configuration with sample plugins
+
+**Examples:**
+```bash
+# Create basic configuration
+pets init
+
+# Create full configuration with settings
+pets init --template full
+
+# Overwrite existing configuration
+pets init --force --template development
+```
+
+### `config`
+Manage `pets.json` configuration settings.
+
+**Options:**
+- `-d, --directory <path>` - Specify directory with `pets.json` (default: .)
+- `-s, --set <key=value>` - Set configuration value
+- `-g, --get <key>` - Get configuration value
+- `-l, --list` - List all configuration
+
+**Examples:**
+```bash
+# Show all configuration
+pets config --list
+
+# Get specific setting
+pets config --get settings.autoValidate
+
+# Set configuration value
+pets config --set settings.autoValidate=true
+
+# Set nested value
+pets config --set settings.defaultPetsDirectory="./my-pets"
+```
+
+### `add`
+Add a plugin to `pets.json` configuration.
+
+**Options:**
+- `-d, --directory <path>` - Specify directory with `pets.json` (default: .)
+- `-p, --plugin <path>` - Plugin path to add (required)
+- `-n, --name <name>` - Plugin name (optional, auto-detected)
+- `-e, --enabled` - Enable plugin (default: true)
+
+**Examples:**
+```bash
+# Add plugin with auto-detected name
+pets add --plugin ./pets/jira
+
+# Add plugin with custom name
+pets add --plugin ./custom/path --name my-plugin
+
+# Add disabled plugin
+pets add --plugin ./pets/gitlab --enabled false
+```
+
+### `remove`
+Remove a plugin from `pets.json` configuration.
+
+**Options:**
+- `-d, --directory <path>` - Specify directory with `pets.json` (default: .)
+- `-p, --plugin <path>` - Plugin path to remove
+- `-n, --name <name>` - Plugin name to remove
+
+**Examples:**
+```bash
+# Remove by path
+pets remove --plugin ./pets/jira
+
+# Remove by name
+pets remove --name jira
+```
+
+### `show`
+Display current `pets.json` configuration in a readable format.
+
+**Options:**
+- `-d, --directory <path>` - Specify directory with `pets.json` (default: .)
+
+**Examples:**
+```bash
+# Show current configuration
+pets show
+
+# Show configuration from custom directory
+pets show --directory ./config
+```
+
+### `help`
+Show help information.
+
+## Usage Examples
+
+### Basic Workflow
+```bash
+# 1. Build CLI
+npm run build-cli
+
+# 2. Create local configuration
+./pets.sh init --template full
+
+# 3. Add plugins to local config
+./pets.sh add --plugin ./pets/jira --name jira
+./pets.sh add --plugin ./pets/gitlab --name gitlab
+
+# 4. Check all plugins are valid
+./pets.sh validate --all
+
+# 5. See what pets are configured locally
+./pets.sh show
+
+# 6. Get combined validation and listing
+./pets.sh info
+```
+
+### Development Workflow
+```bash
+# Create development configuration with sample plugins
+./pets.sh init --template development
+
+# Validate a single plugin during development
+./pets.sh validate --plugin my-new-plugin
+
+# Check current directory plugin
+./pets.sh validate
+
+# Add new plugin to local config
+./pets.sh add --plugin ./my-plugin --name my-plugin
+
+# Configure settings
+./pets.sh config --set settings.autoValidate=false
+
+# Test with different configurations
+./pets.sh list --directory ./test-config
+```
+
+### Configuration Management
+```bash
+# Initialize new configuration
+./pets.sh init --template full
+
+# Add plugins
+./pets.sh add --plugin ./pets/jira --name "Jira Plugin"
+./pets.sh add --plugin ./pets/gitlab --name "GitLab Plugin"
+
+# Manage configuration
+./pets.sh config --list
+./pets.sh config --get settings.autoValidate
+./pets.sh config --set settings.defaultPetsDirectory="./my-plugins"
+
+# Remove plugins
+./pets.sh remove --name "Jira Plugin"
+
+# Show current state
+./pets.sh show
+```
+
+### Development Workflow
+```bash
+# Validate a single plugin during development
+./pets.sh validate --plugin my-new-plugin
+
+# Check current directory plugin
+./pets.sh validate
+
+# Test with different configurations
+./pets.sh list --directory ./test-config
+```
+
+## Output
+
+The CLI provides clear, emoji-enhanced output:
+
+- ✅ Success indicators
+- ❌ Error indicators  
+- ⚠️ Warning indicators
+- 🔍 Search/validation indicators
+- 🐾 Pet-related information
+- 📋 Report headers
+
+## Integration with OpenCode
+
+The CLI integrates seamlessly with OpenCode workflows:
+
+1. **Validation First**: Always run validation before using plugins
+2. **Configuration Discovery**: Automatically reads `opencode.json` for available pets
+3. **Development Support**: Helps ensure plugin quality during development
+
+## pets.json Configuration Format
+
+The `pets.json` file allows local configuration of plugins:
+
+### Basic Structure
+```json
+{
+  "version": "1.0.0",
+  "created": "2025-11-19T15:39:56.996Z",
+  "plugins": [
+    {
+      "name": "jira",
+      "path": "./pets/jira",
+      "enabled": true,
+      "description": "Jira integration plugin",
+      "added": "2025-11-19T15:40:00.000Z"
+    }
+  ]
+}
+```
+
+### Full Structure
+```json
+{
+  "version": "1.0.0",
+  "created": "2025-11-19T15:39:56.996Z",
+  "description": "Local pets configuration",
+  "settings": {
+    "autoValidate": true,
+    "showWarnings": true,
+    "defaultPetsDirectory": "./pets"
+  },
+  "plugins": [
+    {
+      "name": "jira",
+      "path": "./pets/jira",
+      "enabled": true,
+      "description": "Jira & Confluence integration",
+      "added": "2025-11-19T15:40:00.000Z"
+    }
+  ]
+}
+```
+
+### Plugin Object Properties
+- `name`: Plugin identifier (string, required)
+- `path`: Relative or absolute path to plugin (string, required)
+- `enabled`: Whether plugin is active (boolean, default: true)
+- `description`: Plugin description (string, optional)
+- `added`: When plugin was added (ISO date string, auto-generated)
+
+### Settings Properties
+- `autoValidate`: Automatically validate plugins on operations (boolean, default: true)
+- `showWarnings`: Show validation warnings (boolean, default: true)
+- `defaultPetsDirectory`: Default directory to search for plugins (string, default: "./pets")
+
+## File Structure
+
+The CLI expects this structure:
+
+```
+project/
+├── pets.json             # Local plugin configuration
+├── opencode.json          # OpenCode configuration (optional)
+├── pets/                  # Plugin directory
+│   ├── plugin1/
+│   │   ├── package.json
+│   │   ├── index.ts
+│   │   └── opencode.json
+│   └── plugin2/
+│       ├── package.json
+│       ├── index.ts
+│       └── opencode.json
+└── src/core/
+    ├── cli.js             # Compiled CLI
+    └── cli.ts             # CLI source
+```
+
+## Error Handling
+
+The CLI provides helpful error messages for common issues:
+
+- Missing `opencode.json` files
+- Invalid plugin structure
+- Missing required files
+- JSON syntax errors
+- Missing dependencies
+
+## Contributing
+
+To extend the CLI:
+
+1. Edit `src/core/cli.ts` for new commands
+2. Update `src/core/validate-plugin.ts` for validation logic
+3. Rebuild with `npm run build-cli`
+4. Test with `./pets.sh help`

package/ai-client-base/index.ts

@@ -0,0 +1,117 @@
+import { createLogger } from "../logger"
+import * as fs from "fs"
+import * as path from "path"
+import { exec } from "child_process"
+import { promisify } from "util"
+
+const execAsync = promisify(exec)
+const logger = createLogger("base-ai-client")
+
+export interface AIImageResult {
+  success: boolean
+  images?: Array<{ url: string; width?: number; height?: number }>
+  error?: string
+  metadata?: Record<string, any>
+  requestId?: string
+  credits?: Record<string, any>
+}
+
+export interface AIVideoResult {
+  success: boolean
+  videos?: Array<{ url: string; duration?: number; width?: number; height?: number }>
+  error?: string
+  metadata?: Record<string, any>
+  requestId?: string
+  credits?: Record<string, any>
+}
+
+export interface BaseAIClientConfig {
+  apiKey: string
+  baseUrl?: string
+  debug?: boolean
+}
+
+export abstract class BaseAIClient {
+  protected apiKey: string
+  protected baseUrl?: string
+  protected debug: boolean
+
+  constructor(config: BaseAIClientConfig) {
+    this.apiKey = config.apiKey
+    this.baseUrl = config.baseUrl
+    this.debug = config.debug || false
+  }
+
+  abstract get providerName(): string
+
+  protected ensureApiKey(envVarName: string): void {
+    if (!this.apiKey || this.apiKey.trim() === "") {
+      throw new Error(`${envVarName} environment variable is required but not set`)
+    }
+  }
+
+  protected async downloadMedia(url: string, outputDir: string, prefix: string): Promise<string> {
+    try {
+      if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true })
+      }
+
+      const timestamp = Date.now()
+      const extension = url.includes('.mp4') || url.includes('video') ? 'mp4' : 'png'
+      const filename = `${prefix}-${timestamp}.${extension}`
+      const filepath = path.join(outputDir, filename)
+
+      logger.info(`Downloading media from ${url}`)
+
+      const response = await fetch(url)
+      if (!response.ok) {
+        throw new Error(`Failed to download: ${response.statusText}`)
+      }
+
+      const buffer = await response.arrayBuffer()
+      fs.writeFileSync(filepath, Buffer.from(buffer))
+
+      logger.info(`Media saved to ${filepath}`)
+      return filepath
+    } catch (error: any) {
+      logger.error(`Failed to download media: ${error.message}`)
+      throw error
+    }
+  }
+
+  protected async openInDefaultViewer(filepath: string): Promise<void> {
+    try {
+      const platform = process.platform
+      let command: string
+
+      if (platform === "darwin") {
+        command = `open "${filepath}"`
+      } else if (platform === "win32") {
+        command = `start "" "${filepath}"`
+      } else {
+        command = `xdg-open "${filepath}"`
+      }
+
+      await execAsync(command)
+      logger.info(`Opened ${filepath} in default viewer`)
+    } catch (error: any) {
+      logger.warn(`Failed to open in viewer: ${error.message}`)
+    }
+  }
+
+  protected getMimeType(filename: string): string {
+    const ext = path.extname(filename).toLowerCase()
+    const mimeTypes: Record<string, string> = {
+      '.jpg': 'image/jpeg',
+      '.jpeg': 'image/jpeg',
+      '.png': 'image/png',
+      '.gif': 'image/gif',
+      '.webp': 'image/webp',
+      '.mp4': 'video/mp4',
+      '.mov': 'video/quicktime',
+      '.avi': 'video/x-msvideo',
+      '.webm': 'video/webm'
+    }
+    return mimeTypes[ext] || 'application/octet-stream'
+  }
+}

package/browser.ts

@@ -0,0 +1,10 @@
+/**
+ * Browser-safe exports from openpets
+ *
+ * This module only exports code that doesn't use Node.js APIs like fs, path, etc.
+ * Use this entry point when importing from browser/frontend code.
+ */
+
+export * from './types'
+export * from './search-pets'
+export * from './schema-helpers'