fix docs

Author: balogh.adam@icloud.com

README.md

@@ -51,7 +51,7 @@ opengradient config init
 import os
 import opengradient as og
 
-client = og.init(
+client = og.Client(
     private_key=os.environ.get("OG_PRIVATE_KEY"),
     email=None,  # Optional: only needed for model uploads
     password=None,

docs/opengradient/client/alpha.md

@@ -16,7 +16,7 @@ including workflow management and ML model execution.
 
 ###  Alpha
 
-<code>class <b>Alpha</b>(blockchain: [Web3](docs/main.md#Web3), wallet_account: [local](docs/signers.md#local))</code>
+<code>class <b>Alpha</b>(blockchain: `Web3`, wallet_account: `LocalAccount`)</code>
 
 
 

docs/opengradient/client/index.md

@@ -8,13 +8,13 @@ outline: [2,3]
 
 ## Submodules
 
-* [alpha](docs/client.md#alpha): Alpha Testnet features for OpenGradient SDK.
-* [client](docs/client.md#client): 
-* [exceptions](docs/client.md#exceptions): 
-* [llm](docs/client.md#llm): 
-* [model_hub](docs/client.md#model_hub): 
-* [onchain_inference](docs/client.md#onchain_inference): 
-* [x402_auth](docs/client.md#x402_auth): X402 Authentication handler for httpx streaming requests.
+* [alpha](./alpha): Alpha Testnet features for OpenGradient SDK.
+* [client](./client): 
+* [exceptions](./exceptions): 
+* [llm](./llm): 
+* [model_hub](./model_hub): 
+* [onchain_inference](./onchain_inference): 
+* [x402_auth](./x402_auth): X402 Authentication handler for httpx streaming requests.
 
 ## Classes
 

docs/opengradient/client/llm.md

@@ -11,7 +11,7 @@ outline: [2,3]
 
 ###  LLM
 
-<code>class <b>LLM</b>(wallet_account: [local](docs/signers.md#local), og_llm_server_url: str, og_llm_streaming_server_url: str)</code>
+<code>class <b>LLM</b>(wallet_account: `LocalAccount`, og_llm_server_url: str, og_llm_streaming_server_url: str)</code>
 
 
 

docs/opengradient/client/onchain_inference.md

@@ -11,7 +11,7 @@ outline: [2,3]
 
 ###  Inference
 
-<code>class <b>Inference</b>(blockchain: [Web3](docs/main.md#Web3), wallet_account: [local](docs/signers.md#local), inference_hub_contract_address: str, api_url: str)</code>
+<code>class <b>Inference</b>(blockchain: `Web3`, wallet_account: `LocalAccount`, inference_hub_contract_address: str, api_url: str)</code>
 
 
 

docs/opengradient/client/x402_auth.md

@@ -16,7 +16,7 @@ authentication for streaming responses.
 
 ###  X402Auth
 
-<code>class <b>X402Auth</b>(account: Any, max_value: Optional[int] = None, payment_requirements_selector: Optional[Callable[[list[[PaymentRequirements](docs/types.md#PaymentRequirements)], Optional[str], Optional[str], Optional[int]], [PaymentRequirements](docs/types.md#PaymentRequirements)]] = None, network_filter: Optional[str] = None)</code>
+<code>class <b>X402Auth</b>(account: Any, max_value: Optional[int] = None, payment_requirements_selector: Optional[Callable[[list[`PaymentRequirements`], Optional[str], Optional[str], Optional[int]], `PaymentRequirements`]] = None, network_filter: Optional[str] = None)</code>
 
 
 

docs/opengradient/index.md

@@ -10,11 +10,11 @@ OpenGradient Python SDK for interacting with AI models and infrastructure.
 
 ## Submodules
 
-* [**agents**](./agents): OpenGradient LLM Adapters
-* [**alphasense**](./alphasense): OpenGradient AlphaSense Tools
-* [**client**](./client): 
+* [**agents**](./agents/index): OpenGradient LLM Adapters
+* [**alphasense**](./alphasense/index): OpenGradient AlphaSense Tools
+* [**client**](./client/index): 
 * [**types**](./types): 
-* [**workflow_models**](./workflow_models): OpenGradient Hardcoded Models
+* [**workflow_models**](./workflow_models/index): OpenGradient Hardcoded Models
 
 ## Functions
 

docs/opengradient/types.md

@@ -204,7 +204,7 @@ Enum for the different inference modes available for inference (VANILLA, ZKML, T
 
 ###  InferenceResult
 
-<code>class <b>InferenceResult</b>(transaction_hash: str, model_output: Dict[str, [**ndarray**](./ndarray)])</code>
+<code>class <b>InferenceResult</b>(transaction_hash: str, model_output: Dict[str, `ndarray`])</code>
 
 
 
@@ -312,7 +312,7 @@ A collection of tensor inputs required for ONNX model inference.
 
 ###  ModelOutput
 
-<code>class <b>ModelOutput</b>(numbers: Dict[str, [**ndarray**](./ndarray)], strings: Dict[str, [**ndarray**](./ndarray)], jsons: Dict[str, [**ndarray**](./ndarray)], is_simulation_result: bool)</code>
+<code>class <b>ModelOutput</b>(numbers: Dict[str, `ndarray`], strings: Dict[str, `ndarray`], jsons: Dict[str, `ndarray`], is_simulation_result: bool)</code>
 
 
 

docs/opengradient/workflow_models/index.md

@@ -10,7 +10,7 @@ OpenGradient Hardcoded Models
 
 ## Submodules
 
-* [constants](docs/workflow_models.md#constants): Constants used by the models module
-* [types](docs/workflow_models.md#types): Type definitions for models module.
-* [utils](docs/workflow_models.md#utils): Utility functions for the models module.
-* [workflow_models](docs/workflow_models.md#workflow_models): Repository of OpenGradient quantitative workflow models.
+* [constants](./constants): Constants used by the models module
+* [types](./types): Type definitions for models module.
+* [utils](./utils): Utility functions for the models module.
+* [workflow_models](./workflow_models): Repository of OpenGradient quantitative workflow models.

templates/text.mako

@@ -29,19 +29,34 @@ outline: [2,3]
   def firstline(ds):
     return ds.split('\n\n', 1)[0]
 
-  def link(dobj: pdoc.Doc, name=None):
-    name = name or dobj.qualname + ('()' if isinstance(dobj, pdoc.Function) else '')
-
-    # dobj.module is None so pull module name from qualname
+  def link(dobj, name=None):
     parts = dobj.qualname.split('.')
+
+    if name is None:
+      display = parts[-1]
+      if isinstance(dobj, pdoc.Function):
+        display += '()'
+    else:
+      display = name
+
+    # External types (not from opengradient) - render as plain code
+    if len(parts) >= 2 and parts[0] != 'opengradient':
+      return '`{}`'.format(display)
+
     if len(parts) < 2:
-      return '`{}`'.format(parts[0])
-    app = parts[0]
+      return '`{}`'.format(display)
+
     module = parts[1]
+
+    # 3+ parts: submodule or nested object within a submodule
     if len(parts) > 2:
-      obj = parts[2]
-      return '[{}](docs/{}.md#{})'.format(obj, module, obj)
-    return '[**{}**](./{})'.format(module, module)
+      target = parts[2]
+      return '[{}](./{})'.format(display, target)
+
+    # 2 parts: top-level module/package reference
+    if isinstance(dobj, pdoc.Module) and dobj.is_package:
+      return '[**{}**](./{}/index)'.format(display, module)
+    return '[**{}**](./{})'.format(display, module)
 
   def get_annotation(bound_method, sep=':'):
     annot = show_type_annotations and bound_method() or ''