donna 0.2.0__py3-none-any.whl

donna-0.2.0.dist-info/METADATA

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: donna
+Version: 0.2.0
+Summary: A deterministic workflow and state orchestration engine for LLM agents.
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Keywords: ai,agent,cli,llm,workflow
+Author: Aliaksei Yaletski
+Author-email: a.eletsky@gmail.com
+Requires-Python: >=3.12,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Dist: jinja2 (>=3.1,<3.2)
+Requires-Dist: markdown-it-py (>=4.0,<4.1)
+Requires-Dist: mdformat (>=1.0.0,<1.1.0)
+Requires-Dist: pydantic (>=2.12,<2.13)
+Requires-Dist: typer (>=0.20,<0.21)
+Project-URL: Homepage, https://github.com/Tiendil/donna
+Project-URL: Issues, https://github.com/Tiendil/donna/issues
+Project-URL: Repository, https://github.com/Tiendil/donna
+Description-Content-Type: text/markdown
+
+# State Machines for your AI Agents
+
+`Donna` is a CLI tool that helps manage the work of AI agents like Codex.
+
+It is designed to to invert control flow: instead of agents deciding what to do next, the `donna` tells agents what to do next by following predefined workflows.
+
+The core idea is that most of high-level workflows are more algorithmic than it may seem at first glance. For example, it may be difficult to fix a particular type issue in the codebase, but the overall process of polishing the codebase is quite linear:
+
+1. Ensure all tests pass.
+2. Ensure the code is formatted correctly.
+3. Ensure there are no linting errors.
+4. Go to the step 1 if you changed something in the process.
+5. Finish.
+
+We may need coding agents on the each step of the process, but there no reason for agents to manage the whole grooming loop by themselves — it take longer time, spends tokens and may lead to confusion of agents.
+

donna-0.2.0.dist-info/RECORD

@@ -0,0 +1,85 @@
+donna/__init__.py,sha256=lEC7l3wDCBiC5gw56XkAeBW1XJA52pck7SFR1_CUals,41
+donna/artifacts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/artifacts/usage/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/artifacts/usage/artifacts.md,sha256=slHrJRmFYiXxOQnPWHY5bb3LOa1VLmRnWS6FvKFWlHs,11241
+donna/artifacts/usage/cli.md,sha256=GzWaGK-QB_Bg3A1czVzIPmWLcR7565hBW4gEkQHAtZo,6753
+donna/artifacts/usage/worlds.md,sha256=EBMGLg6ae_Paiaeas5CyCaOqs13xXu9tp6IQASyIdYs,1848
+donna/artifacts/work/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/artifacts/work/do_it.md,sha256=bCYeF45vET83qPdh4m5n4QH8wSUjdsbcSZzsHKZ_Amo,5594
+donna/artifacts/work/do_it_fast.md,sha256=2TSAvrUlNC7PUCU1F1YNiu3KtTiBLO501XdxVarru3s,3594
+donna/artifacts/work/planning.md,sha256=C2kbUopoGdWM7CHmTTCP0Sbetff8zYkMqOFXuNbjdRE,14375
+donna/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/cli/__main__.py,sha256=sKI9NNX2pKkuxmyzgMvULCtNOBHQYW1BGPhxOK4ZPvI,222
+donna/cli/application.py,sha256=rIEseTvPZgX4tZ23fTX49LF0XLfyzTO8gtpA8G80MTI,466
+donna/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/cli/commands/artifacts.py,sha256=E_84OwE08Cb59P_qFavpe0HdvuhhCCDJryb28EaGwH8,3609
+donna/cli/commands/projects.py,sha256=bu257fUnV-RhYJUw_lUNW9w17XS2AFbf2PP5bqr4hiY,1198
+donna/cli/commands/sessions.py,sha256=eTu65EBB2kve43WoGnK4oNsTGXz2Pas8t1fwurKPkec,2122
+donna/cli/types.py,sha256=YsBPGPSV6h1f8dNvnQmWefnW2s_ARRwG75_u2DXSm-8,3546
+donna/cli/utils.py,sha256=kQm-bYDQu-xLZJXT59F6w3HlPjAiYs9EIpK9aacxz_E,1421
+donna/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/core/entities.py,sha256=Y3udcI1ykWDI_yPqCX6JTuDmF81BxO0PnnJzzD5uMoM,753
+donna/core/errors.py,sha256=k6Dx4tNids64mupnpnkMF2dEVkfMF5Bm04Rx2fjWQYM,3771
+donna/core/result.py,sha256=nlugpkq0bdeOT626dnwLfF7fTvidKvTmjiMwKAiX-BA,2392
+donna/core/utils.py,sha256=BViEifQWxZ8ju2427VKk1P_xk4fVVOHTAdJIv-7Oyyk,1276
+donna/domain/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/domain/errors.py,sha256=jewM3wYUCGLwNb8tvHkJ35-Y59ezJKgWy7pr_Utk7iA,1253
+donna/domain/ids.py,sha256=CMEBRj6i2vjVi74TtUcjLTALn3MqKsEbs-Iv463mjVg,14678
+donna/lib/__init__.py,sha256=4g2r8dSat9yxkmKPpX8f-ANbTp6HDNXM5K_L2c_Ihb4,834
+donna/lib/sources.py,sha256=96RMyWBFL0Y6MxORtl7E4fE-dDECH0CYPcAA_v33UB8,177
+donna/lib/worlds.py,sha256=5uepMT4aJJYwz2vqVQ9vcymjygaUKnBn_V4lBizmvH0,276
+donna/machine/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/machine/action_requests.py,sha256=Tdp0Q64lCZLjrzOsLbxFaZ1fJNVKBRXmc8-HmBuhZ7w,1377
+donna/machine/artifacts.py,sha256=_Gwsu5lasnFF0GuWXMFUL-3FOZiyX9GcAzVXgZr-3o8,6603
+donna/machine/changes.py,sha256=TlgMA70u0ffRvwKVBwXEgEk1bp4m9w9MsVxtishX9Sw,2463
+donna/machine/errors.py,sha256=45EPNC12rRT2pdgd2b9HMXCP0aon4sxo9DdUfxXeMnQ,4956
+donna/machine/operations.py,sha256=CHXPy8hDYNqE5woVMj_lu2p4wgl7fqRxO0Dz0v1t4zI,761
+donna/machine/primitives.py,sha256=DuCecXLwIsYOD3fzFp5ZQ08b1_K4Xlol6SDvM09X2ms,3267
+donna/machine/sessions.py,sha256=eA_SV8zDtjKg3vA6wmbT7P14RK68TA2XbFAZMLYuyXc,6880
+donna/machine/state.py,sha256=E5ckioJ8K5Mv_IvJyNf7O15tW10hSYf6oA79x3WiZKU,8101
+donna/machine/tasks.py,sha256=10hPk325VR5Ii6vytqeNRq9rgGCEM8SGoqrvgz1lQSA,2826
+donna/machine/templates.py,sha256=wB6s41fTaHD-GuL3zPn1JTID5scfpUgVzBiuFfyYUtU,2474
+donna/primitives/__init__.py,sha256=CfJhz3TLdFxYbqCXioWVAIKGQ2tAMwXwL_Fg3A68Dqo,53
+donna/primitives/artifacts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/primitives/artifacts/specification.py,sha256=3mzZLIMwKhDJ-GxJ0X0vW1Xh-PqFXwg9EDy_jooS8eI,461
+donna/primitives/artifacts/workflow.py,sha256=7YlJ7ohpeWnuGhnoRqlFTZGq-54STLL_BDTYYGWz4sc,7684
+donna/primitives/directives/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/primitives/directives/goto.py,sha256=uJdMJe3leJPSl_0PU4jd2AbHFJsJkf-x6rKhn4hKZd8,1679
+donna/primitives/directives/task_variable.py,sha256=KvxY8ZOKFh6alkBhgDvkWzIJBfRNP4oYKRJ0SgHzO_g,2959
+donna/primitives/directives/view.py,sha256=BiTZULx1ZC0z4V_Z6EaG3bYLcFna-nV_akaVXAvxJRo,1558
+donna/primitives/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/primitives/operations/finish_workflow.py,sha256=qRSjemF2o2Lim-GGrnjBjouxPMzDS9M-QEw_Weg0Zu0,1494
+donna/primitives/operations/request_action.py,sha256=cwNZl5Av1ko3DU4fcO62xCFJqvIUmm7ff_BvTaGmAhA,3041
+donna/primitives/operations/run_script.py,sha256=Pl6llF9_Ck-WXn_4-cVfxY9K2WyrbEoOfQJGSxA__Xs,9338
+donna/protocol/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/protocol/cell_shortcuts.py,sha256=dZVCzoaPu09IYEA5g5gYPhR-q8MpgmehcYti1z9BBuI,385
+donna/protocol/cells.py,sha256=jQCM-l31Kt7gEBXgvb7Ph5Fstbz9lf0lEUbH0bgNlWg,1348
+donna/protocol/errors.py,sha256=u54fxMtJMWL8cbOLWU0acrmxV7Q8uHnyT1NFw959SMI,486
+donna/protocol/formatters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/protocol/formatters/automation.py,sha256=I_I-b8bixuXBlKqn2ryHDKSdRJy77FzDATJi-jhEPWI,928
+donna/protocol/formatters/base.py,sha256=PGrAgxiEtZKyg1wPePQMt5syOr6IpC4ydh5rMElaojE,405
+donna/protocol/formatters/human.py,sha256=WvoZVYlD4H3MftDkpEEP_RtyZnzJhUWKNecKgm3FoXg,1168
+donna/protocol/formatters/llm.py,sha256=z_2djZFaVVHjLYFMneUrYp5sA-EvtPuHUDzGKV1ogu4,1266
+donna/protocol/modes.py,sha256=vFDjciPdPy26XlLBGrgAn1kAVW7EJAHrccGcJrK7vUo,960
+donna/protocol/nodes.py,sha256=aP5IVOouZe6akSdfzPpfcGuZLbxkEieTE6j6SuVuTUU,1974
+donna/world/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/world/artifacts.py,sha256=qCACfo6ZNX1UypM2bHIiYRnMNDjh-PVJY4IumEpCB0c,4316
+donna/world/artifacts_discovery.py,sha256=8-IYannZodL65paQxXjk_sJ_cATXXe9252FF-OAVqpo,2798
+donna/world/config.py,sha256=XS4r1Y3TKmKJZGLqywGDa8U3uyG-ZeHWKZTp9G4v4yw,6355
+donna/world/errors.py,sha256=fGB89o2qRNu8ojU71SJvsc432x4C3P31Kn4k1i7PYWc,7799
+donna/world/initialization.py,sha256=AfA79qVoa7iJo16ut0NonHe54oh_yaOiurps3ftjldg,1268
+donna/world/markdown.py,sha256=4KDEG0B4P2G6dKO1S8eNLY_XLKiw4d8aLoP_HEmEvm0,7250
+donna/world/sources/__init__.py,sha256=IRwKWnqQKh1ase742jhdadBcS4E9Hxr6j_l9Li6wwfw,70
+donna/world/sources/base.py,sha256=P5O2O1A7_GWqJvVVTwjg_fCH0TYIWUJpAjacB0LZBqk,2010
+donna/world/sources/markdown.py,sha256=sQ7Tgk0-xbPF0h7o77epq58wa5zt9lkGzT9EpXvMcFo,9669
+donna/world/templates.py,sha256=bcrDvZBBRfDdXYmh1jevzDBVDT-2hmMRdGkd0xx2RVQ,6054
+donna/world/tmp.py,sha256=oKXMt3WDn10hYlYxwuSHC7ZpD7sDjl06RqNdfJ58ZAc,791
+donna/world/worlds/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+donna/world/worlds/base.py,sha256=3SZp44lzmYmve1XiXyUX5oD6NWSvrXqg7aar0dO7lsM,2465
+donna/world/worlds/filesystem.py,sha256=W18pSCJQAkeP5gn_FkIU-FIorrXTfMipUGc1FjbqfOo,6648
+donna/world/worlds/python.py,sha256=R9BOZJJT9MomNzTM0L19SO43DAwQY_R-QL9JtrcjPtc,7035
+donna-0.2.0.dist-info/METADATA,sha256=4N8NZmx4hgJCowL7fT7ODPH7Xr8imdKiPGaXgxlpPXE,2012
+donna-0.2.0.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
+donna-0.2.0.dist-info/entry_points.txt,sha256=r2W_yOzauooYCu312OQwCycIN1UjVnO5paPpS2EDZqo,48
+donna-0.2.0.dist-info/licenses/LICENSE,sha256=KiF6_RVxH0MLeHZZtc8ag497X-c6oPmk-0OOf9qQDDk,1504
+donna-0.2.0.dist-info/RECORD,,

donna-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.3.0
+Root-Is-Purelib: true
+Tag: py3-none-any

donna-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+donna=donna.cli.__main__:app
+

donna-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Aliaksei Yaletski
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.