@xagent-ai/cli 1.2.2 → 1.3.0

package/skills/skills/slack-gif-creator/core/frame_composer.py

@@ -1,176 +0,0 @@
-#!/usr/bin/env python3
-"""
-Frame Composer - Utilities for composing visual elements into frames.
-
-Provides functions for drawing shapes, text, emojis, and compositing elements
-together to create animation frames.
-"""
-
-from typing import Optional
-
-import numpy as np
-from PIL import Image, ImageDraw, ImageFont
-
-
-def create_blank_frame(
-    width: int, height: int, color: tuple[int, int, int] = (255, 255, 255)
-) -> Image.Image:
-    """
-    Create a blank frame with solid color background.
-
-    Args:
-        width: Frame width
-        height: Frame height
-        color: RGB color tuple (default: white)
-
-    Returns:
-        PIL Image
-    """
-    return Image.new("RGB", (width, height), color)
-
-
-def draw_circle(
-    frame: Image.Image,
-    center: tuple[int, int],
-    radius: int,
-    fill_color: Optional[tuple[int, int, int]] = None,
-    outline_color: Optional[tuple[int, int, int]] = None,
-    outline_width: int = 1,
-) -> Image.Image:
-    """
-    Draw a circle on a frame.
-
-    Args:
-        frame: PIL Image to draw on
-        center: (x, y) center position
-        radius: Circle radius
-        fill_color: RGB fill color (None for no fill)
-        outline_color: RGB outline color (None for no outline)
-        outline_width: Outline width in pixels
-
-    Returns:
-        Modified frame
-    """
-    draw = ImageDraw.Draw(frame)
-    x, y = center
-    bbox = [x - radius, y - radius, x + radius, y + radius]
-    draw.ellipse(bbox, fill=fill_color, outline=outline_color, width=outline_width)
-    return frame
-
-
-def draw_text(
-    frame: Image.Image,
-    text: str,
-    position: tuple[int, int],
-    color: tuple[int, int, int] = (0, 0, 0),
-    centered: bool = False,
-) -> Image.Image:
-    """
-    Draw text on a frame.
-
-    Args:
-        frame: PIL Image to draw on
-        text: Text to draw
-        position: (x, y) position (top-left unless centered=True)
-        color: RGB text color
-        centered: If True, center text at position
-
-    Returns:
-        Modified frame
-    """
-    draw = ImageDraw.Draw(frame)
-
-    # Uses Pillow's default font.
-    # If the font should be changed for the emoji, add additional logic here.
-    font = ImageFont.load_default()
-
-    if centered:
-        bbox = draw.textbbox((0, 0), text, font=font)
-        text_width = bbox[2] - bbox[0]
-        text_height = bbox[3] - bbox[1]
-        x = position[0] - text_width // 2
-        y = position[1] - text_height // 2
-        position = (x, y)
-
-    draw.text(position, text, fill=color, font=font)
-    return frame
-
-
-def create_gradient_background(
-    width: int,
-    height: int,
-    top_color: tuple[int, int, int],
-    bottom_color: tuple[int, int, int],
-) -> Image.Image:
-    """
-    Create a vertical gradient background.
-
-    Args:
-        width: Frame width
-        height: Frame height
-        top_color: RGB color at top
-        bottom_color: RGB color at bottom
-
-    Returns:
-        PIL Image with gradient
-    """
-    frame = Image.new("RGB", (width, height))
-    draw = ImageDraw.Draw(frame)
-
-    # Calculate color step for each row
-    r1, g1, b1 = top_color
-    r2, g2, b2 = bottom_color
-
-    for y in range(height):
-        # Interpolate color
-        ratio = y / height
-        r = int(r1 * (1 - ratio) + r2 * ratio)
-        g = int(g1 * (1 - ratio) + g2 * ratio)
-        b = int(b1 * (1 - ratio) + b2 * ratio)
-
-        # Draw horizontal line
-        draw.line([(0, y), (width, y)], fill=(r, g, b))
-
-    return frame
-
-
-def draw_star(
-    frame: Image.Image,
-    center: tuple[int, int],
-    size: int,
-    fill_color: tuple[int, int, int],
-    outline_color: Optional[tuple[int, int, int]] = None,
-    outline_width: int = 1,
-) -> Image.Image:
-    """
-    Draw a 5-pointed star.
-
-    Args:
-        frame: PIL Image to draw on
-        center: (x, y) center position
-        size: Star size (outer radius)
-        fill_color: RGB fill color
-        outline_color: RGB outline color (None for no outline)
-        outline_width: Outline width
-
-    Returns:
-        Modified frame
-    """
-    import math
-
-    draw = ImageDraw.Draw(frame)
-    x, y = center
-
-    # Calculate star points
-    points = []
-    for i in range(10):
-        angle = (i * 36 - 90) * math.pi / 180  # 36 degrees per point, start at top
-        radius = size if i % 2 == 0 else size * 0.4  # Alternate between outer and inner
-        px = x + radius * math.cos(angle)
-        py = y + radius * math.sin(angle)
-        points.append((px, py))
-
-    # Draw star
-    draw.polygon(points, fill=fill_color, outline=outline_color, width=outline_width)
-
-    return frame

package/skills/skills/slack-gif-creator/core/gif_builder.py

@@ -1,269 +0,0 @@
-#!/usr/bin/env python3
-"""
-GIF Builder - Core module for assembling frames into GIFs optimized for Slack.
-
-This module provides the main interface for creating GIFs from programmatically
-generated frames, with automatic optimization for Slack's requirements.
-"""
-
-from pathlib import Path
-from typing import Optional
-
-import imageio.v3 as imageio
-import numpy as np
-from PIL import Image
-
-
-class GIFBuilder:
-    """Builder for creating optimized GIFs from frames."""
-
-    def __init__(self, width: int = 480, height: int = 480, fps: int = 15):
-        """
-        Initialize GIF builder.
-
-        Args:
-            width: Frame width in pixels
-            height: Frame height in pixels
-            fps: Frames per second
-        """
-        self.width = width
-        self.height = height
-        self.fps = fps
-        self.frames: list[np.ndarray] = []
-
-    def add_frame(self, frame: np.ndarray | Image.Image):
-        """
-        Add a frame to the GIF.
-
-        Args:
-            frame: Frame as numpy array or PIL Image (will be converted to RGB)
-        """
-        if isinstance(frame, Image.Image):
-            frame = np.array(frame.convert("RGB"))
-
-        # Ensure frame is correct size
-        if frame.shape[:2] != (self.height, self.width):
-            pil_frame = Image.fromarray(frame)
-            pil_frame = pil_frame.resize(
-                (self.width, self.height), Image.Resampling.LANCZOS
-            )
-            frame = np.array(pil_frame)
-
-        self.frames.append(frame)
-
-    def add_frames(self, frames: list[np.ndarray | Image.Image]):
-        """Add multiple frames at once."""
-        for frame in frames:
-            self.add_frame(frame)
-
-    def optimize_colors(
-        self, num_colors: int = 128, use_global_palette: bool = True
-    ) -> list[np.ndarray]:
-        """
-        Reduce colors in all frames using quantization.
-
-        Args:
-            num_colors: Target number of colors (8-256)
-            use_global_palette: Use a single palette for all frames (better compression)
-
-        Returns:
-            List of color-optimized frames
-        """
-        optimized = []
-
-        if use_global_palette and len(self.frames) > 1:
-            # Create a global palette from all frames
-            # Sample frames to build palette
-            sample_size = min(5, len(self.frames))
-            sample_indices = [
-                int(i * len(self.frames) / sample_size) for i in range(sample_size)
-            ]
-            sample_frames = [self.frames[i] for i in sample_indices]
-
-            # Combine sample frames into a single image for palette generation
-            # Flatten each frame to get all pixels, then stack them
-            all_pixels = np.vstack(
-                [f.reshape(-1, 3) for f in sample_frames]
-            )  # (total_pixels, 3)
-
-            # Create a properly-shaped RGB image from the pixel data
-            # We'll make a roughly square image from all the pixels
-            total_pixels = len(all_pixels)
-            width = min(512, int(np.sqrt(total_pixels)))  # Reasonable width, max 512
-            height = (total_pixels + width - 1) // width  # Ceiling division
-
-            # Pad if necessary to fill the rectangle
-            pixels_needed = width * height
-            if pixels_needed > total_pixels:
-                padding = np.zeros((pixels_needed - total_pixels, 3), dtype=np.uint8)
-                all_pixels = np.vstack([all_pixels, padding])
-
-            # Reshape to proper RGB image format (H, W, 3)
-            img_array = (
-                all_pixels[:pixels_needed].reshape(height, width, 3).astype(np.uint8)
-            )
-            combined_img = Image.fromarray(img_array, mode="RGB")
-
-            # Generate global palette
-            global_palette = combined_img.quantize(colors=num_colors, method=2)
-
-            # Apply global palette to all frames
-            for frame in self.frames:
-                pil_frame = Image.fromarray(frame)
-                quantized = pil_frame.quantize(palette=global_palette, dither=1)
-                optimized.append(np.array(quantized.convert("RGB")))
-        else:
-            # Use per-frame quantization
-            for frame in self.frames:
-                pil_frame = Image.fromarray(frame)
-                quantized = pil_frame.quantize(colors=num_colors, method=2, dither=1)
-                optimized.append(np.array(quantized.convert("RGB")))
-
-        return optimized
-
-    def deduplicate_frames(self, threshold: float = 0.9995) -> int:
-        """
-        Remove duplicate or near-duplicate consecutive frames.
-
-        Args:
-            threshold: Similarity threshold (0.0-1.0). Higher = more strict (0.9995 = nearly identical).
-                      Use 0.9995+ to preserve subtle animations, 0.98 for aggressive removal.
-
-        Returns:
-            Number of frames removed
-        """
-        if len(self.frames) < 2:
-            return 0
-
-        deduplicated = [self.frames[0]]
-        removed_count = 0
-
-        for i in range(1, len(self.frames)):
-            # Compare with previous frame
-            prev_frame = np.array(deduplicated[-1], dtype=np.float32)
-            curr_frame = np.array(self.frames[i], dtype=np.float32)
-
-            # Calculate similarity (normalized)
-            diff = np.abs(prev_frame - curr_frame)
-            similarity = 1.0 - (np.mean(diff) / 255.0)
-
-            # Keep frame if sufficiently different
-            # High threshold (0.9995+) means only remove nearly identical frames
-            if similarity < threshold:
-                deduplicated.append(self.frames[i])
-            else:
-                removed_count += 1
-
-        self.frames = deduplicated
-        return removed_count
-
-    def save(
-        self,
-        output_path: str | Path,
-        num_colors: int = 128,
-        optimize_for_emoji: bool = False,
-        remove_duplicates: bool = False,
-    ) -> dict:
-        """
-        Save frames as optimized GIF for Slack.
-
-        Args:
-            output_path: Where to save the GIF
-            num_colors: Number of colors to use (fewer = smaller file)
-            optimize_for_emoji: If True, optimize for emoji size (128x128, fewer colors)
-            remove_duplicates: If True, remove duplicate consecutive frames (opt-in)
-
-        Returns:
-            Dictionary with file info (path, size, dimensions, frame_count)
-        """
-        if not self.frames:
-            raise ValueError("No frames to save. Add frames with add_frame() first.")
-
-        output_path = Path(output_path)
-
-        # Remove duplicate frames to reduce file size
-        if remove_duplicates:
-            removed = self.deduplicate_frames(threshold=0.9995)
-            if removed > 0:
-                print(
-                    f"  Removed {removed} nearly identical frames (preserved subtle animations)"
-                )
-
-        # Optimize for emoji if requested
-        if optimize_for_emoji:
-            if self.width > 128 or self.height > 128:
-                print(
-                    f"  Resizing from {self.width}x{self.height} to 128x128 for emoji"
-                )
-                self.width = 128
-                self.height = 128
-                # Resize all frames
-                resized_frames = []
-                for frame in self.frames:
-                    pil_frame = Image.fromarray(frame)
-                    pil_frame = pil_frame.resize((128, 128), Image.Resampling.LANCZOS)
-                    resized_frames.append(np.array(pil_frame))
-                self.frames = resized_frames
-            num_colors = min(num_colors, 48)  # More aggressive color limit for emoji
-
-            # More aggressive FPS reduction for emoji
-            if len(self.frames) > 12:
-                print(
-                    f"  Reducing frames from {len(self.frames)} to ~12 for emoji size"
-                )
-                # Keep every nth frame to get close to 12 frames
-                keep_every = max(1, len(self.frames) // 12)
-                self.frames = [
-                    self.frames[i] for i in range(0, len(self.frames), keep_every)
-                ]
-
-        # Optimize colors with global palette
-        optimized_frames = self.optimize_colors(num_colors, use_global_palette=True)
-
-        # Calculate frame duration in milliseconds
-        frame_duration = 1000 / self.fps
-
-        # Save GIF
-        imageio.imwrite(
-            output_path,
-            optimized_frames,
-            duration=frame_duration,
-            loop=0,  # Infinite loop
-        )
-
-        # Get file info
-        file_size_kb = output_path.stat().st_size / 1024
-        file_size_mb = file_size_kb / 1024
-
-        info = {
-            "path": str(output_path),
-            "size_kb": file_size_kb,
-            "size_mb": file_size_mb,
-            "dimensions": f"{self.width}x{self.height}",
-            "frame_count": len(optimized_frames),
-            "fps": self.fps,
-            "duration_seconds": len(optimized_frames) / self.fps,
-            "colors": num_colors,
-        }
-
-        # Print info
-        print(f"\n✓ GIF created successfully!")
-        print(f"  Path: {output_path}")
-        print(f"  Size: {file_size_kb:.1f} KB ({file_size_mb:.2f} MB)")
-        print(f"  Dimensions: {self.width}x{self.height}")
-        print(f"  Frames: {len(optimized_frames)} @ {self.fps} fps")
-        print(f"  Duration: {info['duration_seconds']:.1f}s")
-        print(f"  Colors: {num_colors}")
-
-        # Size info
-        if optimize_for_emoji:
-            print(f"  Optimized for emoji (128x128, reduced colors)")
-        if file_size_mb > 1.0:
-            print(f"\n  Note: Large file size ({file_size_kb:.1f} KB)")
-            print("  Consider: fewer frames, smaller dimensions, or fewer colors")
-
-        return info
-
-    def clear(self):
-        """Clear all frames (useful for creating multiple GIFs)."""
-        self.frames = []

package/skills/skills/slack-gif-creator/core/validators.py

@@ -1,136 +0,0 @@
-#!/usr/bin/env python3
-"""
-Validators - Check if GIFs meet Slack's requirements.
-
-These validators help ensure your GIFs meet Slack's size and dimension constraints.
-"""
-
-from pathlib import Path
-
-
-def validate_gif(
-    gif_path: str | Path, is_emoji: bool = True, verbose: bool = True
-) -> tuple[bool, dict]:
-    """
-    Validate GIF for Slack (dimensions, size, frame count).
-
-    Args:
-        gif_path: Path to GIF file
-        is_emoji: True for emoji (128x128 recommended), False for message GIF
-        verbose: Print validation details
-
-    Returns:
-        Tuple of (passes: bool, results: dict with all details)
-    """
-    from PIL import Image
-
-    gif_path = Path(gif_path)
-
-    if not gif_path.exists():
-        return False, {"error": f"File not found: {gif_path}"}
-
-    # Get file size
-    size_bytes = gif_path.stat().st_size
-    size_kb = size_bytes / 1024
-    size_mb = size_kb / 1024
-
-    # Get dimensions and frame info
-    try:
-        with Image.open(gif_path) as img:
-            width, height = img.size
-
-            # Count frames
-            frame_count = 0
-            try:
-                while True:
-                    img.seek(frame_count)
-                    frame_count += 1
-            except EOFError:
-                pass
-
-            # Get duration
-            try:
-                duration_ms = img.info.get("duration", 100)
-                total_duration = (duration_ms * frame_count) / 1000
-                fps = frame_count / total_duration if total_duration > 0 else 0
-            except:
-                total_duration = None
-                fps = None
-
-    except Exception as e:
-        return False, {"error": f"Failed to read GIF: {e}"}
-
-    # Validate dimensions
-    if is_emoji:
-        optimal = width == height == 128
-        acceptable = width == height and 64 <= width <= 128
-        dim_pass = acceptable
-    else:
-        aspect_ratio = (
-            max(width, height) / min(width, height)
-            if min(width, height) > 0
-            else float("inf")
-        )
-        dim_pass = aspect_ratio <= 2.0 and 320 <= min(width, height) <= 640
-
-    results = {
-        "file": str(gif_path),
-        "passes": dim_pass,
-        "width": width,
-        "height": height,
-        "size_kb": size_kb,
-        "size_mb": size_mb,
-        "frame_count": frame_count,
-        "duration_seconds": total_duration,
-        "fps": fps,
-        "is_emoji": is_emoji,
-        "optimal": optimal if is_emoji else None,
-    }
-
-    # Print if verbose
-    if verbose:
-        print(f"\nValidating {gif_path.name}:")
-        print(
-            f"  Dimensions: {width}x{height}"
-            + (
-                f" ({'optimal' if optimal else 'acceptable'})"
-                if is_emoji and acceptable
-                else ""
-            )
-        )
-        print(
-            f"  Size: {size_kb:.1f} KB"
-            + (f" ({size_mb:.2f} MB)" if size_mb >= 1.0 else "")
-        )
-        print(
-            f"  Frames: {frame_count}"
-            + (f" @ {fps:.1f} fps ({total_duration:.1f}s)" if fps else "")
-        )
-
-        if not dim_pass:
-            print(
-                f"  Note: {'Emoji should be 128x128' if is_emoji else 'Unusual dimensions for Slack'}"
-            )
-
-        if size_mb > 5.0:
-            print(f"  Note: Large file size - consider fewer frames/colors")
-
-    return dim_pass, results
-
-
-def is_slack_ready(
-    gif_path: str | Path, is_emoji: bool = True, verbose: bool = True
-) -> bool:
-    """
-    Quick check if GIF is ready for Slack.
-
-    Args:
-        gif_path: Path to GIF file
-        is_emoji: True for emoji GIF, False for message GIF
-        verbose: Print feedback
-
-    Returns:
-        True if dimensions are acceptable
-    """
-    passes, _ = validate_gif(gif_path, is_emoji, verbose)
-    return passes

package/skills/skills/slack-gif-creator/requirements.txt

@@ -1,4 +0,0 @@
-pillow>=10.0.0
-imageio>=2.31.0
-imageio-ffmpeg>=0.4.9
-numpy>=1.24.0