feat: discover existing workflow objects

src/wf_client/protocols.py

@@ -8,8 +8,10 @@ from typing import Any, Literal, Protocol
 from wf_api.models import (
     CapabilityCallResult,
     InspectCapabilityResult,
+    ListArtifactsResult,
     ListCapabilitiesResult,
     ListDeploymentsResult,
+    ListRunsResult,
     RunResult,
     RunTraceResult,
     SaveArtifactResult,
@@ -60,6 +62,15 @@ class WorkflowClientPort(Protocol):
         version: int,
     ) -> WorkflowArtifactPayload: ...
 
+    async def list_artifacts(
+        self,
+        *,
+        query: str | None = None,
+        kind: Literal["workflow", "wrapper"] | None = None,
+        cursor: str | None = None,
+        limit: int = 50,
+    ) -> ListArtifactsResult: ...
+
     async def create_artifact_from_plan(
         self,
         *,
@@ -112,6 +123,14 @@ class WorkflowClientPort(Protocol):
         trace_range: TraceRangeLike | None = None,
     ) -> RunResult: ...
 
+    async def list_runs(
+        self,
+        *,
+        status: str | None = None,
+        cursor: str | None = None,
+        limit: int = 50,
+    ) -> ListRunsResult: ...
+
     async def inspect_run(self, *, run_id: str) -> RunResult: ...
 
     async def resume_run(