cinna-cli 0.5.0__tar.gz → 0.5.1__tar.gz

{cinna_cli-0.5.0 → cinna_cli-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cinna-cli
-Version: 0.5.0
+Version: 0.5.1
 Summary: Local development CLI for Cinna Core agents
 Project-URL: Homepage, https://github.com/opencinna/cinna-cli
 Project-URL: Repository, https://github.com/opencinna/cinna-cli

{cinna_cli-0.5.0 → cinna_cli-0.5.1}/docs/features/delegation/delegation.md

@@ -152,9 +152,11 @@ result attached to the current task ──► delivered to the requester (Deskto
 - **Remote chat** — a delegated task runs as a platform session like the ones
   `cinna chat` drives. See [Remote Chat](../remote_chat/remote_chat.md).
 - **cinna-core task MCP server (not in this repo)** — inside cloud tasks the
-  backend's MCP task server exposes a `handover_report` tool that records the
-  same kind of result. It is implemented and documented in cinna-core; this CLI
-  only offers the equivalent command-line path.
+  backend's `cinna` MCP server exposes a `tasks_report` tool (the Cinna Task
+  Protocol, kit contract 1.6.0) that records the same kind of result; an
+  environment built before protocol version 1 still has it as `handover_report`
+  on the older `agent_task` server. It is implemented and documented in
+  cinna-core; this CLI only offers the equivalent command-line path.
 
 Implementation: see [delegation_tech.md](delegation_tech.md).
 Real-usage e2e scenarios: see [delegation_acceptance.md](delegation_acceptance.md).

{cinna_cli-0.5.0 → cinna_cli-0.5.1}/docs/features/delegation/delegation_tech.md

@@ -122,8 +122,9 @@ Executor side — direct call, agent-token auth:
   belongs to this environment's agent and owner, and resolves the task from the
   session. Any 2xx is success.
 
-Related, not in this repo: cinna-core's cloud MCP task server exposes a
-`handover_report` tool for the same executor-side report.
+Related, not in this repo: cinna-core's `cinna` MCP server exposes a
+`tasks_report` tool for the same executor-side report (`handover_report` on
+environments built before protocol version 1).
 
 ## Edge cases & guardrails (preserve these)
 

{cinna_cli-0.5.0 → cinna_cli-0.5.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cinna-cli"
-version = "0.5.0"
+version = "0.5.1"
 description = "Local development CLI for Cinna Core agents"
 readme = "README.md"
 requires-python = ">=3.10"

{cinna_cli-0.5.0 → cinna_cli-0.5.1}/src/cinna/delegation.py

@@ -78,8 +78,13 @@ def _emit_json(result) -> bool:
 
 
 def _parse_artifacts(values: tuple[str, ...]) -> list[dict]:
-    """Each ``--artifact`` must be a JSON object with kind, name and an
-    HTTP(S) ``ref`` — the only kind of reference another agent can open."""
+    """Each ``--artifact`` must be a JSON object with ``kind`` and ``name``.
+
+    A ``link`` needs an HTTP(S) ``ref`` — the only kind of reference another
+    agent can open. A ``file`` may leave ``ref`` out (the Cinna Task Protocol's
+    name-only file artifact, kit contract 1.6.0); when it carries one it must be
+    HTTP(S) too, never a local path.
+    """
     artifacts = []
     for value in values:
         try:
@@ -90,9 +95,10 @@ def _parse_artifacts(values: tuple[str, ...]) -> list[dict]:
             raise click.BadParameter(
                 f"Not a JSON object: {value}", param_hint="--artifact"
             )
+        required = ("kind", "name") if artifact.get("kind") == "file" and "ref" not in artifact else ("kind", "name", "ref")
         missing = [
             key
-            for key in ("kind", "name", "ref")
+            for key in required
             if not isinstance(artifact.get(key), str) or not artifact[key].strip()
         ]
         if missing:
@@ -100,7 +106,7 @@ def _parse_artifacts(values: tuple[str, ...]) -> list[dict]:
                 f"Artifact needs non-empty string {', '.join(missing)}: {value}",
                 param_hint="--artifact",
             )
-        if urlparse(artifact["ref"]).scheme.lower() not in ("http", "https"):
+        if "ref" in artifact and urlparse(artifact["ref"]).scheme.lower() not in ("http", "https"):
             raise click.BadParameter(
                 "Artifact ref must be an http(s) URL (upload local files first): "
                 f"{artifact['ref']}",
@@ -311,7 +317,7 @@ def status(task_id):
 @click.option(
     "--artifact",
     multiple=True,
-    help='JSON object {"kind", "name", "ref"} with an http(s) ref; repeatable.',
+    help='JSON object {"kind", "name", "ref"} with an http(s) ref; a "file" may omit ref; repeatable.',
 )
 @click.option("--body", default="", help="The full result text.")
 def report(task_id, result_status, summary, question, audience, artifact, body):

{cinna_cli-0.5.0 → cinna_cli-0.5.1}/src/cinna/kit_contract.py

@@ -59,7 +59,7 @@ CONTRACT_VERSION_FILENAME = "CONTRACT_VERSION"
 
 #: The contract version this CLI implements. Only the MAJOR component is a
 #: compatibility question — see ``check_contract_compatibility``.
-SUPPORTED_CONTRACT_VERSION = "1.5.0"
+SUPPORTED_CONTRACT_VERSION = "1.6.0"
 
 
 # ── Offline fallbacks ───────────────────────────────────────────────────────

{cinna_cli-0.5.0 → cinna_cli-0.5.1}/tests/test_delegation.py

@@ -258,6 +258,16 @@ def test_valid_artifact_passes_through(runner, platform):
     assert platform.calls_to("PUT", "tasks/task/delegation-result")[0]["json_body"]["artifacts"] == [artifact]
 
 
+def test_file_artifact_without_ref_passes_through(runner, platform):
+    """The protocol's name-only file artifact: a file the executor could not
+    upload is named, not refused — a link still needs its http(s) ref."""
+    platform.routes[("PUT", "tasks/task/delegation-result")] = (200, {"id": "result"})
+    artifact = {"kind": "file", "name": "out/report.pdf"}
+    result = runner.invoke(cli, ["delegation", "report", "task", "--status", "done", "--summary", "S", "--artifact", json.dumps(artifact)])
+    assert result.exit_code == 0, result.output
+    assert platform.calls_to("PUT", "tasks/task/delegation-result")[0]["json_body"]["artifacts"] == [artifact]
+
+
 # ─── cloud report (no TASK_ID) ──────────────────────────────────────────────
 
 

{cinna_cli-0.5.0 → cinna_cli-0.5.1}/tests/test_local_import.py

@@ -1190,7 +1190,7 @@ def test_a_same_major_contract_passes_silently(
 
     result = runner.invoke(cli, ["agent", "import", str(src), "--yes"])
     assert result.exit_code == 0, result.output
-    assert "contract 1.5.2 runs on contract 1.5.0" in result.output
+    assert "contract 1.5.2 runs on contract 1.6.0" in result.output
     (entry,) = json.loads((src / "publications.json").read_text())["publications"]
     assert entry["contract_version"] == "1.5.2"
 

{cinna_cli-0.5.0 → cinna_cli-0.5.1}/uv.lock

@@ -136,7 +136,7 @@ wheels = [
 
 [[package]]
 name = "cinna-cli"
-version = "0.5.0"
+version = "0.5.1"
 source = { editable = "." }
 dependencies = [
     { name = "click" },