{"_id":"@clearfeed-ai/quix-bamboohr-agent","_rev":"7-1e429faafdf285b34c655dc8267b8e69","name":"@clearfeed-ai/quix-bamboohr-agent","dist-tags":{"latest":"2.2.0"},"versions":{"1.0.0":{"name":"@clearfeed-ai/quix-bamboohr-agent","version":"1.0.0","license":"Apache-2.0","_id":"@clearfeed-ai/quix-bamboohr-agent@1.0.0","maintainers":[{"name":"batflarrow","email":"dwivedia2001@gmail.com"},{"name":"lalitindoria","email":"l.k.indoria@gmail.com"},{"name":"sharath_clrfd","email":"sharath@clearfeed.ai"}],"dist":{"shasum":"5680a92b26ed665a7bb126ff0daef58c64afd1c8","tarball":"https://registry.npmjs.org/@clearfeed-ai/quix-bamboohr-agent/-/quix-bamboohr-agent-1.0.0.tgz","fileCount":23,"integrity":"sha512-hb8cmNOtz8zigXD6wxjH5PBO1DW+bYsQ3QSUQjxAABvt7+QmvW2pT9VQPzSaM4wWkUI3YAlQqk78wEYwnclmCA==","signatures":[{"sig":"MEUCICkn3Q6M2P7YgQZV0O6kznHkWQhYTBao8Y6TXGMA4mtyAiEAp5B/yv9AWJtAAr6wBatBM4Ba2m9oqmyQjTKvJQxzy7s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":47849},"jest":{"preset":"ts-jest","testRegex":".*\\.spec\\.ts$","transform":{"^.+\\.(t|j)s$":"ts-jest"},"testTimeout":30000,"testEnvironment":"node","coverageDirectory":"coverage","setupFilesAfterEnv":["<rootDir>/src/test-setup.ts"],"collectCoverageFrom":["src/**/*.(t|j)s"],"moduleFileExtensions":["js","json","ts"]},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"7f856b2e61dec42a96c9f3254adec61061ebc78c","scripts":{"test":"jest","build":"yarn clean && tsc","clean":"rm -rf ./dist && find . -type f \\( -name \"*.js\" -o -name \"*.js.map\" -o -name \"*.d.ts\" \\) ! -path \"*/node_modules/*\" -delete","prepublishOnly":"yarn build","test:integration":"jest --testNamePattern='Integration'"},"_npmUser":{"name":"lalitindoria","email":"l.k.indoria@gmail.com"},"_npmVersion":"10.7.0","description":"A comprehensive integration with BambooHR's API for employee management and time off operations.","directories":{},"_nodeVersion":"20.14.0","dependencies":{"axios":"^1.8.2","@clearfeed-ai/quix-common-agent":"1.2.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","dotenv":"^16.4.5","ts-jest":"^29.2.5","typescript":"^5.7.3","@types/jest":"^29.5.14","@types/node":"^22.10.7"},"peerDependencies":{"@langchain/core":"0.3.62"},"_npmOperationalInternal":{"tmp":"tmp/quix-bamboohr-agent_1.0.0_1753030898523_0.3014034047835532","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@clearfeed-ai/quix-bamboohr-agent","version":"1.0.1","license":"Apache-2.0","_id":"@clearfeed-ai/quix-bamboohr-agent@1.0.1","maintainers":[{"name":"batflarrow","email":"dwivedia2001@gmail.com"},{"name":"lalitindoria","email":"l.k.indoria@gmail.com"},{"name":"sharath_clrfd","email":"sharath@clearfeed.ai"}],"dist":{"shasum":"5f76aea185f22672b43ff9ae40d289d6bb6306fd","tarball":"https://registry.npmjs.org/@clearfeed-ai/quix-bamboohr-agent/-/quix-bamboohr-agent-1.0.1.tgz","fileCount":23,"integrity":"sha512-tOjtmGwe0zDzcqxUElj6KUDo0Vpg6uxO3/Q4JHVP1LVwAui5YDYwIMHqd1kHWcy5LMG/ElsyIWFLRlhkppN6sQ==","signatures":[{"sig":"MEQCIALSE2tshnPhA+Nd0Whl3a6zdoENZ7Vq3BDEe2KsWxJ/AiALDD+R5B47hh3XNG1E8qN5/MRz4RxUY7+18bn5HF5NAw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":47850},"jest":{"preset":"ts-jest","testRegex":".*\\.spec\\.ts$","transform":{"^.+\\.(t|j)s$":"ts-jest"},"testTimeout":30000,"testEnvironment":"node","coverageDirectory":"coverage","setupFilesAfterEnv":["<rootDir>/src/test-setup.ts"],"collectCoverageFrom":["src/**/*.(t|j)s"],"moduleFileExtensions":["js","json","ts"]},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"85a79b589e856eb3148d8fad162f98fd2c969dda","scripts":{"test":"jest","build":"yarn clean && tsc","clean":"rm -rf ./dist && find . -type f \\( -name \"*.js\" -o -name \"*.js.map\" -o -name \"*.d.ts\" \\) ! -path \"*/node_modules/*\" -delete","prepublishOnly":"yarn build","test:integration":"jest --testNamePattern='Integration'"},"_npmUser":{"name":"batflarrow","email":"dwivedia2001@gmail.com"},"_npmVersion":"10.8.0","description":"A comprehensive integration with BambooHR's API for employee management and time off operations.","directories":{},"_nodeVersion":"20.12.0","dependencies":{"axios":"^1.12.2","@clearfeed-ai/quix-common-agent":"1.2.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","dotenv":"^16.4.5","ts-jest":"^29.2.5","typescript":"^5.7.3","@types/jest":"^29.5.14","@types/node":"^22.10.7"},"peerDependencies":{"@langchain/core":"0.3.62"},"_npmOperationalInternal":{"tmp":"tmp/quix-bamboohr-agent_1.0.1_1757918070119_0.9761536180656929","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@clearfeed-ai/quix-bamboohr-agent","version":"2.0.0","license":"Apache-2.0","_id":"@clearfeed-ai/quix-bamboohr-agent@2.0.0","maintainers":[{"name":"batflarrow","email":"dwivedia2001@gmail.com"},{"name":"lalitindoria","email":"l.k.indoria@gmail.com"},{"name":"sharath_clrfd","email":"sharath@clearfeed.ai"}],"dist":{"shasum":"c72d45dcdb67db7e3e28466869bb67c02043c402","tarball":"https://registry.npmjs.org/@clearfeed-ai/quix-bamboohr-agent/-/quix-bamboohr-agent-2.0.0.tgz","fileCount":23,"integrity":"sha512-UKBSIjpjc5HYKygU76VdbtsGQ48gpkHc+JAC1HhRCunYiPQv8cvlnkVQcejT4Jbh/j78ILDWhBw+ddNUHvgsuQ==","signatures":[{"sig":"MEYCIQDPBy8CgtyZeDLRBbx7bDr3uvb9LRXpyLsE9QNJ1BPtWgIhAIBa9Ssi5xcTvLmv/+T7jU9Pu82bNKC6UsTjKb6YysnZ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48024},"jest":{"preset":"ts-jest","testRegex":".*\\.spec\\.ts$","transform":{"^.+\\.(t|j)s$":"ts-jest"},"testTimeout":30000,"testEnvironment":"node","coverageDirectory":"coverage","setupFilesAfterEnv":["<rootDir>/src/test-setup.ts"],"collectCoverageFrom":["src/**/*.(t|j)s"],"moduleFileExtensions":["js","json","ts"]},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"79c4fe301ab862e2fd64c10e024eb8813b3391ec","scripts":{"test":"jest","build":"yarn clean && tsc","clean":"rm -rf ./dist && find . -type f \\( -name \"*.js\" -o -name \"*.js.map\" -o -name \"*.d.ts\" \\) ! -path \"*/node_modules/*\" -delete","prepublishOnly":"yarn build","test:integration":"jest --testNamePattern='Integration'"},"_npmUser":{"name":"batflarrow","email":"dwivedia2001@gmail.com"},"_npmVersion":"10.8.0","description":"A comprehensive integration with BambooHR's API for employee management and time off operations.","directories":{},"_nodeVersion":"20.12.0","dependencies":{"axios":"^1.12.2","@clearfeed-ai/quix-common-agent":"2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","dotenv":"^16.4.5","ts-jest":"^29.2.5","typescript":"^5.7.3","@types/jest":"^29.5.14","@types/node":"^22.10.7"},"peerDependencies":{"@langchain/core":"1.1.8"},"_npmOperationalInternal":{"tmp":"tmp/quix-bamboohr-agent_2.0.0_1767005989313_0.8433101410824992","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@clearfeed-ai/quix-bamboohr-agent","version":"2.1.0","license":"Apache-2.0","_id":"@clearfeed-ai/quix-bamboohr-agent@2.1.0","maintainers":[{"name":"batflarrow","email":"dwivedia2001@gmail.com"},{"name":"lalitindoria","email":"l.k.indoria@gmail.com"},{"name":"sharath_clrfd","email":"sharath@clearfeed.ai"}],"dist":{"shasum":"35f1bdb099ef58698374b19c0d2efbdf11644611","tarball":"https://registry.npmjs.org/@clearfeed-ai/quix-bamboohr-agent/-/quix-bamboohr-agent-2.1.0.tgz","fileCount":23,"integrity":"sha512-Tacvni+I6H42NHReb660allc/DKyjlFtE+RIpdm0Jis/H7HAUgmk4dorArU+L8fcyY0bxAJIgUzqItULrcyLPw==","signatures":[{"sig":"MEQCIGIvmURn11wJbRf5dzC6Uj85DyFC6CwfjQypR4pohI09AiACz6I/hMWC5BNkuSv77pPbukmAmF/258vs4YsHMuFjEw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":47046},"jest":{"preset":"ts-jest","testRegex":".*\\.spec\\.ts$","transform":{"^.+\\.(t|j)s$":"ts-jest"},"testTimeout":30000,"testEnvironment":"node","coverageDirectory":"coverage","setupFilesAfterEnv":["<rootDir>/src/test-setup.ts"],"collectCoverageFrom":["src/**/*.(t|j)s"],"moduleFileExtensions":["js","json","ts"]},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"e95f3fd5d275ba0705889e96499d8d7758bc83ea","scripts":{"test":"jest","build":"yarn clean && tsc","clean":"rm -rf ./dist && find . -type f \\( -name \"*.js\" -o -name \"*.js.map\" -o -name \"*.d.ts\" \\) ! -path \"*/node_modules/*\" -delete","prepublishOnly":"yarn build","test:integration":"jest --testNamePattern='Integration'"},"_npmUser":{"name":"batflarrow","email":"dwivedia2001@gmail.com"},"_npmVersion":"10.8.0","description":"A comprehensive integration with BambooHR's API for employee management and time off operations.","directories":{},"_nodeVersion":"20.12.0","dependencies":{"axios":"^1.12.2","@clearfeed-ai/quix-common-agent":"2.1.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","dotenv":"^16.4.5","ts-jest":"^29.2.5","typescript":"^5.7.3","@types/jest":"^29.5.14","@types/node":"^22.10.7"},"peerDependencies":{"@langchain/core":"1.1.8"},"_npmOperationalInternal":{"tmp":"tmp/quix-bamboohr-agent_2.1.0_1768391328166_0.005811386567882604","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"name":"@clearfeed-ai/quix-bamboohr-agent","version":"2.2.0","license":"Apache-2.0","_id":"@clearfeed-ai/quix-bamboohr-agent@2.2.0","maintainers":[{"name":"batflarrow","email":"dwivedia2001@gmail.com"},{"name":"lalitindoria","email":"l.k.indoria@gmail.com"},{"name":"sharath_clrfd","email":"sharath@clearfeed.ai"}],"dist":{"shasum":"be2cdf0e83b11cb1f3e3795ae76512c4bf0dfc15","tarball":"https://registry.npmjs.org/@clearfeed-ai/quix-bamboohr-agent/-/quix-bamboohr-agent-2.2.0.tgz","fileCount":23,"integrity":"sha512-oHyZujpd3wmO6o4XP7+2wS5cIjGk6xr5oU9mTTa1YDhK2gBv2qqwvZz5eqqZbCR5enofytqOoOCtZ6JjiMLYzg==","signatures":[{"sig":"MEQCIEhhojDc/rS+7wx13a4yfICD11KmoFmPxK3qYsZS7us3AiAIkroHJZ/T6Oc5/E3zBvFp3XG76geU9MY6tA33WPTmzQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52009},"jest":{"preset":"ts-jest","testRegex":".*\\.spec\\.ts$","transform":{"^.+\\.(t|j)s$":"ts-jest"},"testTimeout":30000,"testEnvironment":"node","coverageDirectory":"coverage","setupFilesAfterEnv":["<rootDir>/src/test-setup.ts"],"collectCoverageFrom":["src/**/*.(t|j)s"],"moduleFileExtensions":["js","json","ts"]},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"12e7f6ceca8696ec23bc121080516df8b40f27ae","scripts":{"test":"jest","build":"yarn clean && tsc","clean":"tsc --build --clean","watch":"tsc --watch","prepublishOnly":"yarn build","test:integration":"jest --testNamePattern='Integration'"},"_npmUser":{"name":"batflarrow","email":"dwivedia2001@gmail.com"},"_npmVersion":"10.8.0","description":"A comprehensive integration with BambooHR's API for employee management and time off operations.","directories":{},"_nodeVersion":"20.12.0","dependencies":{"axios":"^1.12.2","@clearfeed-ai/quix-common-agent":"2.1.1"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","dotenv":"^16.4.5","ts-jest":"^29.2.5","typescript":"^5.7.3","@types/jest":"^29.5.14","@types/node":"^22.10.7"},"peerDependencies":{"@langchain/core":"1.1.8"},"_npmOperationalInternal":{"tmp":"tmp/quix-bamboohr-agent_2.2.0_1769761187639_0.1764275761821592","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-07-20T17:01:38.407Z","modified":"2026-05-16T10:14:36.290Z","1.0.0":"2025-07-20T17:01:38.707Z","1.0.1":"2025-09-15T06:34:30.282Z","2.0.0":"2025-12-29T10:59:49.457Z","2.1.0":"2026-01-14T11:48:48.297Z","2.2.0":"2026-01-30T08:19:47.763Z"},"license":"Apache-2.0","description":"A comprehensive integration with BambooHR's API for employee management and time off operations.","maintainers":[{"email":"l.k.indoria@gmail.com","name":"lalitindoria"}],"readme":"# BambooHR Integration\n\nA comprehensive integration with BambooHR's API for employee management and time off operations.\n\n## Implemented Tools\n\n### Employee Management\n\n#### `list_bamboohr_employees`\n\nLists all employees in BambooHR with their basic information including names, job titles, departments, managers, and contact details.\n\n**Parameters:** None\n\n**Returns:** Employee directory with fields definition and employee list\n\n#### `get_bamboohr_employee`\n\nGets detailed information for a specific employee by their ID, including job title, manager, department, and contact information.\n\n**Parameters:**\n\n- `employeeId` (number): The employee ID to get details for\n\n**Returns:** Employee details object\n\n### Time Off Management\n\n#### `get_bamboohr_employee_time_off_balance`\n\nGets time off balances for a specific employee, showing available vacation days, sick days, and other leave types with used amounts.\n\n**Parameters:**\n\n- `employeeId` (string): The employee ID to get time off balance for\n- `endDate` (string, optional): End date for balance calculation (YYYY-MM-DD format, defaults to current year end)\n\n**Returns:** Array of time off balances by type\n\n#### `get_bamboohr_time_off_requests_for_employee`\n\nRetrieves time off requests with optional filters for date range, and status. Shows request details, dates, amounts, and approval status.\n\n**Parameters:**\n\n- `employeeId` (number, optional): Filter by specific employee ID\n- `startDate` (string, optional): Start date filter (YYYY-MM-DD format, defaults to current year start)\n- `endDate` (string, optional): End date filter (YYYY-MM-DD format, defaults to current year end)\n- `status` (string, optional): Filter by request status ('approved', 'denied', 'superceded', 'requested', 'canceled')\n\n**Returns:** Array of time off requests\n\n#### `create_bamboohr_time_off_request`\n\nCreates a new time off request for an employee. Requires employee ID, time off type, dates, and amount.\n\n**Parameters:**\n\n- `employeeId` (number): The employee ID requesting time off\n- `timeOffTypeId` (string): The time off type ID (e.g., \"78\" for Vacation, \"79\" for Sick)\n- `start` (string): Start date in YYYY-MM-DD format\n- `end` (string): End date in YYYY-MM-DD format\n- `amount` (string): Amount of time off in hours or days\n- `notes` (string, optional): Optional notes for the request\n\n**Returns:** Success confirmation with request ID\n\n## Testing Instructions\n\n1. Set up environment variables:\n\n   ```bash\n   export BAMBOOHR_API_KEY=\"your_api_key_here\"\n   export BAMBOOHR_SUBDOMAIN=\"your_subdomain\"\n   ```\n\n2. Install dependencies:\n\n   ```bash\n   yarn install\n   ```\n\n3. Build the package:\n\n   ```bash\n   yarn build\n   ```\n\n4. Run integration tests:\n   ```bash\n   yarn test:integration\n   ```\n\n## Configuration\n\nThe integration requires a configuration object with the following properties:\n\n```typescript\ninterface BambooHRConfig {\n  apiKey: string; // BambooHR API key\n  subdomain: string; // BambooHR company subdomain\n  enabled?: boolean; // Whether the integration is enabled (inherited from BaseConfig)\n}\n```\n\n## Usage Example\n\n```typescript\nimport { createBambooHRToolsExport } from '@clearfeed-ai/quix-bamboohr-agent';\n\nconst config = {\n  apiKey: process.env.BAMBOOHR_API_KEY!,\n  subdomain: 'your-company-subdomain'\n};\n\nconst toolsConfig = createBambooHRToolsExport(config);\n```\n\n## API Authentication\n\nBambooHR uses API key authentication with HTTP Basic Auth where:\n\n- Username: Your API key\n- Password: \"x\" (literal string)\n\nThe integration handles this automatically using the provided API key.\n\n## Common Time Off Type IDs\n\n- `78`: Vacation\n- `79`: Sick\n- `77`: Bereavement\n- `82`: COVID-19 Related Absence\n- `81`: Comp/In Lieu Time\n- `80`: FMLA\n\n## Future Considerations\n\n- **Employee Creation/Updates**: Add tools for creating and updating employee records\n- **Performance Management**: Integrate with BambooHR's performance review system\n- **Reports**: Add support for generating custom reports\n- **Benefits Administration**: Include benefits enrollment and management tools\n- **Custom Fields**: Support for company-specific custom fields\n- **Webhooks**: Real-time notifications for employee and time off changes\n- **Bulk Operations**: Support for bulk employee imports/updates\n- **Document Management**: Employee document upload and retrieval\n","readmeFilename":"README.md"}