create-ironclaws 1.0.3 → 1.1.0

package/template/container/tools/jira_tool.py

@@ -1,433 +0,0 @@
-"""
-Jira tool for Argus agents.
-
-Usage:
-  # Get next ticket to work on (highest priority, oldest first)
-  python3 jira_tool.py next
-
-  # Get specific ticket
-  python3 jira_tool.py get --issue IAI-42
-
-  # Search tickets
-  python3 jira_tool.py search --status "To Do"
-  python3 jira_tool.py search --status "In Progress" --assignee "user@example.com"
-
-  # Create a ticket
-  python3 jira_tool.py create --summary "Bug in BobAIA" --description "..." --type Bug
-  python3 jira_tool.py create --summary "Fix login" --type Bug --epic IAI-10
-
-  # Create an epic
-  python3 jira_tool.py create-epic --summary "Salesforce Integration" --description "..."
-  python3 jira_tool.py create-epic --summary "Salesforce Integration" --start-date 2026-04-15 --due-date 2026-06-30
-
-  # Search epics
-  python3 jira_tool.py search-epics
-  python3 jira_tool.py search-epics --query "Salesforce"
-
-  # Update a ticket
-  python3 jira_tool.py update --issue IAI-42 --status "In Progress"
-  python3 jira_tool.py update --issue IAI-42 --description "Updated description"
-  python3 jira_tool.py update --issue IAI-42 --comment "Working on this now"
-  python3 jira_tool.py update --issue IAI-42 --assignee-email "user@yourcompany.com"
-
-  # Find Jira account ID by email
-  python3 jira_tool.py user --email "user@yourcompany.com"
-
-Environment variables (required):
-  JIRA_BASE_URL      e.g. https://yourcompany.atlassian.net
-  JIRA_EMAIL         Atlassian account email
-  JIRA_API_TOKEN     Atlassian API token
-  JIRA_PROJECT_KEY   e.g. IAI
-"""
-
-import argparse
-import json
-import os
-import sys
-
-try:
-    import requests
-    from requests.auth import HTTPBasicAuth
-except ImportError:
-    print("ERROR: 'requests' is not installed. Run: pip3 install requests", file=sys.stderr)
-    sys.exit(1)
-
-
-PRIORITY_ORDER = {"Critical": 0, "High": 1, "Medium": 2, "Low": 3, "Lowest": 4}
-
-
-def get_client():
-    base_url = os.environ.get("JIRA_BASE_URL", "").rstrip("/")
-    project = os.environ.get("JIRA_PROJECT_KEY", "")
-
-    if not base_url or not project:
-        print(
-            "ERROR: JIRA_BASE_URL and JIRA_PROJECT_KEY must be set.",
-            file=sys.stderr,
-        )
-        sys.exit(1)
-
-    email = os.environ.get("JIRA_EMAIL", "")
-    token = os.environ.get("JIRA_API_TOKEN", "")
-    # auth is optional — if absent, OneCLI HTTPS proxy injects Authorization header.
-    auth = HTTPBasicAuth(email, token) if email and token else None
-    return base_url, auth, project
-
-
-def jira_get(base_url, auth, path, params=None):
-    resp = requests.get(
-        f"{base_url}/rest/api/3{path}",
-        auth=auth,
-        headers={"Accept": "application/json"},
-        params=params,
-        timeout=30,
-    )
-    resp.raise_for_status()
-    return resp.json()
-
-
-def jira_search(base_url, auth, jql, max_results=50, fields=None):
-    """POST-based search — returns the issues list directly."""
-    if fields is None:
-        fields = ["summary", "status", "priority", "issuetype",
-                  "assignee", "reporter", "description", "created"]
-    body = {"jql": jql, "maxResults": max_results, "fields": fields}
-    resp = requests.post(
-        f"{base_url}/rest/api/3/search/jql",
-        auth=auth,
-        headers={"Accept": "application/json", "Content-Type": "application/json"},
-        json=body,
-        timeout=30,
-    )
-    resp.raise_for_status()
-    return resp.json().get("issues", [])
-
-
-def jira_post(base_url, auth, path, body):
-    resp = requests.post(
-        f"{base_url}/rest/api/3{path}",
-        auth=auth,
-        headers={"Accept": "application/json", "Content-Type": "application/json"},
-        json=body,
-        timeout=30,
-    )
-    resp.raise_for_status()
-    return resp.json()
-
-
-def jira_put(base_url, auth, path, body):
-    resp = requests.put(
-        f"{base_url}/rest/api/3{path}",
-        auth=auth,
-        headers={"Accept": "application/json", "Content-Type": "application/json"},
-        json=body,
-        timeout=30,
-    )
-    resp.raise_for_status()
-    return resp
-
-
-def jira_transition(base_url, auth, issue_key, status_name):
-    """Move an issue to a new status by name."""
-    transitions = jira_get(base_url, auth, f"/issue/{issue_key}/transitions")
-    match = next(
-        (t for t in transitions["transitions"] if t["name"].lower() == status_name.lower()),
-        None,
-    )
-    if not match:
-        available = [t["name"] for t in transitions["transitions"]]
-        print(
-            f"ERROR: Status '{status_name}' not found. Available: {available}",
-            file=sys.stderr,
-        )
-        sys.exit(1)
-    jira_post(base_url, auth, f"/issue/{issue_key}/transitions", {"transition": {"id": match["id"]}})
-
-
-def format_issue(issue):
-    fields = issue.get("fields", {})
-    priority = (fields.get("priority") or {}).get("name", "None")
-    status = (fields.get("status") or {}).get("name", "?")
-    assignee = (fields.get("assignee") or {}).get("emailAddress", "unassigned")
-    reporter = (fields.get("reporter") or {}).get("emailAddress", "?")
-    issue_type = (fields.get("issuetype") or {}).get("name", "?")
-    summary = fields.get("summary", "?")
-    key = issue.get("key", "?")
-
-    # Extract plain text from description (Atlassian Document Format)
-    desc_raw = fields.get("description") or {}
-    description = extract_adf_text(desc_raw)
-
-    return {
-        "key": key,
-        "type": issue_type,
-        "status": status,
-        "priority": priority,
-        "summary": summary,
-        "description": description,
-        "reporter": reporter,
-        "assignee": assignee,
-        "url": f"{os.environ.get('JIRA_BASE_URL', '').rstrip('/')}/browse/{key}",
-    }
-
-
-def extract_adf_text(node):
-    """Extract plain text from Atlassian Document Format (ADF) JSON."""
-    if not node:
-        return ""
-    if isinstance(node, str):
-        return node
-    if node.get("type") == "text":
-        return node.get("text", "")
-    parts = []
-    for child in node.get("content", []):
-        parts.append(extract_adf_text(child))
-    return " ".join(p for p in parts if p).strip()
-
-
-def cmd_get(args):
-    base_url, auth, _ = get_client()
-    issue = jira_get(base_url, auth, f"/issue/{args.issue}")
-    print(json.dumps(format_issue(issue), indent=2))
-
-
-def cmd_next(args):
-    base_url, auth, project = get_client()
-    jql = f'project = {project} AND status = "To Do" ORDER BY priority ASC, created ASC'
-    issues = jira_search(base_url, auth, jql, max_results=10)
-    if not issues:
-        print("No tickets in To Do.")
-        return
-    def sort_key(i):
-        p = (i.get("fields", {}).get("priority") or {}).get("name", "Low")
-        return (PRIORITY_ORDER.get(p, 99), i.get("fields", {}).get("created", ""))
-    issues.sort(key=sort_key)
-    print(json.dumps(format_issue(issues[0]), indent=2))
-
-
-def cmd_search(args):
-    base_url, auth, project = get_client()
-    conditions = [f"project = {project}"]
-    if args.status:
-        conditions.append(f'status = "{args.status}"')
-    if args.assignee:
-        conditions.append(f'assignee = "{args.assignee}"')
-    jql = " AND ".join(conditions) + " ORDER BY priority ASC, created ASC"
-    issues = jira_search(base_url, auth, jql)
-    print(json.dumps([format_issue(i) for i in issues], indent=2))
-
-
-def cmd_create(args):
-    base_url, auth, project = get_client()
-
-    # Build description in ADF format
-    description_adf = {
-        "type": "doc",
-        "version": 1,
-        "content": [
-            {
-                "type": "paragraph",
-                "content": [{"type": "text", "text": args.description or ""}],
-            }
-        ],
-    }
-
-    body = {
-        "fields": {
-            "project": {"key": project},
-            "summary": args.summary,
-            "description": description_adf,
-            "issuetype": {"name": args.type or "Task"},
-        }
-    }
-
-    # Set reporter by account ID if provided
-    if args.reporter_account_id:
-        body["fields"]["reporter"] = {"id": args.reporter_account_id}
-
-    # Link to parent epic if provided
-    if args.epic:
-        body["fields"]["parent"] = {"key": args.epic}
-
-    result = jira_post(base_url, auth, "/issue", body)
-    key = result.get("key")
-    url = f"{base_url}/browse/{key}"
-    print(json.dumps({"key": key, "url": url, "epic": args.epic or None}))
-
-
-def cmd_create_epic(args):
-    base_url, auth, project = get_client()
-
-    description_adf = {
-        "type": "doc",
-        "version": 1,
-        "content": [
-            {
-                "type": "paragraph",
-                "content": [{"type": "text", "text": args.description or ""}],
-            }
-        ],
-    }
-
-    body = {
-        "fields": {
-            "project": {"key": project},
-            "summary": args.summary,
-            "description": description_adf,
-            "issuetype": {"name": "Epic"},
-        }
-    }
-
-    if args.reporter_account_id:
-        body["fields"]["reporter"] = {"id": args.reporter_account_id}
-
-    if args.start_date:
-        # customfield_10015 is the standard Epic start date in Jira Cloud
-        body["fields"]["customfield_10015"] = args.start_date
-
-    if args.due_date:
-        body["fields"]["duedate"] = args.due_date
-
-    result = jira_post(base_url, auth, "/issue", body)
-    key = result.get("key")
-    url = f"{base_url}/browse/{key}"
-    print(json.dumps({"key": key, "url": url, "type": "Epic"}))
-
-
-def cmd_search_epics(args):
-    base_url, auth, project = get_client()
-    conditions = [f"project = {project}", "issuetype = Epic"]
-    if args.query:
-        # Escape quotes in query for JQL
-        safe_query = args.query.replace('"', '\\"')
-        conditions.append(f'summary ~ "{safe_query}"')
-    jql = " AND ".join(conditions) + " ORDER BY created DESC"
-    issues = jira_search(base_url, auth, jql)
-    print(json.dumps([format_issue(i) for i in issues], indent=2))
-
-
-def cmd_update(args):
-    base_url, auth, _ = get_client()
-
-    if args.status:
-        jira_transition(base_url, auth, args.issue, args.status)
-        print(f"Moved {args.issue} to '{args.status}'")
-
-    if args.description:
-        description_adf = {
-            "type": "doc",
-            "version": 1,
-            "content": [
-                {
-                    "type": "paragraph",
-                    "content": [{"type": "text", "text": args.description}],
-                }
-            ],
-        }
-        jira_put(base_url, auth, f"/issue/{args.issue}", {"fields": {"description": description_adf}})
-        print(f"Updated description on {args.issue}")
-
-    if args.comment:
-        comment_adf = {
-            "type": "doc",
-            "version": 1,
-            "content": [
-                {
-                    "type": "paragraph",
-                    "content": [{"type": "text", "text": args.comment}],
-                }
-            ],
-        }
-        jira_post(base_url, auth, f"/issue/{args.issue}/comment", {"body": comment_adf})
-        print(f"Added comment to {args.issue}")
-
-    if args.assignee_email:
-        result = jira_get(base_url, auth, "/user/search", params={"query": args.assignee_email})
-        matches = [u for u in result if u.get("emailAddress", "").lower() == args.assignee_email.lower()]
-        if not matches:
-            print(f"ERROR: No Jira user found for email '{args.assignee_email}'", file=sys.stderr)
-            sys.exit(1)
-        account_id = matches[0]["accountId"]
-        jira_put(base_url, auth, f"/issue/{args.issue}", {"fields": {"assignee": {"id": account_id}}})
-        print(f"Assigned {args.issue} to {args.assignee_email}")
-
-
-def cmd_user(args):
-    """Find Jira account ID by email — used to set reporter/assignee."""
-    base_url, auth, _ = get_client()
-    result = jira_get(base_url, auth, "/user/search", params={"query": args.email})
-    matches = [u for u in result if u.get("emailAddress", "").lower() == args.email.lower()]
-    if not matches:
-        print(f"ERROR: No Jira user found for email '{args.email}'", file=sys.stderr)
-        sys.exit(1)
-    user = matches[0]
-    print(json.dumps({
-        "account_id": user.get("accountId"),
-        "display_name": user.get("displayName"),
-        "email": user.get("emailAddress"),
-    }))
-
-
-def parse_args():
-    p = argparse.ArgumentParser(description="Jira tool for Argus agents")
-    sub = p.add_subparsers(dest="command")
-
-    sub.add_parser("next", help="Get next To Do ticket by priority")
-
-    g = sub.add_parser("get", help="Get a specific ticket")
-    g.add_argument("--issue", required=True)
-
-    s = sub.add_parser("search", help="Search tickets")
-    s.add_argument("--status")
-    s.add_argument("--assignee")
-
-    c = sub.add_parser("create", help="Create a ticket")
-    c.add_argument("--summary", required=True)
-    c.add_argument("--description", default="")
-    c.add_argument("--type", default="Task", help="Bug, Task, Story, etc.")
-    c.add_argument("--reporter-account-id", dest="reporter_account_id", default=None)
-    c.add_argument("--epic", default=None, help="Parent epic key (e.g. IAI-10) to link this ticket under")
-
-    ce = sub.add_parser("create-epic", help="Create an epic")
-    ce.add_argument("--summary", required=True)
-    ce.add_argument("--description", default="")
-    ce.add_argument("--reporter-account-id", dest="reporter_account_id", default=None)
-    ce.add_argument("--start-date", dest="start_date", default=None, help="Start date (YYYY-MM-DD)")
-    ce.add_argument("--due-date", dest="due_date", default=None, help="Due date (YYYY-MM-DD)")
-
-    se = sub.add_parser("search-epics", help="Search epics in the project")
-    se.add_argument("--query", default=None, help="Search term to filter epic summaries")
-
-    u = sub.add_parser("update", help="Update a ticket")
-    u.add_argument("--issue", required=True)
-    u.add_argument("--status", help="Transition to this status")
-    u.add_argument("--description", help="Update description")
-    u.add_argument("--comment", help="Add a comment")
-    u.add_argument("--assignee-email", dest="assignee_email", help="Assign to this email address")
-
-    usr = sub.add_parser("user", help="Find Jira account ID by email")
-    usr.add_argument("--email", required=True)
-
-    return p.parse_args()
-
-
-def main():
-    args = parse_args()
-    if not args.command:
-        print("ERROR: specify a command. Use --help for usage.", file=sys.stderr)
-        sys.exit(1)
-    try:
-        {"next": cmd_next, "get": cmd_get, "search": cmd_search,
-         "create": cmd_create, "create-epic": cmd_create_epic,
-         "search-epics": cmd_search_epics,
-         "update": cmd_update, "user": cmd_user}[args.command](args)
-    except requests.HTTPError as e:
-        print(f"ERROR: Jira API error: {e}\n{e.response.text}", file=sys.stderr)
-        sys.exit(1)
-    except Exception as e:
-        print(f"ERROR: {e}", file=sys.stderr)
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

package/template/container/tools/slack_history_tool.py

@@ -1,144 +0,0 @@
-#!/usr/bin/env python3
-"""
-Slack channel history tool for Byte agent.
-
-Usage:
-  # Fetch last 180 days of messages
-  python3 slack_history_tool.py history --channel C05DV1DU58R --days 180
-
-  # Fetch messages since a specific date
-  python3 slack_history_tool.py history --channel C05DV1DU58R --since 2026-01-01
-
-  # Fetch messages since a Unix timestamp (for incremental reads)
-  python3 slack_history_tool.py history --channel C05DV1DU58R --oldest 1700000000
-
-Environment variables (required):
-  SLACK_BOT_TOKEN    Bot token with channels:history or groups:history scope
-"""
-
-import argparse
-import json
-import os
-import sys
-from datetime import datetime, timedelta
-import urllib.request
-import urllib.parse
-
-SLACK_BOT_TOKEN = os.environ.get('SLACK_BOT_TOKEN', '')
-
-_user_cache: dict = {}
-
-
-def slack_api(method: str, params: dict) -> dict:
-    url = f'https://slack.com/api/{method}'
-    data = urllib.parse.urlencode(params).encode()
-    req = urllib.request.Request(url, data=data, method='POST')
-    # Authorization is optional — if token absent, OneCLI HTTPS proxy injects it.
-    if SLACK_BOT_TOKEN:
-        req.add_header('Authorization', f'Bearer {SLACK_BOT_TOKEN}')
-    req.add_header('Content-Type', 'application/x-www-form-urlencoded')
-    with urllib.request.urlopen(req, timeout=30) as response:
-        return json.loads(response.read())
-
-
-def resolve_user(user_id: str) -> str:
-    if not user_id:
-        return 'Unknown'
-    if user_id in _user_cache:
-        return _user_cache[user_id]
-    try:
-        result = slack_api('users.info', {'user': user_id})
-        name = (
-            result.get('user', {}).get('real_name')
-            or result.get('user', {}).get('name')
-            or user_id
-        )
-        _user_cache[user_id] = name
-        return name
-    except Exception:
-        _user_cache[user_id] = user_id
-        return user_id
-
-
-def fetch_history(channel: str, oldest: str) -> list:
-    messages = []
-    cursor = None
-
-    while True:
-        params: dict = {
-            'channel': channel,
-            'limit': 200,
-            'oldest': oldest,
-        }
-        if cursor:
-            params['cursor'] = cursor
-
-        result = slack_api('conversations.history', params)
-
-        if not result.get('ok'):
-            print(f"Error: {result.get('error', 'unknown')}", file=sys.stderr)
-            break
-
-        messages.extend(result.get('messages', []))
-
-        if not result.get('has_more'):
-            break
-
-        cursor = result.get('response_metadata', {}).get('next_cursor')
-        if not cursor:
-            break
-
-    return messages
-
-
-def format_messages(messages: list) -> str:
-    lines = []
-    # API returns newest first — reverse for chronological order
-    for msg in reversed(messages):
-        # Skip system messages (joins, topic changes, etc.)
-        if msg.get('subtype'):
-            continue
-        text = msg.get('text', '').strip()
-        if not text:
-            continue
-
-        ts = float(msg.get('ts', 0))
-        dt = datetime.fromtimestamp(ts).strftime('%Y-%m-%d %H:%M')
-        user_name = resolve_user(msg.get('user', ''))
-
-        lines.append(f'[{dt}] {user_name}: {text}')
-
-    return '\n'.join(lines)
-
-
-def main():
-    # SLACK_BOT_TOKEN is optional — if absent, OneCLI HTTPS proxy injects Authorization.
-    parser = argparse.ArgumentParser(description='Fetch Slack channel history')
-    subparsers = parser.add_subparsers(dest='command')
-
-    history_parser = subparsers.add_parser('history', help='Fetch channel message history')
-    history_parser.add_argument('--channel', required=True, help='Slack channel ID')
-    history_parser.add_argument('--days', type=int, default=180, help='Number of days back (default: 180)')
-    history_parser.add_argument('--since', help='Fetch since this date (ISO format: 2026-01-01)')
-    history_parser.add_argument('--oldest', help='Fetch since this Unix timestamp')
-
-    args = parser.parse_args()
-
-    if args.command == 'history':
-        if args.oldest:
-            oldest = args.oldest
-        elif args.since:
-            dt = datetime.fromisoformat(args.since)
-            oldest = str(dt.timestamp())
-        else:
-            dt = datetime.now() - timedelta(days=args.days)
-            oldest = str(dt.timestamp())
-
-        messages = fetch_history(args.channel, oldest=oldest)
-        print(format_messages(messages))
-    else:
-        parser.print_help()
-
-
-if __name__ == '__main__':
-    main()