gumloop 0.5.1__tar.gz → 0.5.2__tar.gz

{gumloop-0.5.1 → gumloop-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: gumloop
-Version: 0.5.1
+Version: 0.5.2
 Summary: Python client for the Gumloop API
 Project-URL: Homepage, https://github.com/gumloop/gumloop-py
 Project-URL: Bug Tracker, https://github.com/gumloop/gumloop-py/issues

{gumloop-0.5.1 → gumloop-0.5.2}/src/gumloop/_version.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.5.1"
+__version__ = "0.5.2"

{gumloop-0.5.1 → gumloop-0.5.2}/src/gumloop/cli/commands/sessions.py

@@ -24,6 +24,7 @@ sessions_app = typer.Typer(
     epilog=(
         "Examples:\n"
         "  gumloop sessions create agent_abc --input 'Hello!'\n"
+        "  gumloop sessions create agent_abc --name 'Invoice 4471' --input 'Reconcile invoice 4471'\n"
         "  echo 'Hi from a file' | gumloop sessions create agent_abc --input-stdin -"
     ),
 )
@@ -42,6 +43,10 @@ def create_session(
         str | None,
         typer.Option("--session-id", help="Optional client-side id for the new session."),
     ] = None,
+    name: Annotated[
+        str | None,
+        typer.Option("--name", help="Session name shown in the sidebar (1-256 characters)."),
+    ] = None,
     json_output: Annotated[
         bool,
         typer.Option("--json", help="Print the raw SDK response as JSON."),
@@ -56,6 +61,8 @@ def create_session(
             raise GumloopError("Pass at most one of --input or --input-stdin.")
         if input_stdin is not None and input_stdin != "-":
             raise GumloopError("--input-stdin only accepts '-' (reads from stdin).")
+        if name is not None and not name.strip():
+            raise GumloopError("Pass a non-empty --name.")
         message = sys.stdin.read() if input_stdin == "-" else input_text
 
         # cast narrows SessionResponse | Iterator to the non-streaming branch
@@ -67,6 +74,7 @@ def create_session(
                     agent_id,
                     input=message,
                     session_id=session_id,
+                    name=name,
                 )
             ),
         )
@@ -82,7 +90,7 @@ def create_session(
     # message bodies go through rich.text.Text.
     session = response.session
     console.print(f"[bold]Session {escape_markup(session.id)}[/bold]", markup=True, highlight=False)
-    for field in ("agent_id", "agent_name", "state", "created_at"):
+    for field in ("name", "agent_id", "agent_name", "state", "created_at"):
         value = getattr(session, field, None)
         if value not in (None, ""):
             console.print(f"  {field}: {value}", markup=False, highlight=False)
@@ -208,7 +216,7 @@ def get_session(
 
     session = response.session
     console.print(f"[bold]Session {escape_markup(session.id)}[/bold]", markup=True, highlight=False)
-    for field in ("agent_id", "agent_name", "state", "created_at"):
+    for field in ("name", "agent_id", "agent_name", "state", "created_at"):
         value = getattr(session, field, None)
         if value not in (None, ""):
             console.print(f"  {field}: {value}", markup=False, highlight=False)
@@ -272,7 +280,7 @@ def send_session(
         return
 
     console.print(f"[bold]Session {escape_markup(session.id)}[/bold]", markup=True, highlight=False)
-    for field in ("agent_id", "agent_name", "state", "created_at"):
+    for field in ("name", "agent_id", "agent_name", "state", "created_at"):
         value = getattr(session, field, None)
         if value not in (None, ""):
             console.print(f"  {field}: {value}", markup=False, highlight=False)

{gumloop-0.5.1 → gumloop-0.5.2}/src/gumloop/cli/plugin_assets/gumloop/skills/gumloop-cli/references/commands.md

@@ -51,12 +51,16 @@ cat task.txt | gumloop models route --input-stdin - --model gpt-5.6-luna --model
 ## Sessions
 
 ```bash
-gumloop sessions create <agent_id> [--input text | --input-stdin -] [--session-id id] [--json]
+gumloop sessions create <agent_id> [--input text | --input-stdin -] [--session-id id] [--name name] [--json]
+gumloop sessions list <agent_id> [--search text] [--state s] [--type t] [--sort order] [--limit n] [--json]
 gumloop sessions get <session_id> [--json]          # --json returns the full transcript
 gumloop sessions send <session_id> [--input text | --input-stdin -] [--json]
+gumloop sessions rename <session_id> <name>
 gumloop sessions cancel <session_id>
 ```
 
+`--name` sets the name shown in the sidebar; without it the session keeps the agent's name until renamed. `list --search` matches session names (and message content), so named sessions are findable by name.
+
 ## Chat completions
 
 ```bash

{gumloop-0.5.1 → gumloop-0.5.2}/src/gumloop/types.py

@@ -329,6 +329,7 @@ class SessionCreateRequest(_Model):
     input: str | list[Any] | None = None
     message: str | list[Any] | None = None
     session_id: str | None = None
+    name: str | None = None
     metadata: dict[str, Any] | None = None
     stream: bool = False
 

{gumloop-0.5.1 → gumloop-0.5.2}/tests/cli/test_sessions.py

@@ -29,6 +29,38 @@ def test_sessions_create_posts_to_per_agent_endpoint_with_inline_input(cli_runne
     assert sent["input"] == "hello there"
 
 
+@respx.mock
+def test_sessions_create_sends_name(cli_runner: CliRunner) -> None:
+    route = respx.post(f"{API_BASE}/agents/agent_abc/sessions").mock(
+        return_value=httpx.Response(
+            201,
+            json={"session": {"id": "session_xyz", "agent_id": "agent_abc", "name": "CDE Lightband ebff4bf3"}},
+        )
+    )
+    save_credentials(Credentials(api_key="key"))
+
+    result = cli_runner.invoke(
+        app,
+        ["sessions", "create", "agent_abc", "--name", "CDE Lightband ebff4bf3", "--input", "start"],
+    )
+
+    assert result.exit_code == 0, result.output
+    sent = json.loads(route.calls[0].request.content)
+    assert sent["name"] == "CDE Lightband ebff4bf3"
+    assert "CDE Lightband ebff4bf3" in result.output
+
+
+@respx.mock
+def test_sessions_create_rejects_blank_name(cli_runner: CliRunner) -> None:
+    route = respx.post(f"{API_BASE}/agents/agent_abc/sessions")
+    save_credentials(Credentials(api_key="key"))
+
+    result = cli_runner.invoke(app, ["sessions", "create", "agent_abc", "--name", "  ", "--json"])
+
+    assert result.exit_code != 0
+    assert not route.called
+
+
 @respx.mock
 def test_sessions_create_reads_input_from_stdin(cli_runner: CliRunner) -> None:
     route = respx.post(f"{API_BASE}/agents/agent_abc/sessions").mock(