@hazeljs/ops-agent 0.2.0-beta.22

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 HazelJS Team
+
+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,88 @@
+# @hazeljs/ops-agent
+
+**Ops Agent** — AI-powered DevOps assistant for Jira, Slack, and incident coordination.
+
+## Overview
+
+When you need an AI assistant that can create Jira tickets, post to Slack, and coordinate incidents, use this package. It provides:
+
+- **OpsAgent** – `@Agent` with tools for Jira (create, comment, get) and Slack (post)
+- **createOpsRuntime** – wires AI + Agent + tools together
+- **Adapters** – `createJiraTool`, `createSlackTool` for Jira Cloud and Slack Web API
+
+## Installation
+
+```bash
+npm install @hazeljs/ops-agent @hazeljs/ai @hazeljs/agent @hazeljs/rag
+```
+
+## Quick Start
+
+```ts
+import { AIEnhancedService } from '@hazeljs/ai';
+import {
+  createOpsRuntime,
+  runOpsAgent,
+  createJiraTool,
+  createSlackTool,
+} from '@hazeljs/ops-agent';
+
+// Configure tools (uses env vars when omitted)
+const jiraTool = createJiraTool(); // JIRA_HOST, JIRA_EMAIL, JIRA_API_TOKEN
+const slackTool = createSlackTool(); // SLACK_BOT_TOKEN
+
+const runtime = createOpsRuntime({
+  aiService: new AIEnhancedService(),
+  tools: {
+    jira: jiraTool,
+    slack: slackTool,
+  },
+  model: 'gpt-4',
+});
+
+const result = await runOpsAgent(runtime, {
+  input: 'Create a Jira ticket in PROJ for "Payment API timeout in prod" and post a summary to #incidents',
+  sessionId: 'incident-2024-01',
+});
+
+console.log(result.response);
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `JIRA_HOST` | Jira host (e.g. https://your-domain.atlassian.net) |
+| `JIRA_EMAIL` | Email for Basic auth |
+| `JIRA_API_TOKEN` | API token from [Atlassian](https://id.atlassian.com/manage-profile/security/api-tokens) |
+| `SLACK_BOT_TOKEN` | Slack bot token (xoxb-...) from app OAuth |
+
+When not configured, tools return placeholder responses so you can develop without credentials.
+
+## Tools
+
+| Tool | Description | Approval |
+|------|-------------|----------|
+| `create_jira_ticket` | Create Jira issue (project, summary, description, type) | Yes |
+| `add_jira_comment` | Add comment to existing issue | No |
+| `get_jira_ticket` | Get issue details by key | No |
+| `post_to_slack` | Post message to channel (optionally in thread) | Yes |
+
+## Memory
+
+The ops agent has memory enabled by default (in-memory `BufferMemory`). Use the same `sessionId` for follow-up requests in the same incident.
+
+## Human-in-the-Loop
+
+`create_jira_ticket` and `post_to_slack` use `requiresApproval: true`. Subscribe to `tool.approval.requested` and approve/reject before the action runs:
+
+```ts
+runtime.on('tool.approval.requested', (event) => {
+  // Approve: runtime.approveToolExecution(event.data.requestId, userId);
+  // Reject: runtime.rejectToolExecution(event.data.requestId);
+});
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@hazeljs/ops-agent",
+  "version": "0.2.0-beta.22",
+  "description": "Ops agent for Jira, Slack, and DevOps workflows - AI-powered incident triage and team coordination",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "test": "jest --coverage --passWithNoTests",
+    "test:watch": "jest --watch"
+  },
+  "keywords": [
+    "hazeljs",
+    "ops",
+    "agent",
+    "jira",
+    "slack",
+    "devops",
+    "incident",
+    "sre"
+  ],
+  "author": "Muhammad Arslan <marslan@hazeljs.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/hazeljs/hazel-js/issues"
+  },
+  "homepage": "https://hazeljs.com",
+  "dependencies": {
+    "reflect-metadata": "^0.2.1"
+  },
+  "peerDependencies": {
+    "@hazeljs/agent": ">=0.2.0-beta.0",
+    "@hazeljs/ai": ">=0.2.0-beta.0",
+    "@hazeljs/core": ">=0.2.0-beta.0",
+    "@hazeljs/rag": ">=0.1.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.17.50",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hazel-js/hazeljs.git",
+    "directory": "packages/ops-agent"
+  },
+  "gitHead": "51d9d1ebfa8f259b4b50e618d64bde24d586bc2a"
+}