glaip-sdk 0.6.25__py3-none-any.whl → 0.7.0__py3-none-any.whl

glaip_sdk/cli/commands/tools/delete.py

@@ -0,0 +1,61 @@
+"""Delete tool command.
+
+Authors:
+    Raymond Christopher (raymond.christopher@gdplabs.id)
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+import click
+
+from glaip_sdk.cli.context import get_ctx_value, output_flags
+from glaip_sdk.cli.display import (
+    display_api_error,
+    display_confirmation_prompt,
+    display_deletion_success,
+    handle_json_output,
+    handle_rich_output,
+)
+from glaip_sdk.cli.core.rendering import spinner_context
+
+from ._common import _get_tool_by_id_with_spinner, console, tools_group
+
+
+@tools_group.command()
+@click.argument("tool_id")
+@click.option("-y", "--yes", is_flag=True, help="Skip confirmation")
+@output_flags()
+@click.pass_context
+def delete(ctx: Any, tool_id: str, yes: bool) -> None:
+    """Delete a tool."""
+    try:
+        # Get tool by ID (no ambiguity handling needed)
+        tool = _get_tool_by_id_with_spinner(ctx, tool_id)
+
+        # Confirm deletion via centralized display helper
+        if not yes and not display_confirmation_prompt("Tool", tool.name):
+            return
+
+        with spinner_context(
+            ctx,
+            "[bold blue]Deleting tool…[/bold blue]",
+            console_override=console,
+        ):
+            tool.delete()
+
+        handle_json_output(
+            ctx,
+            {
+                "success": True,
+                "message": f"Tool '{tool.name}' deleted",
+            },
+        )
+        handle_rich_output(ctx, display_deletion_success("Tool", tool.name))
+
+    except Exception as e:
+        handle_json_output(ctx, error=e)
+        if get_ctx_value(ctx, "view") != "json":
+            display_api_error(e, "tool deletion")
+        raise click.ClickException(str(e)) from e

glaip_sdk/cli/commands/tools/get.py

@@ -0,0 +1,103 @@
+"""Get tool command.
+
+Authors:
+    Raymond Christopher (raymond.christopher@gdplabs.id)
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+import click
+
+from glaip_sdk.branding import WARNING_STYLE
+from glaip_sdk.cli.context import output_flags
+from glaip_sdk.cli.core.context import get_client
+from glaip_sdk.cli.core.output import format_datetime_fields, handle_resource_export, output_result
+from glaip_sdk.cli.core.rendering import spinner_context
+from glaip_sdk.cli.io import fetch_raw_resource_details
+from glaip_sdk.icons import ICON_TOOL
+
+from ._common import _resolve_tool, console, tools_group
+
+
+@tools_group.command()
+@click.argument("tool_ref")
+@click.option("--select", type=int, help="Choose among ambiguous matches (1-based)")
+@click.option(
+    "--export",
+    type=click.Path(dir_okay=False, writable=True),
+    help="Export complete tool configuration to file (format auto-detected from .json/.yaml extension)",
+)
+@output_flags()
+@click.pass_context
+def get(ctx: Any, tool_ref: str, select: int | None, export: str | None) -> None:
+    r"""Get tool details.
+
+    \b
+    Examples:
+        aip tools get my-tool
+        aip tools get my-tool --export tool.json    # Exports complete configuration as JSON
+        aip tools get my-tool --export tool.yaml    # Exports complete configuration as YAML
+    """
+    try:
+        client = get_client(ctx)
+
+        # Resolve tool with ambiguity handling
+        tool = _resolve_tool(ctx, client, tool_ref, select)
+
+        # Handle export option
+        if export:
+            handle_resource_export(
+                ctx,
+                tool,
+                Path(export),
+                resource_type="tool",
+                get_by_id_func=client.get_tool_by_id,
+                console_override=console,
+            )
+
+        # Try to fetch raw API data first to preserve ALL fields
+        with spinner_context(
+            ctx,
+            "[bold blue]Fetching detailed tool data…[/bold blue]",
+            console_override=console,
+        ):
+            raw_tool_data = fetch_raw_resource_details(client, tool, "tools")
+
+        if raw_tool_data:
+            # Use raw API data - this preserves ALL fields
+            # Format dates for better display (minimal postprocessing)
+            formatted_data = format_datetime_fields(raw_tool_data)
+
+            # Display using output_result with raw data
+            output_result(
+                ctx,
+                formatted_data,
+                title="Tool Details",
+                panel_title=f"{ICON_TOOL} {raw_tool_data.get('name', 'Unknown')}",
+            )
+        else:
+            # Fall back to original method if raw fetch fails
+            console.print(f"[{WARNING_STYLE}]Falling back to Pydantic model data[/]")
+
+            # Create result data with all available fields from backend
+            result_data = {
+                "id": str(getattr(tool, "id", "N/A")),
+                "name": getattr(tool, "name", "N/A"),
+                "tool_type": getattr(tool, "tool_type", "N/A"),
+                "framework": getattr(tool, "framework", "N/A"),
+                "version": getattr(tool, "version", "N/A"),
+                "description": getattr(tool, "description", "N/A"),
+            }
+
+            output_result(
+                ctx,
+                result_data,
+                title="Tool Details",
+                panel_title=f"{ICON_TOOL} {tool.name}",
+            )
+
+    except Exception as e:
+        raise click.ClickException(str(e)) from e

glaip_sdk/cli/commands/tools/list.py

@@ -0,0 +1,69 @@
+"""List tools command.
+
+Authors:
+    Raymond Christopher (raymond.christopher@gdplabs.id)
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+import click
+
+from glaip_sdk.branding import ACCENT_STYLE, INFO
+from glaip_sdk.cli.context import output_flags
+from glaip_sdk.cli.core.context import get_client
+from glaip_sdk.cli.core.output import coerce_to_row, output_list
+from glaip_sdk.cli.core.rendering import spinner_context
+from glaip_sdk.icons import ICON_TOOL
+
+from ._common import console, tools_group
+
+
+@tools_group.command(name="list")
+@output_flags()
+@click.option(
+    "--type",
+    "tool_type",
+    help="Filter tools by type (e.g., custom, native)",
+    type=str,
+    required=False,
+)
+@click.pass_context
+def list_tools(ctx: Any, tool_type: str | None) -> None:
+    """List all tools."""
+    try:
+        client = get_client(ctx)
+        with spinner_context(
+            ctx,
+            "[bold blue]Fetching tools…[/bold blue]",
+            console_override=console,
+        ):
+            tools = client.list_tools(tool_type=tool_type)
+
+        # Define table columns: (data_key, header, style, width)
+        columns = [
+            ("id", "ID", "dim", 36),
+            ("name", "Name", ACCENT_STYLE, None),
+            ("framework", "Framework", INFO, None),
+        ]
+
+        # Transform function for safe dictionary access
+        def transform_tool(tool: Any) -> dict[str, Any]:
+            """Transform a tool object to a display row dictionary.
+
+            Args:
+                tool: Tool object to transform.
+
+            Returns:
+                Dictionary with id, name, and framework fields.
+            """
+            row = coerce_to_row(tool, ["id", "name", "framework"])
+            # Ensure id is always a string
+            row["id"] = str(row["id"])
+            return row
+
+        output_list(ctx, tools, f"{ICON_TOOL} Available Tools", columns, transform_tool)
+
+    except Exception as e:
+        raise click.ClickException(str(e)) from e

glaip_sdk/cli/commands/tools/script.py

@@ -0,0 +1,49 @@
+"""Get tool script command.
+
+Authors:
+    Raymond Christopher (raymond.christopher@gdplabs.id)
+"""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+
+import click
+
+from glaip_sdk.branding import ERROR_STYLE, SUCCESS_STYLE
+from glaip_sdk.cli.context import get_ctx_value, output_flags
+from glaip_sdk.cli.core.context import get_client
+from glaip_sdk.cli.core.rendering import spinner_context
+from glaip_sdk.cli.display import handle_json_output
+from glaip_sdk.cli.rich_helpers import print_markup
+
+from ._common import console, tools_group
+
+
+@tools_group.command("script")
+@click.argument("tool_id")
+@output_flags()
+@click.pass_context
+def script(ctx: Any, tool_id: str) -> None:
+    """Get tool script content."""
+    try:
+        client = get_client(ctx)
+        with spinner_context(
+            ctx,
+            "[bold blue]Fetching tool script…[/bold blue]",
+            console_override=console,
+        ):
+            script_content = client.get_tool_script(tool_id)
+
+        if get_ctx_value(ctx, "view") == "json":
+            click.echo(json.dumps({"script": script_content}, indent=2))
+        else:
+            console.print(f"[{SUCCESS_STYLE}]📜 Tool Script for '{tool_id}':[/]")
+            console.print(script_content)
+
+    except Exception as e:
+        handle_json_output(ctx, error=e)
+        if get_ctx_value(ctx, "view") != "json":
+            print_markup(f"[{ERROR_STYLE}]Error getting tool script: {e}[/]", console=console)
+        raise click.ClickException(str(e)) from e

glaip_sdk/cli/commands/tools/update.py

@@ -0,0 +1,102 @@
+"""Update tool command.
+
+Authors:
+    Raymond Christopher (raymond.christopher@gdplabs.id)
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+import click
+
+from glaip_sdk.branding import SUCCESS_STYLE, WARNING_STYLE
+from glaip_sdk.cli.context import get_ctx_value, output_flags
+from glaip_sdk.cli.display import display_api_error, display_update_success, handle_json_output, handle_rich_output
+from glaip_sdk.cli.core.context import get_client
+from glaip_sdk.cli.core.rendering import spinner_context
+from glaip_sdk.cli.rich_helpers import markup_text
+
+from ._common import _get_tool_by_id_with_spinner, console, tools_group
+from .create import _parse_tags
+
+
+@tools_group.command()
+@click.argument("tool_id")
+@click.option(
+    "--file",
+    type=click.Path(exists=True),
+    help="New tool file for code update (custom tools only)",
+)
+@click.option("--description", help="New description")
+@click.option("--tags", help="Comma-separated tags")
+@output_flags()
+@click.pass_context
+def update(
+    ctx: Any,
+    tool_id: str,
+    file: str | None,
+    description: str | None,
+    tags: str | None,
+) -> None:
+    """Update a tool (code or metadata)."""
+    try:
+        client = get_client(ctx)
+
+        # Get tool by ID (no ambiguity handling needed)
+        tool = _get_tool_by_id_with_spinner(ctx, tool_id)
+
+        update_kwargs: dict[str, Any] = {}
+        if description is not None:
+            update_kwargs["description"] = description
+        if tags:
+            update_kwargs["tags"] = _parse_tags(tags)
+
+        if file:
+            # Update code via file upload (custom tools only)
+            if tool.tool_type != "custom":
+                raise click.ClickException(
+                    "File updates are only supported for custom tools. "
+                    f"Tool '{tool.name}' is of type '{tool.tool_type}'."
+                )
+            with spinner_context(
+                ctx,
+                "[bold blue]Uploading new tool code…[/bold blue]",
+                console_override=console,
+            ):
+                updated_tool = client.tools.update_tool_via_file(
+                    tool.id,
+                    file,
+                    framework=tool.framework,
+                    **update_kwargs,
+                )
+            handle_rich_output(
+                ctx,
+                markup_text(f"[{SUCCESS_STYLE}]✓[/] Tool code updated from {file}"),
+            )
+        elif update_kwargs:
+            # Update metadata only (native tools only)
+            if tool.tool_type != "native":
+                raise click.ClickException(
+                    "Metadata updates are only supported for native tools. "
+                    f"Tool '{tool.name}' is of type '{tool.tool_type}'."
+                )
+            with spinner_context(
+                ctx,
+                "[bold blue]Updating tool metadata…[/bold blue]",
+                console_override=console,
+            ):
+                updated_tool = client.tools.update_tool(tool, **update_kwargs)
+            handle_rich_output(ctx, markup_text(f"[{SUCCESS_STYLE}]✓[/] Tool metadata updated"))
+        else:
+            handle_rich_output(ctx, markup_text(f"[{WARNING_STYLE}]No updates specified[/]"))
+            return
+
+        handle_json_output(ctx, updated_tool.model_dump())
+        handle_rich_output(ctx, display_update_success("Tool", updated_tool.name))
+
+    except Exception as e:
+        handle_json_output(ctx, error=e)
+        if get_ctx_value(ctx, "view") != "json":
+            display_api_error(e, "tool update")
+        raise click.ClickException(str(e)) from e

glaip_sdk/cli/commands/transcripts/__init__.py

@@ -0,0 +1,90 @@
+"""Transcript CLI commands package.
+
+Authors:
+    Raymond Christopher (raymond.christopher@gdplabs.id)
+"""
+
+from glaip_sdk.cli.commands.transcripts._common import transcripts_group
+from glaip_sdk.cli.commands.transcripts.clear import transcripts_clear
+from glaip_sdk.cli.commands.transcripts.detail import transcripts_detail
+
+# Import helper functions from original file for backward compatibility
+# NOTE: Transcripts migration is deferred per spec (see resource-command-alignment/spec.md).
+# NOTE: Migration is tracked in ../observability/transcript-storage-viewer-services/spec.md (Phase 0).
+# This package currently re-exports from transcripts_original.py until the migration is completed.
+from glaip_sdk.cli.commands.transcripts_original import (  # noqa: E402, type: ignore
+    _abbreviate_path,
+    _build_table,
+    _build_viewer_context,
+    _coerce_timestamp_to_float,
+    _collect_targets,
+    _confirm_deletion,
+    _decode_transcript,
+    _emit_warnings,
+    _format_duration,
+    _format_timestamp,
+    _format_timestamp_display,
+    _handle_clear_result,
+    _launch_transcript_viewer,
+    _load_transcript_text,
+    _maybe_launch_transcript_viewer,
+    _parse_event_received_timestamp,
+    _parse_transcript_line,
+    _print_snapshot,
+    _render_deletion_preview,
+    _render_detail_view,
+    _render_history_overview,
+    _render_transcript_display,
+    _resolve_transcript_path,
+    _row_label,
+    _should_exit_for_targets,
+    _should_use_transcript_viewer,
+    _transcripts_payload,
+    _validate_clear_options,
+    console,
+    sys,
+)
+
+# Import functions from other modules for test compatibility
+from glaip_sdk.cli.transcript.history import load_history_snapshot  # noqa: E402
+from glaip_sdk.cli.transcript.viewer import run_viewer_session  # noqa: E402
+from glaip_sdk.utils.rendering.layout.panels import create_final_panel  # noqa: E402
+
+__all__ = [
+    "transcripts_group",
+    "transcripts_clear",
+    "transcripts_detail",
+    "_abbreviate_path",
+    "_build_table",
+    "_build_viewer_context",
+    "_coerce_timestamp_to_float",
+    "_collect_targets",
+    "_confirm_deletion",
+    "_decode_transcript",
+    "_emit_warnings",
+    "_format_duration",
+    "_format_timestamp",
+    "_format_timestamp_display",
+    "_handle_clear_result",
+    "_launch_transcript_viewer",
+    "_load_transcript_text",
+    "_maybe_launch_transcript_viewer",
+    "_parse_event_received_timestamp",
+    "_parse_transcript_line",
+    "_print_snapshot",
+    "_render_deletion_preview",
+    "_render_detail_view",
+    "_render_history_overview",
+    "_render_transcript_display",
+    "_resolve_transcript_path",
+    "_row_label",
+    "_should_exit_for_targets",
+    "_should_use_transcript_viewer",
+    "_transcripts_payload",
+    "_validate_clear_options",
+    "console",
+    "sys",
+    "load_history_snapshot",
+    "run_viewer_session",
+    "create_final_panel",
+]

glaip_sdk/cli/commands/transcripts/_common.py

@@ -0,0 +1,9 @@
+"""Common helpers for transcript commands.
+
+Authors:
+    Raymond Christopher (raymond.christopher@gdplabs.id)
+"""
+
+from glaip_sdk.cli.commands.transcripts_original import transcripts_group  # type: ignore
+
+__all__ = ["transcripts_group"]

glaip_sdk/cli/commands/transcripts/clear.py

@@ -0,0 +1,5 @@
+"""Clear transcripts command."""
+
+from glaip_sdk.cli.commands.transcripts_original import transcripts_clear  # type: ignore
+
+__all__ = ["transcripts_clear"]

glaip_sdk/cli/commands/transcripts/detail.py

@@ -0,0 +1,5 @@
+"""Transcript detail command."""
+
+from glaip_sdk.cli.commands.transcripts_original import transcripts_detail  # type: ignore
+
+__all__ = ["transcripts_detail"]

glaip_sdk/cli/slash/tui/__init__.py

@@ -1,9 +1,18 @@
 """Textual UI helpers for slash commands."""
 
+from glaip_sdk.cli.slash.tui.context import TUIContext
 from glaip_sdk.cli.slash.tui.remote_runs_app import (
     RemoteRunsTextualApp,
     RemoteRunsTUICallbacks,
     run_remote_runs_textual,
 )
+from glaip_sdk.cli.slash.tui.terminal import TerminalCapabilities, detect_terminal_background
 
-__all__ = ["RemoteRunsTextualApp", "RemoteRunsTUICallbacks", "run_remote_runs_textual"]
+__all__ = [
+    "TUIContext",
+    "TerminalCapabilities",
+    "detect_terminal_background",
+    "RemoteRunsTextualApp",
+    "RemoteRunsTUICallbacks",
+    "run_remote_runs_textual",
+]

glaip_sdk/cli/slash/tui/context.py

@@ -0,0 +1,51 @@
+"""Shared context for all TUI components.
+
+This module provides the TUIContext dataclass, which serves as the Python equivalent
+of OpenCode's nested provider pattern. It provides a single container for all TUI
+services and state that can be injected into components.
+
+Authors:
+    Raymond Christopher (raymond.christopher@gdplabs.id)
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from glaip_sdk.cli.slash.tui.terminal import TerminalCapabilities
+
+
+@dataclass
+class TUIContext:
+    """Shared context for all TUI components (Python equivalent of OpenCode's providers).
+
+    This context provides access to all TUI services and state. Components that will
+    be implemented in later phases are typed as Optional and will be None initially.
+
+    Attributes:
+        terminal: Terminal capability detection results.
+        keybinds: Central keybind registry (Phase 3).
+        theme: Theme manager for light/dark mode and color tokens (Phase 2).
+        toasts: Toast notification bus (Phase 4).
+        clipboard: Clipboard adapter with OSC 52 support (Phase 4).
+    """
+
+    terminal: TerminalCapabilities
+    keybinds: object | None = None
+    theme: object | None = None
+    toasts: object | None = None
+    clipboard: object | None = None
+
+    @classmethod
+    async def create(cls) -> TUIContext:
+        """Create a TUIContext instance with detected terminal capabilities.
+
+        This factory method detects terminal capabilities asynchronously and
+        returns a populated TUIContext instance. Other components (keybinds,
+        theme, toasts, clipboard) will be set incrementally as they are created.
+
+        Returns:
+            TUIContext instance with terminal capabilities detected.
+        """
+        terminal = await TerminalCapabilities.detect()
+        return cls(terminal=terminal)