honcho-cli 0.3.0__tar.gz → 0.4.0__tar.gz

{honcho_cli-0.3.0 → honcho_cli-0.4.0}/CHANGELOG.md

@@ -5,7 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
-## [Unreleased]
+## [0.4.0] - 2026-10-29
+
+### Added
+
+- `source_message_ids` on conclusion output: the messages an explicit conclusion cites as evidence (Honcho v3.5.0+; a count in table mode, the full list in JSON). `conclusion list --cites <message_id>` narrows to the conclusions that cite a message. Null in JSON on servers or SDKs that predate the field (#935)
+
+### Changed
+
+- Requires `honcho-ai` 2.8.0 or newer, the first Python SDK that carries `source_message_ids`
 
 ## [0.3.0] - 2026-10-23
 

{honcho_cli-0.3.0 → honcho_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: honcho-cli
-Version: 0.3.0
+Version: 0.4.0
 Summary: A terminal for Honcho — memory that reasons.
 Project-URL: Homepage, https://github.com/plastic-labs/honcho
 Project-URL: Repository, https://github.com/plastic-labs/honcho
@@ -15,7 +15,7 @@ Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.11
 Requires-Dist: certifi>=2026.10.19
 Requires-Dist: click>=8.0.0
-Requires-Dist: honcho-ai>=2.5.0
+Requires-Dist: honcho-ai>=2.8.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: questionary>=2.1.0
 Requires-Dist: rich>=13.0.0

{honcho_cli-0.3.0 → honcho_cli-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "honcho-cli"
-version = "0.3.0"
+version = "0.4.0"
 description = "A terminal for Honcho — memory that reasons."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -19,7 +19,7 @@ classifiers = [
 dependencies = [
     "click>=8.0.0",
     "typer>=0.15.0",
-    "honcho-ai>=2.5.0",
+    "honcho-ai>=2.8.0",
     "rich>=13.0.0",
     "httpx>=0.27.0",
     "questionary>=2.1.0",

{honcho_cli-0.3.0 → honcho_cli-0.4.0}/src/honcho_cli/__init__.py

@@ -1,3 +1,3 @@
 """Honcho CLI — a terminal for Honcho."""
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"

{honcho_cli-0.3.0 → honcho_cli-0.4.0}/src/honcho_cli/commands/conclusion.py

@@ -21,23 +21,29 @@ add_common_options(app)
 _LEVELS = ("explicit", "deductive", "inductive", "contradiction")
 
 #: Columns carrying a conclusion's attribution, shown alongside the content.
-_ATTRIBUTION_COLUMNS = ["id", "level", "source_ids", "times_derived", "content"]
+_ATTRIBUTION_COLUMNS = ["id", "level", "source_ids", "source_message_ids", "times_derived", "content"]
 
 
 def _format_conclusion(c, workspace_id: str | None) -> dict:
     """Shape a Conclusion for output.
 
     ``level``, ``source_ids`` and ``times_derived`` are the attribution the
-    server started returning in Honcho v3.2.0. In table mode ``source_ids``
-    collapses to a count, since the ids are nanoids and a list of them makes
-    the row unreadable; JSON mode keeps the full list so it can be piped back
-    into ``honcho conclusion get``.
+    server started returning in Honcho v3.2.0; ``source_message_ids`` (the
+    messages an explicit conclusion cites) arrived in v3.5.0 and is read
+    leniently so older SDKs still work. In table mode the id lists collapse
+    to counts, since nanoids make the row unreadable; JSON mode keeps them so
+    they can be piped back into ``honcho conclusion get`` or ``message get``.
     """
     source_ids = c.source_ids or []
+    # JSON keeps None ("no citation record") apart from [] ("cites nothing").
+    source_message_ids = getattr(c, "source_message_ids", None)
     return {
         "id": c.id,
         "level": c.level,
         "source_ids": source_ids if use_json() else len(source_ids),
+        "source_message_ids": source_message_ids
+        if use_json()
+        else len(source_message_ids or []),
         "times_derived": c.times_derived,
         "content": c.content if use_json() else c.content[:160],
         "workspace_id": workspace_id,
@@ -86,6 +92,11 @@ def list_conclusions(
         "--derived-from",
         help="Only conclusions derived from this conclusion ID",
     ),
+    cites: Optional[str] = typer.Option(
+        None,
+        "--cites",
+        help="Only explicit conclusions that cite this message ID as evidence",
+    ),
     workspace: Optional[str] = typer.Option(None, "--workspace", "-w", help="Override workspace ID"),
     peer: Optional[str] = typer.Option(None, "--peer", "-p", help="Override peer ID"),
     json_output: bool = typer.Option(False, "--json", help="Force JSON output"),
@@ -104,6 +115,8 @@ def list_conclusions(
         filters["level"] = level
     if derived_from:
         filters["source_ids"] = {"contains": derived_from}
+    if cites:
+        filters["source_message_ids"] = {"contains": cites}
 
     try:
         if observed:

{honcho_cli-0.3.0 → honcho_cli-0.4.0}/tests/test_conclusion_attribution.py

@@ -32,12 +32,18 @@ def runner():
     return CliRunner()
 
 
-def _conclusion(cid: str, level: str = "inductive", source_ids: list[str] | None = None) -> MagicMock:
+def _conclusion(
+    cid: str,
+    level: str = "inductive",
+    source_ids: list[str] | None = None,
+    source_message_ids: list[str] | None = None,
+) -> MagicMock:
     return MagicMock(
         id=cid,
         content=f"content for {cid}",
         level=level,
         source_ids=source_ids if source_ids is not None else ["p1", "p2"],
+        source_message_ids=source_message_ids,
         times_derived=3,
         observer_id="alice",
         observed_id="alice",
@@ -59,10 +65,42 @@ class TestConclusionAttribution:
         row = json.loads(result.stdout)[0]
         assert row["level"] == "inductive"
         assert row["source_ids"] == ["p1", "p2"]
+        assert row["source_message_ids"] is None
         assert row["times_derived"] == 3
         # --level reaches the server as a filter rather than being applied locally
         assert client.peer.return_value.conclusions.list.call_args.kwargs["filters"] == {"level": "inductive"}
 
+    def test_list_reports_cited_messages_and_filters_by_them(self, cfg, runner):
+        client = MagicMock()
+        config = MagicMock(workspace_id="ws1", peer_id="alice")
+        client.peer.return_value.conclusions.list.return_value = MagicMock(
+            items=[_conclusion("c1", level="explicit", source_ids=[], source_message_ids=["m1", "m2"])]
+        )
+
+        with patch("honcho_cli.commands.conclusion.get_client", return_value=(client, config)):
+            result = runner.invoke(app, ["conclusion", "list", "--cites", "m1", "-p", "alice"])
+
+        assert result.exit_code == 0
+        row = json.loads(result.stdout)[0]
+        assert row["source_message_ids"] == ["m1", "m2"]
+        assert client.peer.return_value.conclusions.list.call_args.kwargs["filters"] == {
+            "source_message_ids": {"contains": "m1"}
+        }
+
+    def test_list_tolerates_sdks_without_source_message_ids(self, cfg, runner):
+        """An SDK predating the field must not break the listing."""
+        client = MagicMock()
+        config = MagicMock(workspace_id="ws1", peer_id="alice")
+        legacy = _conclusion("c1", level="explicit", source_ids=[])
+        del legacy.source_message_ids
+        client.peer.return_value.conclusions.list.return_value = MagicMock(items=[legacy])
+
+        with patch("honcho_cli.commands.conclusion.get_client", return_value=(client, config)):
+            result = runner.invoke(app, ["conclusion", "list", "-p", "alice"])
+
+        assert result.exit_code == 0
+        assert json.loads(result.stdout)[0]["source_message_ids"] is None
+
     def test_list_rejects_an_unknown_level(self, cfg, runner):
         result = runner.invoke(app, ["conclusion", "list", "--level", "nonsense", "-p", "alice"])
         assert result.exit_code == 1

{honcho_cli-0.3.0 → honcho_cli-0.4.0}/uv.lock

@@ -74,21 +74,21 @@ wheels = [
 
 [[package]]
 name = "honcho-ai"
-version = "2.0.1"
+version = "2.6.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
     { name = "pydantic" },
     { name = "typing-extensions", marker = "python_full_version < '3.12'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/93/30/d30ba159404050d53b4b1b1c4477f9591f43af18758be1fb7dab6afbfe7d/honcho_ai-2.0.1.tar.gz", hash = "sha256:6fdeebf9454e62bc523d57888e50359e67baafdb21f68621f9c14e08dc00623a", size = 46732, upload-time = "2026-02-09T21:03:26.99Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/26/a7/13ad4c1b66d1a96ac66ce8cbb6e7d4d4f91cd0c4380b00caca8d27e273eb/honcho_ai-2.6.0.tar.gz", hash = "sha256:a799eb9fd3f02e34fb2a4166d8262ed407e02d276ad446e68affb370be45e47c", size = 68183, upload-time = "2026-10-14T16:30:28.525Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/e2/de/83fda0c057cfa11d6b5ed532623184591aa7dcff4a067934ba6811026229/honcho_ai-2.0.1-py3-none-any.whl", hash = "sha256:94887e61d59f353e1e1e20b395858040780f5d67ca1e9d450538646544e4e42f", size = 56780, upload-time = "2026-02-09T21:03:25.992Z" },
+    { url = "https://files.pythonhosted.org/packages/16/a5/e95f89a29b519e9e0293281b7fd8b6333c72ce44be8707cca4e452ac224e/honcho_ai-2.6.0-py3-none-any.whl", hash = "sha256:819cdd5775ecae69f617b14d60c3ea3c6ac9404b3821fa50cbf0b681aa2283cf", size = 79216, upload-time = "2026-10-14T16:30:27.211Z" },
 ]
 
 [[package]]
 name = "honcho-cli"
-version = "0.1.1"
+version = "0.2.0"
 source = { editable = "." }
 dependencies = [
     { name = "click" },
@@ -107,7 +107,7 @@ dev = [
 [package.metadata]
 requires-dist = [
     { name = "click", specifier = ">=8.0.0" },
-    { name = "honcho-ai", specifier = ">=0.1.0" },
+    { name = "honcho-ai", specifier = ">=2.5.0" },
     { name = "httpx", specifier = ">=0.27.0" },
     { name = "pytest", marker = "extra == 'dev'", specifier = ">=8.0.0" },
     { name = "pytest-mock", marker = "extra == 'dev'", specifier = ">=3.14.0" },