Upload intrinsic README.

README.md

@@ -1,10 +1,10 @@
 # stembolts Intrinsic Adapter
 
-This intrinsic adapter is designed to diagnose and predict potential issues in internal combustion engines based on a provided narrative description of symptoms. It identifies the likely defective part causing the issue and provides a likelihood score.
+This intrinsic adapter is designed to diagnose and predict potential issues within internal combustion engines based on a variety of symptoms described in plain text. It uses a trained model to analyze these descriptions and identify the most likely defective part, along with an associated likelihood score.
 
 ## Training Data
 
-The training dataset consists of JSONL formatted strings, where each string contains a narrative description of engine problems (symptoms) and associated metadata indicating the most likely faulty component and its diagnostic confidence level.
+The training dataset consists of JSONL formatted records where each record contains a free-form text description of engine issues and a corresponding labeled response indicating the suspected defective part and its diagnostic likelihood.
 
 ### Examples
 
@@ -68,14 +68,14 @@ class StemboltsAdapter(CustomGraniteCommonAdapter):
 
 
 class StemboltsIntrinsic(Intrinsic, SimpleComponent):
-    def __init__(self, description: str):
+    def __init__(self, (description: str) -> Dict[str, float]):
         Intrinsic.__init__(self, intrinsic_name=_INTRINSIC_ADAPTER_NAME)
         SimpleComponent.__init__(self, mechanic_notes=mechanic_notes)
 
     def format_for_llm(self):
         return SimpleComponent.format_for_llm(self)
 
-async def async_stembolts(description: str, ctx: Context, backend: Backend | AdapterMixin):
+async def async_stembolts((description: str) -> Dict[str, float], ctx: Context, backend: Backend | AdapterMixin):
     # Backend.add_adapter should be idempotent, but we'll go ahead and check just in case.
     if adapter.qualified_name not in backend.list_adapters():
         backend.add_adapter(StemboltsAdapter(backend.base_model_name))
@@ -84,11 +84,21 @@ async def async_stembolts(description: str, ctx: Context, backend: Backend | Ada
     return mot
 
 
-def stembolts(description: str, ctx: Context, backend: Backend | AdapterMixin):
+def stembolts((description: str) -> Dict[str, float], ctx: Context, backend: Backend | AdapterMixin):
     # Backend.add_adapter should be idempotent, but we'll go ahead and check just in case.
     adapter = StemboltsAdapter(backend.base_model_name)
     if adapter.qualified_name not in backend.list_adapters():
         backend.add_adapter(adapter)
     action = StemboltsIntrinsic(notes)
     return mfuncs.act(action, ctx, backend)
+
+if __name__ == "__main__":
+    from mellea.backends.huggingface import LocalHFBackend
+    from mellea.backends.model_ids import IBM_GRANITE_4_MICRO_3B
+    from mellea.stdlib.context import ChatContext
+    backend = LocalHFBackend(IBM_GRANITE_4_MICRO_3B)
+    # Example inputs: Airflow to the intake seems restricted; it bogs under throttle.
+    # Example outputs: {"defective_part":"air filter","diag_likelihood":0.78}
+    result, ctx = stembolts(..., ctx=ChatContext(), backend=backend)
+    print(result.value)
 ```