hiresquire-cli 1.1.0 → 1.2.2

package/README.md

@@ -15,6 +15,31 @@ HireSquire CLI enables AI agents and developers to screen candidates directly fr
 - 📄 **JSON Output**: Machine-readable output for automation
 - ⚙️ **Config Management**: Easy API token setup and storage
 - 🔗 **Webhook Support**: Conditional webhooks for automated workflows
+- 📄 **Resume Parsing**: Supports PDF, DOCX, DOC, TXT, and Markdown files
+
+## Supported Resume Formats
+
+The CLI automatically detects and parses the following resume formats:
+
+| Format | Extension | Parser |
+|--------|-----------|--------|
+| PDF | `.pdf` | pdf-parse |
+| Word DOCX | `.docx` | officeparser |
+| Word DOC | `.doc` | officeparser |
+| Plain Text | `.txt` | Native |
+| Markdown | `.md` | Native |
+
+No manual conversion needed - just point to your resume files or directory!
+
+### Installation Notes
+
+When installing from source, the parser dependencies will be included automatically:
+
+```bash
+npm install -g hiresquire-cli
+```
+
+The parsers are pure JavaScript with no native dependencies, making them suitable for all environments including Docker containers.
 
 ## Installation
 
@@ -87,6 +112,13 @@ hiresquire results --job 123
 | [`candidate`](#candidate) | Get candidate details |
 | [`set-status`](#set-status) | Update candidate status |
 | [`schema`](#schema) | Get API schema |
+| [`whoami`](#whoami) | Verify API token and get profile/balance info |
+| [`agent-keys`](#agent-keys) | Manage agent-specific API keys |
+| [`credits`](#credits) | Manage prepaid credits (balance, checkout, auto-reload) |
+| [`calendar`](#calendar) | Manage calendar connections (Calendly, Cal.com) |
+| [`interviews`](#interviews) | Manage and schedule interviews |
+| [`meetings`](#meetings) | Generate meeting links (Zoom, Google Meet) |
+| [`estimate`](#estimate) | Estimate screening costs |
 
 ### init
 
@@ -114,7 +146,7 @@ Options:
 - `-t, --title <title>` - Job posting title (required)
 - `-d, --description <description>` - Job description (string or @file) (required)
 - `-r, --resumes <paths>` - Resume files or directory (comma-separated or @file)
-- `-l, --leniency <1-10>` - Screening leniency (1=strict, 10=loose), default: 5
+- `-l, --leniency <1-10>` - Screening leniency (1=loose, 10=strict), default: 5
 - `-w, --webhook <url>` - Webhook URL for notifications
 - `--watch` - Poll for completion and show results
 - `--min-score <number>` - Minimum score threshold (0-100)
@@ -195,6 +227,37 @@ Options:
 - `-l, --leniency <number>` - Default leniency level
 - `--clear` - Clear all configuration
 
+### credits
+
+Manage prepaid credits:
+
+```bash
+# Check current balance
+hiresquire credits balance
+
+# List available credit packs
+hiresquire credits list-packs
+
+# Create checkout session
+hiresquire credits checkout --pack pouch
+
+# View transaction history
+hiresquire credits transactions
+
+# Enable auto-reload (when balance drops below threshold)
+hiresquire credits auto-reload-enable --threshold 10 --amount 25 --payment-method-id pm_12345
+
+# Disable auto-reload
+hiresquire credits auto-reload-disable
+```
+
+Options:
+- `-a, --action <action>` - Action: balance, list-packs, checkout, transactions, auto-reload-enable, auto-reload-disable
+- `-p, --pack <pack>` - Credit pack: pouch, satchel, chest
+- `--threshold <number>` - Auto-reload threshold in dollars
+- `--amount <number>` - Amount to reload each time
+- `--payment-method-id <id>` - Stripe payment method ID
+
 ## Agent Integration Examples
 
 ### OpenClaw

package/dist/api.d.ts

@@ -0,0 +1,267 @@
+/**
+ * HireSquire CLI - API Client
+ *
+ * HTTP client for interacting with the HireSquire API
+ * Handles authentication, request/response typing, and error handling
+ */
+import { Config, CreateJobParams, CreateJobResponse, JobStatusResponse, ResultsResponse, JobsListResponse, EmailParams, EmailResponse, Resume, CalendarConnection, CreateCalendarConnectionParams, Interview, CreateInterviewParams, MeetingLinkResponse, AvailableSlotsResponse } from './types';
+export declare class ApiClient {
+    private client;
+    private config;
+    constructor(config: Config);
+    private shouldRetryRequest;
+    private handleError;
+    /**
+     * Generic GET request
+     */
+    get<T = any>(url: string, config?: any): Promise<{
+        data: T;
+    }>;
+    /**
+     * Generic POST request
+     */
+    post<T = any>(url: string, data?: any, config?: any): Promise<{
+        data: T;
+    }>;
+    /**
+     * Generic PUT request
+     */
+    put<T = any>(url: string, data?: any, config?: any): Promise<{
+        data: T;
+    }>;
+    /**
+     * Generic DELETE request
+     */
+    delete<T = any>(url: string, config?: any): Promise<{
+        data: T;
+    }>;
+    /**
+     * Create a new screening job
+     */
+    createJob(params: CreateJobParams): Promise<CreateJobResponse>;
+    /**
+     * Upload a ZIP file containing resumes to create a new screening job
+     */
+    uploadZip(params: Omit<CreateJobParams, 'resumes'> & {
+        zipPath: string;
+    }): Promise<CreateJobResponse>;
+    /**
+     * Get job status
+     */
+    getJobStatus(jobId: number): Promise<JobStatusResponse>;
+    /**
+     * Get job results
+     */
+    getResults(jobId: number, options?: {
+        min_score?: number;
+        only_top_n?: number;
+    }): Promise<ResultsResponse>;
+    /**
+     * List all jobs
+     */
+    listJobs(options?: {
+        status?: string;
+        page?: number;
+        per_page?: number;
+    }): Promise<JobsListResponse>;
+    /**
+     * Generate an email for a candidate
+     */
+    generateEmail(params: EmailParams): Promise<EmailResponse>;
+    /**
+     * Poll for job completion
+     */
+    pollForCompletion(jobId: number, options?: {
+        interval?: number;
+        timeout?: number;
+        onProgress?: (status: JobStatusResponse) => void;
+    }): Promise<JobStatusResponse>;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+    /**
+     * Test API connection
+     */
+    testConnection(): Promise<boolean>;
+    /**
+     * Get current config
+     */
+    getConfig(): Config;
+    /**
+     * Cancel a running job
+     */
+    cancelJob(jobId: number): Promise<{
+        job_id: number;
+        status: string;
+        message: string;
+    }>;
+    /**
+     * Compare multiple candidates side-by-side
+     */
+    compareCandidates(jobId: number, candidateIds: number[]): Promise<{
+        job_id: number;
+        candidates: Array<{
+            id: number;
+            name: string;
+            score: number;
+            summary: string;
+        }>;
+        comparison: {
+            top_candidate: string;
+            score_diff: number;
+        };
+    }>;
+    /**
+     * Report hiring outcome to improve AI accuracy
+     */
+    reportOutcome(jobId: number, candidateId: number, outcome: 'hired' | 'rejected' | 'withdrawn'): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Test a webhook endpoint
+     */
+    testWebhook(webhookUrl: string): Promise<{
+        success: boolean;
+        message: string;
+        response_code?: number;
+    }>;
+    /**
+     * Get current rate limit status
+     */
+    getRateLimit(): Promise<{
+        limit: number;
+        remaining: number;
+        reset_at: string;
+        reset_in_seconds: number;
+    }>;
+    /**
+     * Get a specific candidate
+     */
+    getCandidate(candidateId: number): Promise<any>;
+    /**
+     * Update candidate status
+     */
+    updateCandidateStatus(candidateId: number, status: 'pending' | 'shortlisted' | 'rejected' | 'interviewed' | 'offered' | 'hired'): Promise<{
+        success: boolean;
+        candidate: any;
+    }>;
+    /**
+     * Get API schema for discovery
+     */
+    getSchema(): Promise<any>;
+    /**
+     * List calendar connections
+     */
+    listCalendarConnections(): Promise<{
+        success: boolean;
+        data: CalendarConnection[];
+    }>;
+    /**
+     * Create a calendar connection
+     */
+    createCalendarConnection(params: CreateCalendarConnectionParams): Promise<{
+        success: boolean;
+        data: CalendarConnection;
+        message: string;
+    }>;
+    /**
+     * Delete a calendar connection
+     */
+    deleteCalendarConnection(id: number): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Get available slots from calendar
+     */
+    getAvailableSlots(params: {
+        provider: string;
+        date: string;
+        duration?: number;
+    }): Promise<AvailableSlotsResponse>;
+    /**
+     * List interviews
+     */
+    listInterviews(jobId?: number): Promise<{
+        success: boolean;
+        data: Interview[];
+    }>;
+    /**
+     * Create an interview
+     */
+    createInterview(params: CreateInterviewParams): Promise<{
+        success: boolean;
+        data: Interview;
+        message: string;
+    }>;
+    /**
+     * Show a specific interview
+     */
+    showInterview(id: number): Promise<{
+        success: boolean;
+        data: Interview;
+    }>;
+    /**
+     * Update an interview
+     */
+    updateInterview(id: number, params: Partial<CreateInterviewParams>): Promise<{
+        success: boolean;
+        data: Interview;
+        message: string;
+    }>;
+    /**
+     * Delete/cancel an interview
+     */
+    deleteInterview(id: number): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Generate a meeting link
+     */
+    generateMeetingLink(params: {
+        provider: string;
+        topic: string;
+        duration?: number;
+    }): Promise<MeetingLinkResponse>;
+    /**
+     * Create a checkout session for credit purchase
+     */
+    createCheckoutSession(params: {
+        pack?: string;
+        amount?: number;
+        success_url?: string;
+        cancel_url?: string;
+    }): Promise<any>;
+    /**
+     * Proxy MCP JSON-RPC requests to the server
+     */
+    mcpProxy(payload: any): Promise<any>;
+    /**
+     * Regenerate an agent API key
+     */
+    regenerateAgentKey(id: number): Promise<any>;
+}
+/**
+ * Create API client from config
+ */
+export declare function createApiClient(config: Config): ApiClient;
+/**
+ * Create API client from token
+ */
+export declare function createApiClientFromToken(token: string, baseUrl?: string): ApiClient;
+/**
+ * Read resume from file path (async - supports PDF, DOCX, DOC, TXT, MD)
+ */
+export declare function readResumeFromFile(filePath: string): Promise<Resume>;
+/**
+ * Read resumes from directory (async)
+ */
+export declare function readResumesFromDirectory(dirPath: string, currentCount?: number): Promise<Resume[]>;
+/**
+ * Read multiple resume files (async)
+ */
+export declare function readResumesFromPaths(paths: string[]): Promise<Resume[]>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}