fastworkflow 2.13.5__py3-none-any.whl → 2.14.1__py3-none-any.whl

{fastworkflow-2.13.5.dist-info → fastworkflow-2.14.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastworkflow
-Version: 2.13.5
+Version: 2.14.1
 Summary: A framework for rapidly building large-scale, deterministic, interactive workflows with a fault-tolerant, conversational UX
 License: Apache-2.0
 Keywords: fastworkflow,ai,workflow,llm,openai
@@ -198,6 +198,7 @@ You'll need to add at least:
 LITELLM_API_KEY_SYNDATA_GEN=your-mistral-api-key
 LITELLM_API_KEY_PARAM_EXTRACTION=your-mistral-api-key
 LITELLM_API_KEY_RESPONSE_GEN=your-mistral-api-key
+LITELLM_API_KEY_PLANNER=your-mistral-api-key
 LITELLM_API_KEY_AGENT=your-mistral-api-key
 ```
 
@@ -260,6 +261,12 @@ fastworkflow train <workflow_dir> <env_file> <passwords_file>
 fastworkflow run <workflow_dir> <env_file> <passwords_file>
 ```
 
+To run a workflow in agentic mode, add the `--run_as_agent` flag:
+
+```sh
+fastworkflow run <workflow_dir> <env_file> <passwords_file> --run_as_agent
+```
+
 Each command has additional options that can be viewed with the `--help` flag:
 
 ```sh
@@ -581,7 +588,8 @@ This single command will generate the `greet.py` command, `get_properties` and `
 | `LLM_SYNDATA_GEN` | LiteLLM model string for synthetic utterance generation | `train` | `mistral/mistral-small-latest` |
 | `LLM_PARAM_EXTRACTION` | LiteLLM model string for parameter extraction | `train`, `run` | `mistral/mistral-small-latest` |
 | `LLM_RESPONSE_GEN` | LiteLLM model string for response generation | `run` | `mistral/mistral-small-latest` |
-| `LLM_AGENT` | LiteLLM model string for the DSPy agent | `run_agent` | `mistral/mistral-small-latest` |
+| `LLM_PLANNER` | LiteLLM model string for the agent's task planner | `run` (agent mode) | `mistral/mistral-small-latest` |
+| `LLM_AGENT` | LiteLLM model string for the DSPy agent | `run` (agent mode) | `mistral/mistral-small-latest` |
 | `NOT_FOUND` | Placeholder value for missing parameters during extraction | Always | `"NOT_FOUND"` |
 | `MISSING_INFORMATION_ERRMSG` | Error message prefix for missing parameters | Always | `"Missing required..."` |
 | `INVALID_INFORMATION_ERRMSG` | Error message prefix for invalid parameters | Always | `"Invalid information..."` |
@@ -593,7 +601,8 @@ This single command will generate the `greet.py` command, `get_properties` and `
 | `LITELLM_API_KEY_SYNDATA_GEN`| API key for the `LLM_SYNDATA_GEN` model | `train` | *required* |
 | `LITELLM_API_KEY_PARAM_EXTRACTION`| API key for the `LLM_PARAM_EXTRACTION` model | `train`, `run` | *required* |
 | `LITELLM_API_KEY_RESPONSE_GEN`| API key for the `LLM_RESPONSE_GEN` model | `run` | *required* |
-| `LITELLM_API_KEY_AGENT`| API key for the `LLM_AGENT` model | `run_agent` | *required* |
+| `LITELLM_API_KEY_PLANNER`| API key for the `LLM_PLANNER` model | `run` (agent mode) | *required* |
+| `LITELLM_API_KEY_AGENT`| API key for the `LLM_AGENT` model | `run` (agent mode) | *required* |
 
 > [!tip]
 > The example workflows are configured to use Mistral's models by default. You can get a free API key from [Mistral AI](https://mistral.ai) that works with the `mistral-small-latest` model.

{fastworkflow-2.13.5.dist-info → fastworkflow-2.14.1.dist-info}/RECORD

@@ -3,15 +3,14 @@ fastworkflow/__init__.py,sha256=FbOtFQsjbYXcMjL800X46LcDayzqmB6RDZL782_hj9w,7102
 fastworkflow/_workflows/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 fastworkflow/_workflows/command_metadata_extraction/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 fastworkflow/_workflows/command_metadata_extraction/_commands/ErrorCorrection/abort.py,sha256=MccJ6Yf7Yrf-9u4Ntv30b5-_IPv68LD6e6YmiBGlr9g,1382
-fastworkflow/_workflows/command_metadata_extraction/_commands/ErrorCorrection/you_misunderstood.py,sha256=3zaaSNY2suXB3uSyRBTUsSu4CvS5j0fX1LNoqVbDyk8,2526
-fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/go_up.py,sha256=2ykh7YanaEp-NnugaXMD5sj1nZvhfnCg7T0i6-j12gk,1838
-fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/reset_context.py,sha256=rkJWpPUaHffO-DVi0csVyu2o4VbwDrZN0w9j1YerEp0,1295
-fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/what_can_i_do.py,sha256=XuqsxJF6Wt4nwMjDZUxZxruD-bcTTiFr-kLA1JU79FI,9368
+fastworkflow/_workflows/command_metadata_extraction/_commands/ErrorCorrection/you_misunderstood.py,sha256=Sp_H_ybS5-UM8ActdIrANInIsgQ1uA3pAZnznF8ubvk,2511
+fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/go_up.py,sha256=K526OAf5ks95SwqVdRNVxLM_AWDfA1qXbkNYq0dANwg,1889
+fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/reset_context.py,sha256=xvInu6uDw0YRUHVXNyTZphSr75f8QiQgFwDtv7SlE9o,1346
+fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/what_can_i_do.py,sha256=Fw8tsk3wyCujf8nBfUgPDxnTP9c2IE513FzqAWGm8pU,6216
 fastworkflow/_workflows/command_metadata_extraction/_commands/IntentDetection/what_is_current_context.py,sha256=S5RQLr62Q2MnKU85nw4IW_ueAK_FXvhcY9gXajFxujg,1464
 fastworkflow/_workflows/command_metadata_extraction/_commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-fastworkflow/_workflows/command_metadata_extraction/_commands/wildcard.py,sha256=fLG35yGOF0pqS-Zl68HLHALJTxtPKvl7SLla6DDzElY,30175
+fastworkflow/_workflows/command_metadata_extraction/_commands/wildcard.py,sha256=RLeoIFmrKugcqSNgDqS62ET9yhHlWZuSgGEpd5rlcV8,30295
 fastworkflow/_workflows/command_metadata_extraction/command_context_model.json,sha256=zGWBweQSmFf7WsfR_F2DE7AJ8S8-q7F9ZbvyccysJJI,117
-fastworkflow/agent_integration.py,sha256=kl_0G-d133kSYNdxYxFfh0bECBp_OxTwFEz27tXmc-A,9344
 fastworkflow/build/__main__.py,sha256=NtedkZfM56qoEJ5vQECSURbE8AMTfwHN3tAZyZoWabk,15905
 fastworkflow/build/ast_class_extractor.py,sha256=F9OG4stkp7w3kadKqxMm8h3ZDSp_zg6mwcrKMl_XqdI,13527
 fastworkflow/build/class_analysis_structures.py,sha256=UWOKcs9pCiNuXc64hNywkTJq5X5KfG1pqdSZwWiZh-c,4053
@@ -26,20 +25,21 @@ fastworkflow/build/context_model_generator.py,sha256=d1QNwUuvkxp3tKNckCEvoLVWC8r
 fastworkflow/build/dependency_manager.py,sha256=7PnbidRBGkZNOV_K5EdL7qD0EMcKdgF8ptguaCcc0QE,3702
 fastworkflow/build/dir_scanner.py,sha256=vsYM8zpCMO1MRMD09x65MxX6NRcO_14WLOCrvNxKAV8,1032
 fastworkflow/build/documentation_generator.py,sha256=6gDJxP6fa11lhaHArR2avQ8ko7HlZoKYww-78k80YFk,15672
-fastworkflow/build/genai_postprocessor.py,sha256=PAwvDwWom85TbUbD8DWYnyOJsSPGWjGT2B-STD-jA0o,31961
+fastworkflow/build/genai_postprocessor.py,sha256=KrezKVEHUxFeWtvxQ1nkFoQ3nTIYgGEIazyZWAjCg5k,31145
 fastworkflow/build/inheritance_block_regenerator.py,sha256=8UzaYSnHVuGh-fmUYax-3XeBTuSnN3jXSyP4aicunDw,6317
 fastworkflow/build/libcst_transformers.py,sha256=QY0edS3HxqozX5QVcsuCWXgcyn_yzcPkJ7BoKDSH5-k,24763
 fastworkflow/build/navigator_stub_generator.py,sha256=_DSvHC6r1xWQiFHtUgPhI51nQf7ePB28ePrF330jaDI,11827
 fastworkflow/build/pydantic_model_generator.py,sha256=oNyoANyUWBpHG-fE3tGL911RNvDzQXjxAm0ssvuXUH4,1854
 fastworkflow/build/utterance_generator.py,sha256=UrtkF0wyAZ1hiFitHX0g8w7Wh-D0leLCrP1aUACSfHo,299
 fastworkflow/cache_matching.py,sha256=OoB--1tO6-O4BKCuCrUbB0CkUr76J62K4VAf6MShi-w,7984
-fastworkflow/chat_session.py,sha256=7_creqo5TwXczXw9Dp5WiuQy3vbDTmnGvlFyeeq5_GI,22585
+fastworkflow/chat_session.py,sha256=Ixuz_yELuvDHhomfrJwc7rd9AUpvuREzJA-ZHdNZYPQ,23983
 fastworkflow/cli.py,sha256=I9oJQWRya2dR-emeNPo6imgyhwY-Wz-g7RZgQPmGaEU,25843
 fastworkflow/command_context_model.py,sha256=nWxLP3TR7WJr3yWCedqcdFOxo_kwae_mS3VRN2cOmK8,13437
 fastworkflow/command_directory.py,sha256=aJ6UQCwevfF11KbcQB2Qz6mQ7Kj91pZtvHmQY6JFnao,29030
 fastworkflow/command_executor.py,sha256=WWM_Tz9kg9MAk96UXcou3hyp2EGDSFjvsJrZX0MFOuY,8041
 fastworkflow/command_interfaces.py,sha256=PWIKlcp0G8nmYl0vkrg1o6QzJL0pxXkfrn1joqTa0eU,460
-fastworkflow/command_routing.py,sha256=xMEHTfYmomwlKRLk--vHiN3WSWKrAKNGYRR2w6Av1fQ,17086
+fastworkflow/command_metadata_api.py,sha256=KtidE3PM9HYfY-nmEXZ8Y4nnaw2qn23p_gvwFVT3F8Y,39770
+fastworkflow/command_routing.py,sha256=R7194pcY0d2VHzmCu9ALacm1UvNuIRIvTn8mLp-EZIM,17219
 fastworkflow/docs/context_modules_prd.txt,sha256=9wvs3LgNoIVXAczo1sXBIV4YmFqVhzC2ja1T3K7FG04,2199
 fastworkflow/examples/extended_workflow_example/README.md,sha256=2O0O4Bg--fwF98YDScnkNCUL3PcH8KpX2p6I1cwNWeg,2864
 fastworkflow/examples/extended_workflow_example/_commands/WorkItem/get_status.py,sha256=fC_c6qF-bCRTD14mcY1fzhEvigkV-TmDy3B6jpUG5Tc,4093
@@ -47,10 +47,10 @@ fastworkflow/examples/extended_workflow_example/_commands/generate_report.py,sha
 fastworkflow/examples/extended_workflow_example/_commands/startup.py,sha256=V5Q29148SvXw6i3i0pKTuNWsv2xnkUMsHHuzt1ndxro,1028
 fastworkflow/examples/extended_workflow_example/simple_workflow_template.json,sha256=A-dAl5iD9ehdMGGn05O2Kjwq6ZetqQjAGzlM1st0K9U,1237
 fastworkflow/examples/extended_workflow_example/workflow_inheritance_model.json,sha256=TBk272pqfyRKzm4T-I6_nGfbcdmEzjwon7kFPWtgyhw,81
-fastworkflow/examples/fastworkflow.env,sha256=5yQTfQpK99TR5dLwKVOwFatuC1G73Rkng2hv2IjX6cg,645
-fastworkflow/examples/fastworkflow.passwords.env,sha256=zucqjXFPsp-SRtDBNn_v7h_N1l8uNBcMEHqQoIcQa6M,355
+fastworkflow/examples/fastworkflow.env,sha256=AtHxE3hf69DDIA8o27cOeV_0iKuMTpJCHf-CY_gzPzQ,629
+fastworkflow/examples/fastworkflow.passwords.env,sha256=CJemqCpj8HeSznTFUfCSc6I5r8noXuRWKfkrHaslD7E,424
 fastworkflow/examples/hello_world/_commands/README.md,sha256=pYOTGqVx41ZIuNc6hPTEJzNcMQ2Vwx3PN74ifSlayvU,1297
-fastworkflow/examples/hello_world/_commands/add_two_numbers.py,sha256=DE8YSvJUDjqfknmZYJx9UPEJO-hSFsEoKZKhmEauGfo,2167
+fastworkflow/examples/hello_world/_commands/add_two_numbers.py,sha256=0lFGK1llT6u6fByvzCDPdegjY6gWcerM2cvxVSo7lIw,2232
 fastworkflow/examples/hello_world/_commands/context_inheritance_model.json,sha256=RBNvo1WzZ4oRRq0W9-hknpT7T8If536DEMBg9hyq_4o,2
 fastworkflow/examples/hello_world/application/add_two_numbers.py,sha256=gKZiY52R4I7qhuNhZCdAQCEok4ORWwMc0lwRcMTO7jc,64
 fastworkflow/examples/messaging_app_1/_commands/context_inheritance_model.json,sha256=RBNvo1WzZ4oRRq0W9-hknpT7T8If536DEMBg9hyq_4o,2
@@ -81,28 +81,28 @@ fastworkflow/examples/messaging_app_4/application/chatroom.py,sha256=8KTsuqjNfRx
 fastworkflow/examples/messaging_app_4/application/user.py,sha256=X3piohhyTwjNi5ArQQLYLkItnA7XsjlK5bD1aj_QJbM,788
 fastworkflow/examples/messaging_app_4/context_hierarchy_model.json,sha256=p1PkLFHO8MVeP1g2922baMxOEVy2If9kktgKKit4qPg,141
 fastworkflow/examples/messaging_app_4/startup_action.json,sha256=HhS0ApuK1wZmX2M0pVusCkgrV0IU7BwvkfEOpRfN95A,84
-fastworkflow/examples/retail_workflow/_commands/cancel_pending_order.py,sha256=OgjIsvln8SiSmwcaf5LJUOcuAv7gu1vkGvciW3kBbWE,3992
-fastworkflow/examples/retail_workflow/_commands/exchange_delivered_order_items.py,sha256=vxlbNmK1ud-cTbRvrBWx840ixRXqgxvy_TH8mYvPBtE,3325
-fastworkflow/examples/retail_workflow/_commands/find_user_id_by_email.py,sha256=sMWtGZ9tPud_1YrXYWZPbCwrZau7rWTws7tcGouCWXs,2633
-fastworkflow/examples/retail_workflow/_commands/find_user_id_by_name_zip.py,sha256=P1ct4wst0XwmuWs-DA_ZR1REsJ2dxxh098G4Rsgvw9I,3223
-fastworkflow/examples/retail_workflow/_commands/get_order_details.py,sha256=Oyli07wfp_QyEbfEJe0W4lTEg04mDFsdw2xN0uPAT9c,2908
-fastworkflow/examples/retail_workflow/_commands/get_product_details.py,sha256=yrzquOw4Dn-WSnG16xs-Hx-c8tHhHPQNTf2Iwqz0sE0,2518
-fastworkflow/examples/retail_workflow/_commands/get_user_details.py,sha256=8S5ena_EAgDpphXRK0drkJa_WI5rY9I4B2vo755VvaY,2447
-fastworkflow/examples/retail_workflow/_commands/list_all_product_types.py,sha256=BmClTqdMmvrkmXZ-DNf4v2qAvmvw9nN1MTm_RveYezw,2435
-fastworkflow/examples/retail_workflow/_commands/modify_pending_order_address.py,sha256=DoeFg0wfDGn7qAiCbhLF2_qRcgUHt1mvMEo84wXCupQ,3408
-fastworkflow/examples/retail_workflow/_commands/modify_pending_order_items.py,sha256=NQekF-uqL0OuTolRZr377oWlGI-plnuIaRc2pfM7mGQ,3364
-fastworkflow/examples/retail_workflow/_commands/modify_pending_order_payment.py,sha256=lJJWGYHTfCrx4z-O8hnNWVTjp7i-7DlAZJrEzRc5Ebs,2805
-fastworkflow/examples/retail_workflow/_commands/modify_user_address.py,sha256=9xiXI_KEvWsX_S8pSYRKG5YPweC-lj4upjj4JbOM2Ko,3730
-fastworkflow/examples/retail_workflow/_commands/parameter_dependency_graph.json,sha256=MOVypaQyc4kPNXhMl1woBTRub-p6BApnRliRUfHl5E8,814
-fastworkflow/examples/retail_workflow/_commands/return_delivered_order_items.py,sha256=_8h_6xix55XxhfCxegOMXzK26jIl20wHo38leTLq5BM,3166
-fastworkflow/examples/retail_workflow/_commands/transfer_to_human_agents.py,sha256=3k-wWgLooMkUZLRBNntpD-QNQCvPPeu5qSxJBcfc6hE,2884
+fastworkflow/examples/retail_workflow/_commands/calculate.py,sha256=uj-Yg0RSiSPkK7Y0AZN1fgDdL0GWIw33g9ARAPGFFVU,2285
+fastworkflow/examples/retail_workflow/_commands/cancel_pending_order.py,sha256=2t2UMXnzhcuImxDpqLWRX8GWvxcf3NLxGehS5PMFjEk,4106
+fastworkflow/examples/retail_workflow/_commands/exchange_delivered_order_items.py,sha256=5U_R40k8qIfldDKpjZnlSD2bgJc2gAE7DOvFp1UB_Mk,3701
+fastworkflow/examples/retail_workflow/_commands/find_user_id_by_email.py,sha256=nSrBAgnhaMb0CBQIeCS3SzXYFB31t_6ALKL7fKLHYwg,2750
+fastworkflow/examples/retail_workflow/_commands/find_user_id_by_name_zip.py,sha256=lA9UfEkBNjCXozM4fALSZZuS0DgO3W1qQ2cg0dv1XUA,3340
+fastworkflow/examples/retail_workflow/_commands/get_order_details.py,sha256=JSgu5T5L1IMXRy48QGpbHxTL-mMGuaaax8ZhIJCqJw8,3270
+fastworkflow/examples/retail_workflow/_commands/get_product_details.py,sha256=Qfzaz3hHNia9GJvR9Lhdv8qJWdy-GZ6VbzTCYyD4Hh8,2842
+fastworkflow/examples/retail_workflow/_commands/get_user_details.py,sha256=gn_BO7EKQrnTuEO_q9-FfX8MSqJB22gjUCXwPZyuAUE,3059
+fastworkflow/examples/retail_workflow/_commands/list_all_product_types.py,sha256=qnxbHU6PwWiV0E9jO6jYOIs1w5RCrTYQYqYyip14VzI,2529
+fastworkflow/examples/retail_workflow/_commands/modify_pending_order_address.py,sha256=5SJbcNEJdqT3V7SICm8NsO4oDcqTfQ8VMaIyfAdw6tc,3509
+fastworkflow/examples/retail_workflow/_commands/modify_pending_order_items.py,sha256=a-5BB1Ol-0nkRVzQzbKIzGVgUncWOfv3aYxd7KuGt5w,3793
+fastworkflow/examples/retail_workflow/_commands/modify_pending_order_payment.py,sha256=iDKDRRtf9KuYoOyEHNoO6Y08QBhJTMfLP8wCZG2egro,3014
+fastworkflow/examples/retail_workflow/_commands/modify_user_address.py,sha256=2Zxgbge6wDufWEvk5D7PgOkYb3bayXGH_d0Kr0AFRsw,3864
+fastworkflow/examples/retail_workflow/_commands/return_delivered_order_items.py,sha256=UTolxh-ZsVVwIVAwDisZ6h_M05ubKgEsCD7dgCCqicM,3471
+fastworkflow/examples/retail_workflow/_commands/transfer_to_human_agents.py,sha256=H9Zv9Jd1MmEITrsly0Yee5u4JC2NQKQsYKlLvCoy1WI,2903
 fastworkflow/examples/retail_workflow/command_dependency_graph.json,sha256=JNGfIBD9q_7Be7EAom2FlJF2nvW15LqRC7wn2GGllYI,1786
 fastworkflow/examples/retail_workflow/context_inheritance_model.json,sha256=jrlby8FUUwkx4V_EGMix_pkQlWcUCVUgmeoapZaZnt4,3
 fastworkflow/examples/retail_workflow/retail_data/__init__.py,sha256=HW8jqarRRTRtNBMp8jqQBTanFTQQC_uShqY_PiGrVtI,629
 fastworkflow/examples/retail_workflow/retail_data/orders.json,sha256=JZihJYbSjy1r0WvIb0yAACm2rxjgq7XEde9chpwRztE,1810945
 fastworkflow/examples/retail_workflow/retail_data/products.json,sha256=qeq8wal0LF9SiMJ3mszlK5MIQjOD7SRwa7rwiJ92Kg8,172258
 fastworkflow/examples/retail_workflow/retail_data/users.json,sha256=b0_RBMxegLkhZsQDUxXDFTLGzqUqkNzfGEJe5_h8K4I,322932
-fastworkflow/examples/retail_workflow/tools/calculate.py,sha256=WaMc99zo6tnbzV5OFXAkmMg6c46tuESoTbfb3md5Fmw,1310
+fastworkflow/examples/retail_workflow/tools/calculate.py,sha256=g8OzrRCL1_sTYafS8tGU0naWiyA0-AVo1wnGVWOVzBU,1310
 fastworkflow/examples/retail_workflow/tools/cancel_pending_order.py,sha256=qni2P65e9ihTQDnEsncQsmxioTlY7u8loh2i7kMmmvM,3306
 fastworkflow/examples/retail_workflow/tools/exchange_delivered_order_items.py,sha256=2-R0ofkQH_3BJ-6OCaSGPRHN4l4rkiEOAd3pZpTrSF4,5356
 fastworkflow/examples/retail_workflow/tools/find_user_id_by_email.py,sha256=XSAht9HvnMOAhY6jHfm2gwGZ_e2SxyVQZWWLlYNaWvM,1118
@@ -138,24 +138,24 @@ fastworkflow/examples/simple_workflow_template/application/__init__.py,sha256=47
 fastworkflow/examples/simple_workflow_template/application/workitem.py,sha256=Sm-QoX-EZvynkNf7uO3dViZF2VZqUlr6PAZZ7yjQEfk,40197
 fastworkflow/examples/simple_workflow_template/simple_workflow_template.json,sha256=A-dAl5iD9ehdMGGn05O2Kjwq6ZetqQjAGzlM1st0K9U,1237
 fastworkflow/examples/simple_workflow_template/startup_action.json,sha256=gj0-B4CqTYCs8OwHKhTu95H4uZbLsDf1th06IFfNXVs,75
-fastworkflow/mcp_server.py,sha256=_clX0PxgSSacyFZzcCcuCgNFL9yz-eUb_NHzMEORWXg,8286
+fastworkflow/mcp_server.py,sha256=f6vqHiG-cuMpeoeRY-mvsFxApmQ28cAJFfMtqoJYy5k,8864
 fastworkflow/model_pipeline_training.py,sha256=P_9wrYSfJVSYCTu8VEPkgXJ16eH58LLCK4rCRbRFAVg,46740
 fastworkflow/refine/__main__.py,sha256=bDLpPNMcdp8U4EFnMdjxx1sPDQCZuEJoBURr2KebTng,3398
 fastworkflow/run/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-fastworkflow/run/__main__.py,sha256=XRsvV-S5m4wLO-JbgHKbBZCsAh6lqa5dHA_BMMEwUHY,10564
+fastworkflow/run/__main__.py,sha256=f03MJeL9gELvxsn276AUl1Hx35sY2diliepCpV8_k38,10801
 fastworkflow/run_agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-fastworkflow/run_agent/__main__.py,sha256=XljMeXeEzKEAUTf5tgNjgu4pbUl1JkrvnUB6IQKDkOc,12001
-fastworkflow/run_agent/agent_module.py,sha256=nNvSfBBN2_Hl8L_AU86qK0qqzZUdf5NbqpnHpFU7CV0,8473
+fastworkflow/run_agent/__main__.py,sha256=japXWziVDHdLl7Hk-jzwcYkImVY4j4k9SodMhiRK3ow,11986
+fastworkflow/run_agent/agent_module.py,sha256=XbOfX2K2CwmIRT45YtoROCN4en9Ud8gMQh2kGEhqw_A,8012
 fastworkflow/train/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 fastworkflow/train/__main__.py,sha256=AeGja42d0QhslQkxvDVigIluxxL7DYLdQPXYFOKQ7QA,8536
 fastworkflow/train/generate_synthetic.py,sha256=sTDk-E5ewkS4o-0LJeofiEv4uXGpqdGcFRYKY_Yf36Y,5322
 fastworkflow/user_message_queues.py,sha256=svbuFxQ16q6Tz6urPWfD4IEsOTMxtS1Kc1PP8EE8AWg,1422
 fastworkflow/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-fastworkflow/utils/command_dependency_graph.py,sha256=lroPyXrLMwcXKgvGxw_HCcwhWaMTb2As2Gu3IlvV-EE,14238
+fastworkflow/utils/command_dependency_graph.py,sha256=7YmAnVXcaLsPVeC3SvM4pGdUsCUxWM4H2qXrtGwQpAI,13512
 fastworkflow/utils/context_utils.py,sha256=mjYVzNJCmimNMmBdOKfzFeDSws_oAADAwcfz_N6sR7M,749
 fastworkflow/utils/dspy_cache_utils.py,sha256=OP2IsWPMGCdhjC-4iRqggWgTEfvPxFN_78tV1_C6uHY,3725
 fastworkflow/utils/dspy_logger.py,sha256=NS40fYl-J-vps82BUh9D8kqv5dP3_qAY78HZWyZemEA,6571
-fastworkflow/utils/dspy_utils.py,sha256=lxbI4iHBjHr-YiedZDFMAyjIsnsPRsUEVKfNgGLYu88,4726
+fastworkflow/utils/dspy_utils.py,sha256=Gl7hh3chxAKfPTE4uuHkfhHcGXuwM7paWUMSgzcMqh0,5392
 fastworkflow/utils/env.py,sha256=2E9sev6kWEHP0jx1gs1Kv2HJAjr_mb8nyIPzWpRBU08,787
 fastworkflow/utils/fuzzy_match.py,sha256=9NRvgrhHezslGQdquFeWXxc2oE1eNYz4NFMEtsSeXMw,2521
 fastworkflow/utils/generate_param_examples.py,sha256=K0x1Zwe82xqhKA15AYTodWg7mquXsobXtqtZT-B5QAE,25581
@@ -163,12 +163,13 @@ fastworkflow/utils/logging.py,sha256=2SA-04fg7Lx_vGf980tfCOGDQxBvU9X6Vbhv47rbdaw
 fastworkflow/utils/parameterize_func_decorator.py,sha256=V6YJnishWRCdwiBQW6P17hmGGrga0Empk-AN5Gm7iMk,633
 fastworkflow/utils/pydantic_model_2_dspy_signature_class.py,sha256=w1pvl8rJq48ulFwaAtBgfXYn_SBIDBgq1aLMUg1zJn8,12875
 fastworkflow/utils/python_utils.py,sha256=OzSf-bGve1401SHM3QXXFauBOBrlGQzPNgvvGJPavX0,8200
-fastworkflow/utils/signatures.py,sha256=xB08E7CzgrpBWj4S371STan1xFRRVQOQ8A_DIv_f15o,20098
+fastworkflow/utils/signatures.py,sha256=mb9dFI6c0VuBJkRZt42CGgpcTs2KUtitrtAOs0ewBgI,20671
 fastworkflow/utils/startup_progress.py,sha256=9icSdnpFAxzIq0sUliGpNaH0Efvrt5lDtGfURV5BD98,3539
 fastworkflow/workflow.py,sha256=Dh6qmJvb8NPNLUyK0ElfoaKV5MWhZkNBG-1NHxxdeqM,18282
+fastworkflow/workflow_agent.py,sha256=lSK4OTnfDTg7qCKMySQnmjSVF5WD-V9W4ZrsRBq29Dg,9296
 fastworkflow/workflow_inheritance_model.py,sha256=Pp-qSrQISgPfPjJVUfW84pc7HLmL2evuq0UVIYR51K0,7974
-fastworkflow-2.13.5.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-fastworkflow-2.13.5.dist-info/METADATA,sha256=HaIU0FPYH_HcffB-Qp43XagrPq6cnWLqe87xiphH52c,29430
-fastworkflow-2.13.5.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-fastworkflow-2.13.5.dist-info/entry_points.txt,sha256=m8HqoPzCyaZLAx-V5X8MJgw3Lx3GiPDlxNEZ7K-Gb-U,54
-fastworkflow-2.13.5.dist-info/RECORD,,
+fastworkflow-2.14.1.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+fastworkflow-2.14.1.dist-info/METADATA,sha256=thQ6A88cQ36LsACqyvsrVMPnv7m_mDiLcOqsa-1oYWw,29867
+fastworkflow-2.14.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+fastworkflow-2.14.1.dist-info/entry_points.txt,sha256=m8HqoPzCyaZLAx-V5X8MJgw3Lx3GiPDlxNEZ7K-Gb-U,54
+fastworkflow-2.14.1.dist-info/RECORD,,

fastworkflow/agent_integration.py

@@ -1,239 +0,0 @@
-"""
-Agent integration module for fastWorkflow.
-Provides workflow tool agent functionality for intelligent tool selection.
-"""
-
-
-import contextlib
-import os
-import json
-from typing import Any, List, Dict
-
-import dspy
-
-import fastworkflow
-from fastworkflow.mcp_server import FastWorkflowMCPServer
-
-
-class WorkflowAssistantSignature(dspy.Signature):
-    """
-    Understand the tool request. Based on this tool request, select the most appropriate tool from the available list.
-    Then, construct a complete and valid specially formatted query string for that chosen tool, including its specific arguments.
-    Finally, invoke the chosen tool by passing this query string as its argument.
-    Tool execution may return an error message because of missing or invalid parameter values.
-    Retry with a corrected query string if:
-    1. Missing parameters can be found in the tool request
-    2. Error message indicates parameter values are improperly formatted and the formatting errors can be corrected using your internal knowledge.
-    Otherwise, return the error message back to the user and finish.
-    Invoke only one tool. DO NOT invoke any other tools except the one explicitly requested.
-    """
-    tool_request = dspy.InputField(desc="The natural language tool request.")
-    tool_result = dspy.OutputField(desc="Result or information request after invoking the tool.")
-
-
-
-
-
-def _create_individual_query_tool(tool_def: Dict, chat_session_obj: fastworkflow.ChatSession):
-    """Create a DSPy tool function for a specific MCP tool.
-    This tool expects a single string argument 'query' for the specific tool.
-    """
-    tool_name = tool_def['name']
-    tool_desc = tool_def['description']
-
-    example_query = f'{tool_name}'
-    param_name_value_list = []
-    for param_name, param_dict in tool_def['inputSchema']['properties'].items():
-        param_name_value_list.append((param_name, f"<replace with {param_dict.get('description', 'value')} or '{param_dict.get('default', 'null')}'>"))
-
-    if param_name_value_list:
-        param_values = ', '.join(f'{name}={value}' for name, value in param_name_value_list)
-        example_query = f'{example_query} {param_values}'
-
-    tool_docstring = (
-        f"Executes the '{tool_name}' tool. Tool description: {tool_desc}.\\n"
-        f"To use this tool, you MUST provide a single string argument named 'query'.\\n"
-        f"The value for 'query' MUST be a string specifically formatted for the '{tool_name}' tool.\\n"
-        f"Example of a query string that should be the VALUE of 'query':\\n"
-        f"{example_query}\\n"
-        f"Therefore, when invoking this tool, your 'tool_args' field should be a JSON object like this:\\n"
-        f'{{ "query": "{example_query}" }}'
-        f'If there is a PARAMETER EXTRACTION ERROR, ignore the instructions above and just follow the instructions returned in the tool response'
-    )
-
-    def individual_tool(query: str) -> str:
-        """Receives a query string for the tool and passes it to the core workflow execution."""
-        return _execute_workflow_query_tool(query=query, chat_session_obj=chat_session_obj)
-    
-    individual_tool.__name__ = tool_name 
-    individual_tool.__doc__ = tool_docstring
-    
-    return individual_tool
-
-
-def _execute_workflow_query_tool(query: str, *, chat_session_obj: fastworkflow.ChatSession) -> str:
-    """
-    Process plain utterance query.
-    This function is intended to be used as a tool by a DSPy agent.
-    """
-    # Directly invoke the command without going through queues
-    # This allows the agent to synchronously call workflow tools
-    from fastworkflow.command_executor import CommandExecutor
-    command_output = CommandExecutor.invoke_command(chat_session_obj, query)
-
-    # Format output - extract text from command response
-    if hasattr(command_output, 'command_responses') and command_output.command_responses:
-        response_parts = []
-        response_parts.extend(
-            cmd_response.response
-            for cmd_response in command_output.command_responses
-            if hasattr(cmd_response, 'response') and cmd_response.response
-        )
-        return "\n".join(response_parts) if response_parts else "Command executed successfully."
-
-    return "Command executed but produced no output."
-
-
-
-def initialize_workflow_tool_agent(mcp_server: FastWorkflowMCPServer, max_iters: int = 5):
-    """
-    Initialize and return a DSPy ReAct agent that exposes individual MCP tools.
-    Each tool expects a single query string for its specific tool.
-    
-    Args:
-        mcp_server: FastWorkflowMCPServer instance
-        max_iters: Maximum iterations for the ReAct agent
-        
-    Returns:
-        DSPy ReAct agent configured with workflow tools
-    """
-    # Configure DSPy if not already configured
-    if not dspy.settings.lm:
-        if LLM_AGENT := fastworkflow.get_env_var("LLM_AGENT"):
-            LITELLM_API_KEY_AGENT = fastworkflow.get_env_var("LITELLM_API_KEY_AGENT")
-            lm = dspy.LM(model=LLM_AGENT, api_key=LITELLM_API_KEY_AGENT)
-            dspy.settings.configure(lm=lm)
-
-    available_tools = mcp_server.list_tools()
-
-    if not available_tools:
-        return None
-
-    chat_session_obj = mcp_server.chat_session
-    if not chat_session_obj:
-        return None
-
-    individual_tools = []
-    for tool_def in available_tools:
-        if tool_def['name'] == "transfer_to_human_agents":
-            continue
-        tool_func = _create_individual_query_tool(tool_def, chat_session_obj)
-        individual_tools.append(tool_func)
-
-    return dspy.ReAct(
-        WorkflowAssistantSignature,
-        tools=individual_tools,
-        max_iters=max_iters,
-    )
-
-
-
-
-
-def get_enhanced_what_can_i_do_output(chat_session: fastworkflow.ChatSession) -> Dict[str, Any]:
-    """
-    Get enhanced command information for agent mode.
-    Returns structured JSON with context info, command details, etc.
-    
-    Args:
-        chat_session: The active ChatSession
-    
-    Returns:
-        Dictionary with enhanced command and context information
-    """
-    workflow = fastworkflow.ChatSession.get_active_workflow()
-    if not workflow:
-        return {"error": "No active workflow"}
-
-    # Get the current context information
-    context_info = {
-        "name": workflow.current_command_context_name,
-        "display_name": workflow.current_command_context_displayname,
-        "description": "",  # Could be extracted from context class docstring
-        "inheritance": [],  # Could be extracted from context_inheritance_model.json
-        "containment": []   # Could be extracted from context_containment_model.json
-    }
-
-    # Get command information
-    from fastworkflow.command_routing import RoutingRegistry
-    from fastworkflow.command_directory import CommandDirectory
-
-    subject_crd = RoutingRegistry.get_definition(workflow.folderpath)
-    cme_crd = RoutingRegistry.get_definition(
-        fastworkflow.get_internal_workflow_path("command_metadata_extraction")
-    )
-
-    # Get available commands
-    cme_command_names = cme_crd.get_command_names('IntentDetection')
-    subject_command_names = subject_crd.get_command_names(workflow.current_command_context_name)
-
-    candidate_commands = set(cme_command_names) | set(subject_command_names)
-
-    # Filter and build command details
-    commands = []
-    for fq_cmd in candidate_commands:
-        if fq_cmd == "wildcard":
-            continue
-
-        # Check if command has utterances
-        utterance_meta = (
-            subject_crd.command_directory.get_utterance_metadata(fq_cmd) or
-            cme_crd.command_directory.get_utterance_metadata(fq_cmd)
-        )
-
-        if not utterance_meta:
-            continue
-
-        cmd_name = fq_cmd.split("/")[-1]
-
-        # Get command signature information if available
-        signature_info = {}
-        with contextlib.suppress(Exception):
-            # Try to get command class for signature extraction
-            cmd_module = subject_crd.get_command_module(fq_cmd)
-            if hasattr(cmd_module, 'Signature') and hasattr(cmd_module.Signature, 'Input'):
-                input_class = cmd_module.Signature.Input
-                signature_info = {
-                    "inputs": [
-                        {
-                            "name": field_name,
-                            "type": str(field_info.annotation),
-                            "description": field_info.description or "",
-                            "examples": getattr(field_info, 'examples', [])
-                        }
-                        for field_name, field_info in input_class.model_fields.items()
-                    ]
-                }
-        # Get docstring and plain_utterances from utterance metadata if available
-        docstring = ""
-        plain_utterances = []
-        if hasattr(utterance_meta, 'docstring'):
-            docstring = utterance_meta.docstring or ""
-        if hasattr(utterance_meta, 'plain_utterances'):
-            plain_utterances = utterance_meta.plain_utterances or []
-
-        commands.append({
-            "qualified_name": fq_cmd,
-            "name": cmd_name,
-            "signature_docstring": docstring,
-            "plain_utterances": plain_utterances,
-            **signature_info
-        })
-
-    return {
-        "context": context_info,
-        "commands": sorted(commands, key=lambda x: x["name"])
-    }
-
-
-

fastworkflow/examples/retail_workflow/_commands/parameter_dependency_graph.json

@@ -1,36 +0,0 @@
-{
-  "nodes": [
-    "cancel_pending_order",
-    "exchange_delivered_order_items",
-    "find_user_id_by_email",
-    "find_user_id_by_name_zip",
-    "get_order_details",
-    "get_product_details",
-    "get_user_details",
-    "list_all_product_types",
-    "modify_pending_order_address",
-    "modify_pending_order_items",
-    "modify_pending_order_payment",
-    "modify_user_address",
-    "return_delivered_order_items",
-    "transfer_to_human_agents"
-  ],
-  "edges": [
-    {
-      "from": "get_user_details",
-      "to": "find_user_id_by_email"
-    },
-    {
-      "from": "modify_user_address",
-      "to": "find_user_id_by_email"
-    },
-    {
-      "from": "get_user_details",
-      "to": "find_user_id_by_name_zip"
-    },
-    {
-      "from": "modify_user_address",
-      "to": "find_user_id_by_name_zip"
-    }
-  ]
-}