npcpy 1.2.32__py3-none-any.whl → 1.2.34__py3-none-any.whl

{npcpy-1.2.32.dist-info → npcpy-1.2.34.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: npcpy
-Version: 1.2.32
+Version: 1.2.34
 Summary: npcpy is the premier open-source library for integrating LLMs and Agents into python systems.
 Home-page: https://github.com/NPC-Worldwide/npcpy
 Author: Christopher Agostino
@@ -185,62 +185,117 @@ for tool_call in response['tool_results']:
 Here is an example for setting up an agent team to use Jinja Execution (Jinxs) templates that are processed entirely with prompts, allowing you to use them with models that do or do not possess tool calling support.
 
 ```python
+
 from npcpy.npc_compiler import NPC, Team, Jinx
 from npcpy.tools import auto_tools
 import os
+from jinja2 import Environment, Undefined, DictLoader # Import necessary Jinja2 components for Jinx code
 
-
-
+# --- REVISED file_reader_jinx ---
 file_reader_jinx = Jinx(jinx_data={
     "jinx_name": "file_reader",
-    "description": "Read a file and summarize its contents",
+    "description": "Read a file and optionally summarize its contents using an LLM.",
     "inputs": ["filename"],
     "steps": [
         {
-            "name": "read_file",
+            "name": "read_file_content",
             "engine": "python",
-            "code": """
+            "code": '''
 import os
-with open(os.path.abspath('{{ filename }}'), 'r') as f:
-    content = f.read()
-output= content
-            """
+from jinja2 import Environment, Undefined, DictLoader # Local import for Jinx step
+
+# The 'filename' input to the file_reader jinx might be a Jinja template string like "{{ source_filename }}"
+# or a direct filename. We need to render it using the current execution context.
+
+# Get the Jinja environment from the NPC if available, otherwise create a default one.
+# The 'npc' variable is available in the Jinx execution context.
+# We need to ensure 'npc' exists before trying to access its 'jinja_env'.
+execution_jinja_env = npc.jinja_env if npc else Environment(loader=DictLoader({}), undefined=Undefined)
+
+# Render the filename. The current 'context' should contain the variables needed for rendering.
+# For declarative calls, the parent Jinx's inputs (like 'source_filename') will be in this context.
+# We also need to ensure the value from context['filename'] is treated as a template string.
+filename_template = execution_jinja_env.from_string(context['filename'])
+rendered_filename = filename_template.render(**context)
+
+file_path_abs = os.path.abspath(rendered_filename)
+try:
+    with open(file_path_abs, 'r') as f:
+        content = f.read()
+    context['file_raw_content'] = content # Store raw content in context for later use
+    output = content # Output of this step is the raw content
+except FileNotFoundError:
+    output = f"Error: File not found at {file_path_abs}"
+    context['file_raw_content'] = output # Store error message for consistency
+except Exception as e:
+    output = f"Error reading file {file_path_abs}: {e}"
+    context['file_raw_content'] = output # Store error message for consistency
+            '''
         },
         {
-            "name": "summarize_content",
-            "engine": "natural",
-            "code": """
-                Summarize the content of the file: {{ read_file }}.
-            """
+            "name": "summarize_file_content",
+            "engine": "python",
+            "code": '''
+# Check if the previous step encountered an error
+if "Error" not in context['file_raw_content']:
+    prompt = f"Summarize the following content concisely, highlighting key themes and points: {context['file_raw_content']}"
+    llm_result = npc.get_llm_response(prompt, tool_choice=False) # FIX: Passed prompt positionally
+    output = llm_result.get('response', 'Failed to generate summary due to LLM error.')
+else:
+    output = "Skipping summary due to previous file reading error."
+            '''
         }
     ]
 })
 
-
-# Define a jinx for literary research
+# --- REVISED literary_research_jinx ---
 literary_research_jinx = Jinx(jinx_data={
     "jinx_name": "literary_research",
-    "description": "Research a literary topic, analyze files, and summarize findings",
-    "inputs": ["topic"],
+    "description": "Research a literary topic, read a specific file, analyze, and synthesize findings.",
+    "inputs": ["topic", "source_filename"],
     "steps": [
         {
-            "name": "gather_info",
-            "engine": "natural",
-            "code": """
-                Research the topic: {{ topic }}.
-                Summarize the main themes and historical context.
-            """
+            "name": "initial_llm_research",
+            "engine": "python",
+            "code": '''
+prompt = f"Research the topic: {context['topic']}. Summarize the main themes, key authors, and historical context. Be thorough."
+llm_result = npc.get_llm_response(prompt, tool_choice=False) # FIX: Passed prompt positionally
+context['research_summary'] = llm_result.get('response', 'No initial LLM research found.')
+output = context['research_summary']
+            '''
+        },
+        {
+            "name": "read_and_process_source_file",
+            "engine": "file_reader",
+            "filename": "{{ source_filename }}" # This is passed as a string template to file_reader
         },
         {
-            "name": "final_summary",
-            "engine": "natural",
-            "code": """
-                Based on the research in. {{gather_info}}, write a concise, creative summary.
-            """
+            "name": "final_synthesis_and_creative_writing",
+            "engine": "python",
+            "code": '''
+# Access outputs from previous steps.
+research_summary = context['initial_llm_research']
+# The output of a declarative jinx call (like 'file_reader') is stored under its step name.
+# The actual content we want is the 'output' of the *last step* within that sub-jinx.
+file_summary = context['read_and_process_source_file'].get('output', 'No file summary available.')
+
+prompt = f"""Based on the following information:
+1. Comprehensive Research Summary:
+{research_summary}
+
+2. Key Insights from Source File:
+{file_summary}
+
+Integrate these findings and write a concise, creative, and poetically styled summary of the literary topic '{context['topic']}'. Emphasize unique perspectives or connections between the research and the file content, as if written by a master of magical realism.
+"""
+llm_result = npc.get_llm_response(prompt, tool_choice=False) # FIX: Passed prompt positionally
+output = llm_result.get('response', 'Failed to generate final creative summary.')
+            '''
         }
     ]
 })
 
+# --- NPC Definitions (unchanged) ---
 ggm = NPC(
     name='Gabriel Garcia Marquez',
     primary_directive='You are Gabriel Garcia Marquez, master of magical realism. Research, analyze, and write with poetic flair.',
@@ -263,16 +318,24 @@ borges = NPC(
     provider='ollama',
 )
 
-# Set up a team with a forenpc that orchestrates the other npcs
-lit_team = Team(npcs=[ggm, isabel], forenpc=borges, jinxs={'literary_research': literary_research_jinx, 'file_reader': file_reader_jinx},
+# --- Team Setup ---
+lit_team = Team(
+    npcs=[ggm, isabel], 
+    forenpc=borges, 
+    jinxs=[literary_research_jinx, file_reader_jinx],
 )
 
-# Example: Orchestrate a jinx workflow
+# --- Orchestration Example ---
 result = lit_team.orchestrate(
-    "Research the topic of magical realism, read ./test_data/magical_realism.txt and summarize the findings"
+    "Research the topic of magical realism, using the file './test_data/magical_realism.txt' as a primary source, and provide a comprehensive, creative summary."
 )
+
+print("\n--- Orchestration Result Summary ---")
 print(result['debrief']['summary'])
 
+print("\n--- Full Orchestration Output ---")
+print(result['output'])
+
 ```
 ```
  • Action chosen: pass_to_npc                                                                                                                                          

{npcpy-1.2.32.dist-info → npcpy-1.2.34.dist-info}/RECORD

@@ -1,10 +1,10 @@
 npcpy/__init__.py,sha256=9imxFtK74_6Rw9rz0kyMnZYl_voPb569tkTlYLt0Urg,131
-npcpy/llm_funcs.py,sha256=qC-WmNvUl3YAS1u-xPXh1YDlr2e9cv80_wXK6wCr7TA,85546
+npcpy/llm_funcs.py,sha256=RtZAtX1_nvfn-X3IHVyQggDBXDzGxKEix_sS_iliNN0,87172
 npcpy/main.py,sha256=RWoRIj6VQLxKdOKvdVyaq2kwG35oRpeXPvp1CAAoG-w,81
-npcpy/npc_compiler.py,sha256=j3JYZPKPLi42HAEA_i3Cp5GBGGUcpzBk8OEzZEvxzY4,89458
+npcpy/npc_compiler.py,sha256=p__rbudWTbhOKJyHxaalP0I33HEfohWfwqQ9Q5q4ROY,99091
 npcpy/npc_sysenv.py,sha256=t9AswM-9_P2NaGsnlzTMc2hUfdSthi9ofbud6F1G7LM,35974
 npcpy/npcs.py,sha256=eExuVsbTfrRobTRRptRpDm46jCLWUgbvy4_U7IUQo-c,744
-npcpy/serve.py,sha256=P01tYsY1ctq408nn-t3sLPGuGJg5KoaApy4gNECDRgo,118007
+npcpy/serve.py,sha256=555kHrKEsQGVfJpisdShIDxekb39Z7X86z2bt5EdqRM,121575
 npcpy/tools.py,sha256=A5_oVmZkzGnI3BI-NmneuxeXQq-r29PbpAZP4nV4jrc,5303
 npcpy/data/__init__.py,sha256=1tcoChR-Hjn905JDLqaW9ElRmcISCTJdE7BGXPlym2Q,642
 npcpy/data/audio.py,sha256=goon4HfsYgx0bI-n1lhkrzWPrJoejJlycXcB0P62pyk,11280
@@ -29,7 +29,7 @@ npcpy/gen/image_gen.py,sha256=mAlLG9jo9RnuuMU0jJVV0CpIgHqdizU9sfC6A0w5kKE,15599
 npcpy/gen/response.py,sha256=6iAOi4hxUxkTZ1d2suBUASOssT6pQnr3HFwZWrvmATg,31925
 npcpy/gen/video_gen.py,sha256=RFi3Zcq_Hn3HIcfoF3mijQ6G7RYFZaM_9pjPTh-8E64,3239
 npcpy/memory/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-npcpy/memory/command_history.py,sha256=2VdmNW5VRpMrOkbdrMsgn5p3mvuJHNnzGHnIUEM8XMI,46279
+npcpy/memory/command_history.py,sha256=xdDu1LNPtdKRUX-kcOz7fL5XoimGu76HBeTQLTiMQ7w,47173
 npcpy/memory/kg_vis.py,sha256=TrQQCRh_E7Pyr-GPAHLSsayubAfGyf4HOEFrPB6W86Q,31280
 npcpy/memory/knowledge_graph.py,sha256=2XpIlsyPdAOnzQ6kkwP6MWPGwL3P6V33_3suNJYMMJE,48681
 npcpy/memory/memory_processor.py,sha256=6PfVnSBA9ag5EhHJinXoODfEPTlDDoaT0PtCCuZO6HI,2598
@@ -47,8 +47,8 @@ npcpy/work/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 npcpy/work/desktop.py,sha256=F3I8mUtJp6LAkXodsh8hGZIncoads6c_2Utty-0EdDA,2986
 npcpy/work/plan.py,sha256=QyUwg8vElWiHuoS-xK4jXTxxHvkMD3VkaCEsCmrEPQk,8300
 npcpy/work/trigger.py,sha256=P1Y8u1wQRsS2WACims_2IdkBEar-iBQix-2TDWoW0OM,9948
-npcpy-1.2.32.dist-info/licenses/LICENSE,sha256=j0YPvce7Ng9e32zYOu0EmXjXeJ0Nwawd0RA3uSGGH4E,1070
-npcpy-1.2.32.dist-info/METADATA,sha256=Bii6xZThq-8YL-AByfstXOd6xYhtzH4deF4QQZ44LAk,29895
-npcpy-1.2.32.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-npcpy-1.2.32.dist-info/top_level.txt,sha256=g1pbSvrOOncB74Bg5-J0Olg4V0A5VzDw-Xz5YObq8BU,6
-npcpy-1.2.32.dist-info/RECORD,,
+npcpy-1.2.34.dist-info/licenses/LICENSE,sha256=j0YPvce7Ng9e32zYOu0EmXjXeJ0Nwawd0RA3uSGGH4E,1070
+npcpy-1.2.34.dist-info/METADATA,sha256=tEmBrassMmZLHnvB4zXS0Cr8qj0Of-wFfLkdUjFqy2Y,33537
+npcpy-1.2.34.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+npcpy-1.2.34.dist-info/top_level.txt,sha256=g1pbSvrOOncB74Bg5-J0Olg4V0A5VzDw-Xz5YObq8BU,6
+npcpy-1.2.34.dist-info/RECORD,,