qodev-apollo-cli 1.4.0__tar.gz → 1.5.0__tar.gz

{qodev_apollo_cli-1.4.0 → qodev_apollo_cli-1.5.0}/CHANGELOG.md

@@ -6,6 +6,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.5.0] - 2026-08-31
+
+### Added
+
+- `tasks create` accepts `--user-id`, `--due-at` and `--title`. Apollo rejects task
+  creation with `"Invalid user or creator id"` unless an owner is passed, and there
+  was previously no way to set a due date from the CLI at all.
+- `tasks connect --contact-id` queues a LinkedIn connection request, **by default
+  without a message**. On a `linkedin_step_connect` task the note travels with the
+  invitation, so `--note` is omitted unless you pass one; internal context goes in
+  `--title`, which the contact never sees.
+
 ## [1.4.0] - 2026-07-10
 
 ### Fixed

{qodev_apollo_cli-1.4.0 → qodev_apollo_cli-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: qodev-apollo-cli
-Version: 1.4.0
+Version: 1.5.0
 Summary: Agent-friendly CLI for the Apollo API
 Project-URL: Homepage, https://github.com/qodevai/apollo-cli
 Project-URL: Repository, https://github.com/qodevai/apollo-cli
@@ -19,7 +19,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Requires-Dist: cyclopts>=3.0
-Requires-Dist: qodev-apollo-api>=0.5.0
+Requires-Dist: qodev-apollo-api>=0.6.0
 Requires-Dist: rich>=13.0
 Provides-Extra: dev
 Requires-Dist: mypy>=1.13.0; extra == 'dev'
@@ -111,7 +111,8 @@ $ qodev-apollo-cli usage
 | **notes** | `search` | Search notes (`--contact-id`, `--account-id`, `--opportunity-id`) |
 | | `create` | Create a note (`--contact-ids`, `--account-ids`, `--opportunity-ids`, `--content`) |
 | **tasks** | `search` | Search tasks (`--type`, `--status`) |
-| | `create` | Create a task (`--contact-ids`, `--note`, `--due-at`) |
+| | `create` | Create a task (`--contact-ids`, `--note`, `--user-id`, `--due-at`, `--title`) |
+| | `connect` | Queue a LinkedIn connection request, no message by default (`--contact-id`, `--note`, `--title`) |
 | **calls** | `search` | Search call activities |
 | **conversations** | `search` | Search recorded conversations (`--query`) |
 | | `get` | Get a conversation with transcript and AI summary |

{qodev_apollo_cli-1.4.0 → qodev_apollo_cli-1.5.0}/README.md

@@ -80,7 +80,8 @@ $ qodev-apollo-cli usage
 | **notes** | `search` | Search notes (`--contact-id`, `--account-id`, `--opportunity-id`) |
 | | `create` | Create a note (`--contact-ids`, `--account-ids`, `--opportunity-ids`, `--content`) |
 | **tasks** | `search` | Search tasks (`--type`, `--status`) |
-| | `create` | Create a task (`--contact-ids`, `--note`, `--due-at`) |
+| | `create` | Create a task (`--contact-ids`, `--note`, `--user-id`, `--due-at`, `--title`) |
+| | `connect` | Queue a LinkedIn connection request, no message by default (`--contact-id`, `--note`, `--title`) |
 | **calls** | `search` | Search call activities |
 | **conversations** | `search` | Search recorded conversations (`--query`) |
 | | `get` | Get a conversation with transcript and AI summary |

{qodev_apollo_cli-1.4.0 → qodev_apollo_cli-1.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "qodev-apollo-cli"
-version = "1.4.0"
+version = "1.5.0"
 description = "Agent-friendly CLI for the Apollo API"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -20,7 +20,7 @@ classifiers = [
 dependencies = [
     "cyclopts>=3.0",
     "rich>=13.0",
-    "qodev-apollo-api>=0.5.0",
+    "qodev-apollo-api>=0.6.0",
 ]
 
 [project.optional-dependencies]

qodev_apollo_cli-1.5.0/src/apollo_cli/commands/tasks.py

@@ -0,0 +1,144 @@
+"""Tasks command group."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from cyclopts import App, Parameter
+
+from apollo_cli.context import ctx
+from apollo_cli.formatters.generic import list_table
+from apollo_cli.output import output, output_list
+from apollo_cli.util import parse_comma_list
+
+tasks_app = App(name="tasks", help="Task management.")
+
+
+def _task_extras(*, user_id: str | None, due_at: str | None, title: str | None) -> dict[str, str]:
+    """Collect the optional task fields, omitting the ones left unset."""
+    extra: dict[str, str] = {}
+    if user_id is not None:
+        extra["user_id"] = user_id
+    if due_at is not None:
+        extra["due_at"] = due_at
+    if title is not None:
+        extra["title"] = title
+    return extra
+
+
+TASK_LIST_COLUMNS = [
+    ("ID", "id"),
+    ("Subject", "subject"),
+    ("Type", "type"),
+    ("Priority", "priority"),
+    ("Status", "status"),
+    ("Due", "due_at"),
+]
+
+
+@tasks_app.command
+async def search(
+    *,
+    type: Annotated[str | None, Parameter(name="--type", help="Filter by task type (call, action_item, etc.)")] = None,
+    contact_id: Annotated[str | None, Parameter(name="--contact-id", help="Filter by contact ID")] = None,
+) -> None:
+    """Search tasks."""
+    filters: dict = {}
+    if type:
+        filters["task_type_cds"] = [type]
+    if contact_id:
+        filters["contact_ids"] = [contact_id]
+
+    async with ctx.client() as client:
+        result = await client.search_tasks(page=ctx.page, limit=ctx.limit, **filters)
+
+    output_list(
+        items=result.items,
+        total=result.total,
+        page=result.page,
+        limit=ctx.limit,
+        ctx=ctx,
+        format_fn=lambda items, **kw: list_table(items, TASK_LIST_COLUMNS, title="Tasks", **kw),
+        resource_name="Tasks",
+    )
+
+
+@tasks_app.command
+async def create(
+    *,
+    contact_ids: Annotated[str, Parameter(name="--contact-ids", help="Comma-separated contact IDs")],
+    note: Annotated[str | None, Parameter(name="--note", help="Task description")] = None,
+    type: Annotated[str, Parameter(name="--type", help="Task type")] = "action_item",
+    priority: Annotated[str, Parameter(name="--priority", help="Priority (high, medium, low)")] = "medium",
+    user_id: Annotated[
+        str | None,
+        Parameter(name="--user-id", help="Task owner. Apollo rejects creation without a valid owner"),
+    ] = None,
+    due_at: Annotated[
+        str | None, Parameter(name="--due-at", help="Due date, ISO 8601 (e.g. 2026-09-22T08:00:00Z)")
+    ] = None,
+    title: Annotated[
+        str | None, Parameter(name="--title", help="Task title shown in Apollo (internal, never sent)")
+    ] = None,
+) -> None:
+    """Create a new task."""
+    ids = parse_comma_list(contact_ids)
+    extra = _task_extras(user_id=user_id, due_at=due_at, title=title)
+
+    async with ctx.client() as client:
+        result = await client.create_task(contact_ids=ids, note=note, type=type, priority=priority, **extra)
+
+    output(result, ctx=ctx)
+
+
+@tasks_app.command
+async def connect(
+    *,
+    contact_id: Annotated[str, Parameter(name="--contact-id", help="Contact to send the request to")],
+    note: Annotated[
+        str | None,
+        Parameter(name="--note", help="Text sent WITH the invitation. Omitted (default) = no message"),
+    ] = None,
+    user_id: Annotated[
+        str | None,
+        Parameter(name="--user-id", help="Task owner. Apollo rejects creation without a valid owner"),
+    ] = None,
+    due_at: Annotated[
+        str | None, Parameter(name="--due-at", help="Due date, ISO 8601 (e.g. 2026-09-22T08:00:00Z)")
+    ] = None,
+    title: Annotated[
+        str | None, Parameter(name="--title", help="Task title shown in Apollo (internal, never sent)")
+    ] = None,
+    priority: Annotated[str, Parameter(name="--priority", help="Priority (high, medium, low)")] = "high",
+) -> None:
+    """Queue a LinkedIn connection request, by default without a message.
+
+    On a linkedin_step_connect task the note travels with the invitation, so
+    --note is omitted by default and anything you pass there is seen by the
+    recipient. Put internal context in --title; the contact never sees it.
+    """
+    extra = _task_extras(user_id=user_id, due_at=due_at, title=title)
+
+    async with ctx.client() as client:
+        result = await client.create_task(
+            contact_ids=[contact_id],
+            note=note,
+            type="linkedin_step_connect",
+            priority=priority,
+            **extra,
+        )
+
+    output(result, ctx=ctx)
+
+
+@tasks_app.command
+async def complete(
+    id: Annotated[str, Parameter(help="Task ID")],
+    *,
+    note: Annotated[str | None, Parameter(name="--note", help="Completion note")] = None,
+) -> None:
+    """Mark a task as completed."""
+    async with ctx.client() as client:
+        result = await client.complete_task(id, note=note)
+
+    output(result, ctx=ctx)

{qodev_apollo_cli-1.4.0 → qodev_apollo_cli-1.5.0}/tests/test_commands.py

@@ -726,3 +726,83 @@ class TestNotesCommands:
         assert call_kwargs["contact_ids"] == ["c1"]
         assert call_kwargs["account_ids"] == ["a1"]
         assert call_kwargs["opportunity_ids"] == ["d1"]
+
+
+class TestTasksCommands:
+    @pytest.mark.asyncio
+    async def test_create_passes_owner_due_and_title(self) -> None:
+        """--user-id / --due-at / --title reach the client."""
+        mock_client = MagicMock()
+        mock_client.create_task = AsyncMock(return_value={"id": "t1"})
+
+        _ctx.ctx.configure(json_mode=True, api_key="test-key", limit=25, page=1)
+
+        with patch.object(_ctx.ctx, "client", return_value=MockAsyncContextManager(mock_client)):
+            from apollo_cli.commands.tasks import create
+
+            await create(
+                contact_ids="c1",
+                note="Follow up",
+                user_id="u1",
+                due_at="2026-09-22T08:00:00Z",
+                title="Internal title",
+            )
+
+        kwargs = mock_client.create_task.call_args.kwargs
+        assert kwargs["user_id"] == "u1"
+        assert kwargs["due_at"] == "2026-09-22T08:00:00Z"
+        assert kwargs["title"] == "Internal title"
+
+    @pytest.mark.asyncio
+    async def test_create_omits_unset_optionals(self) -> None:
+        """Optional task fields stay out of the call when not given."""
+        mock_client = MagicMock()
+        mock_client.create_task = AsyncMock(return_value={"id": "t2"})
+
+        _ctx.ctx.configure(json_mode=True, api_key="test-key", limit=25, page=1)
+
+        with patch.object(_ctx.ctx, "client", return_value=MockAsyncContextManager(mock_client)):
+            from apollo_cli.commands.tasks import create
+
+            await create(contact_ids="c1")
+
+        kwargs = mock_client.create_task.call_args.kwargs
+        assert kwargs["note"] is None
+        assert "user_id" not in kwargs
+        assert "due_at" not in kwargs
+        assert "title" not in kwargs
+
+    @pytest.mark.asyncio
+    async def test_connect_sends_empty_note(self) -> None:
+        """A connection request carries no message and defaults to high priority."""
+        mock_client = MagicMock()
+        mock_client.create_task = AsyncMock(return_value={"id": "t3"})
+
+        _ctx.ctx.configure(json_mode=True, api_key="test-key", limit=25, page=1)
+
+        with patch.object(_ctx.ctx, "client", return_value=MockAsyncContextManager(mock_client)):
+            from apollo_cli.commands.tasks import connect
+
+            await connect(contact_id="c1", user_id="u1", title="Connect Jane Doe")
+
+        kwargs = mock_client.create_task.call_args.kwargs
+        assert kwargs["contact_ids"] == ["c1"]
+        assert kwargs["note"] is None
+        assert kwargs["type"] == "linkedin_step_connect"
+        assert kwargs["priority"] == "high"
+        assert kwargs["title"] == "Connect Jane Doe"
+
+    @pytest.mark.asyncio
+    async def test_connect_forwards_a_note_when_given(self) -> None:
+        """--note is supported; it travels with the invitation when supplied."""
+        mock_client = MagicMock()
+        mock_client.create_task = AsyncMock(return_value={"id": "t4"})
+
+        _ctx.ctx.configure(json_mode=True, api_key="test-key", limit=25, page=1)
+
+        with patch.object(_ctx.ctx, "client", return_value=MockAsyncContextManager(mock_client)):
+            from apollo_cli.commands.tasks import connect
+
+            await connect(contact_id="c1", note="Hi Jane, ...")
+
+        assert mock_client.create_task.call_args.kwargs["note"] == "Hi Jane, ..."

{qodev_apollo_cli-1.4.0 → qodev_apollo_cli-1.5.0}/uv.lock

@@ -472,7 +472,7 @@ wheels = [
 
 [[package]]
 name = "qodev-apollo-api"
-version = "0.5.0"
+version = "0.6.0"
 source = { directory = "../apollo-api" }
 dependencies = [
     { name = "httpx" },
@@ -494,7 +494,7 @@ provides-extras = ["dev"]
 
 [[package]]
 name = "qodev-apollo-cli"
-version = "1.4.0"
+version = "1.5.0"
 source = { editable = "." }
 dependencies = [
     { name = "cyclopts" },

qodev_apollo_cli-1.4.0/src/apollo_cli/commands/tasks.py

@@ -1,80 +0,0 @@
-"""Tasks command group."""
-
-from __future__ import annotations
-
-from typing import Annotated
-
-from cyclopts import App, Parameter
-
-from apollo_cli.context import ctx
-from apollo_cli.formatters.generic import list_table
-from apollo_cli.output import output, output_list
-from apollo_cli.util import parse_comma_list
-
-tasks_app = App(name="tasks", help="Task management.")
-
-TASK_LIST_COLUMNS = [
-    ("ID", "id"),
-    ("Subject", "subject"),
-    ("Type", "type"),
-    ("Priority", "priority"),
-    ("Status", "status"),
-    ("Due", "due_at"),
-]
-
-
-@tasks_app.command
-async def search(
-    *,
-    type: Annotated[str | None, Parameter(name="--type", help="Filter by task type (call, action_item, etc.)")] = None,
-    contact_id: Annotated[str | None, Parameter(name="--contact-id", help="Filter by contact ID")] = None,
-) -> None:
-    """Search tasks."""
-    filters: dict = {}
-    if type:
-        filters["task_type_cds"] = [type]
-    if contact_id:
-        filters["contact_ids"] = [contact_id]
-
-    async with ctx.client() as client:
-        result = await client.search_tasks(page=ctx.page, limit=ctx.limit, **filters)
-
-    output_list(
-        items=result.items,
-        total=result.total,
-        page=result.page,
-        limit=ctx.limit,
-        ctx=ctx,
-        format_fn=lambda items, **kw: list_table(items, TASK_LIST_COLUMNS, title="Tasks", **kw),
-        resource_name="Tasks",
-    )
-
-
-@tasks_app.command
-async def create(
-    *,
-    contact_ids: Annotated[str, Parameter(name="--contact-ids", help="Comma-separated contact IDs")],
-    note: Annotated[str, Parameter(name="--note", help="Task description")],
-    type: Annotated[str, Parameter(name="--type", help="Task type")] = "action_item",
-    priority: Annotated[str, Parameter(name="--priority", help="Priority (high, medium, low)")] = "medium",
-) -> None:
-    """Create a new task."""
-    ids = parse_comma_list(contact_ids)
-
-    async with ctx.client() as client:
-        result = await client.create_task(contact_ids=ids, note=note, type=type, priority=priority)
-
-    output(result, ctx=ctx)
-
-
-@tasks_app.command
-async def complete(
-    id: Annotated[str, Parameter(help="Task ID")],
-    *,
-    note: Annotated[str | None, Parameter(name="--note", help="Completion note")] = None,
-) -> None:
-    """Mark a task as completed."""
-    async with ctx.client() as client:
-        result = await client.complete_task(id, note=note)
-
-    output(result, ctx=ctx)