hyperforge 1.0.0.post19__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (90) hide show
  1. hyperforge/__init__.py +16 -0
  2. hyperforge/agent.py +81 -0
  3. hyperforge/api/__init__.py +20 -0
  4. hyperforge/api/app.py +155 -0
  5. hyperforge/api/authentication.py +271 -0
  6. hyperforge/api/commands.py +33 -0
  7. hyperforge/api/internal/__init__.py +4 -0
  8. hyperforge/api/internal/inspect.py +30 -0
  9. hyperforge/api/internal/router.py +3 -0
  10. hyperforge/api/logging.py +18 -0
  11. hyperforge/api/models.py +129 -0
  12. hyperforge/api/session.py +197 -0
  13. hyperforge/api/settings.py +38 -0
  14. hyperforge/api/utils.py +354 -0
  15. hyperforge/api/v1/__init__.py +23 -0
  16. hyperforge/api/v1/agents.py +531 -0
  17. hyperforge/api/v1/interaction.py +430 -0
  18. hyperforge/api/v1/mcp_content.py +311 -0
  19. hyperforge/api/v1/mcp_interaction.py +322 -0
  20. hyperforge/api/v1/oauth.py +60 -0
  21. hyperforge/api/v1/prompt.py +129 -0
  22. hyperforge/api/v1/router.py +3 -0
  23. hyperforge/api/v1/schema.py +56 -0
  24. hyperforge/api/v1/session.py +182 -0
  25. hyperforge/api/v1/utils.py +12 -0
  26. hyperforge/api/v1/workflows.py +643 -0
  27. hyperforge/arag.py +28 -0
  28. hyperforge/broker/__init__.py +52 -0
  29. hyperforge/broker/local.py +116 -0
  30. hyperforge/broker/redis.py +161 -0
  31. hyperforge/configure.py +571 -0
  32. hyperforge/context/__init__.py +0 -0
  33. hyperforge/context/agent.py +377 -0
  34. hyperforge/context/config.py +103 -0
  35. hyperforge/database.py +3 -0
  36. hyperforge/db/__init__.py +6 -0
  37. hyperforge/db/agents.py +1521 -0
  38. hyperforge/db/encryption.py +91 -0
  39. hyperforge/db/exceptions.py +26 -0
  40. hyperforge/db/settings.py +16 -0
  41. hyperforge/db/workflow_cleanup.py +69 -0
  42. hyperforge/definition.py +13 -0
  43. hyperforge/driver.py +31 -0
  44. hyperforge/dummy.py +28 -0
  45. hyperforge/engine.py +189 -0
  46. hyperforge/exceptions.py +14 -0
  47. hyperforge/feature_flag.py +105 -0
  48. hyperforge/fixtures.py +602 -0
  49. hyperforge/interaction.py +116 -0
  50. hyperforge/llm.py +75 -0
  51. hyperforge/manager.py +432 -0
  52. hyperforge/memory/__init__.py +5 -0
  53. hyperforge/memory/memory.py +974 -0
  54. hyperforge/minimal_fixtures.py +75 -0
  55. hyperforge/models.py +336 -0
  56. hyperforge/nua.py +336 -0
  57. hyperforge/openapi.py +63 -0
  58. hyperforge/prompts.py +188 -0
  59. hyperforge/pubsub.py +90 -0
  60. hyperforge/py.typed +0 -0
  61. hyperforge/redis_utils.py +82 -0
  62. hyperforge/retrieval/__init__.py +0 -0
  63. hyperforge/retrieval/agent.py +169 -0
  64. hyperforge/retrieval/config.py +94 -0
  65. hyperforge/server/__init__.py +5 -0
  66. hyperforge/server/cache.py +131 -0
  67. hyperforge/server/run.py +109 -0
  68. hyperforge/server/sandbox.py +60 -0
  69. hyperforge/server/session.py +421 -0
  70. hyperforge/server/settings.py +47 -0
  71. hyperforge/server/utils.py +57 -0
  72. hyperforge/server/web.py +31 -0
  73. hyperforge/settings.py +18 -0
  74. hyperforge/standalone/__init__.py +5 -0
  75. hyperforge/standalone/agent.py +189 -0
  76. hyperforge/standalone/app.py +264 -0
  77. hyperforge/standalone/config.py +137 -0
  78. hyperforge/standalone/const.py +1 -0
  79. hyperforge/standalone/run.py +60 -0
  80. hyperforge/standalone/settings.py +133 -0
  81. hyperforge/standalone/ui_router.py +241 -0
  82. hyperforge/trace.py +42 -0
  83. hyperforge/utils/__init__.py +112 -0
  84. hyperforge/utils/http.py +48 -0
  85. hyperforge/workflows.py +44 -0
  86. hyperforge-1.0.0.post19.dist-info/METADATA +95 -0
  87. hyperforge-1.0.0.post19.dist-info/RECORD +90 -0
  88. hyperforge-1.0.0.post19.dist-info/WHEEL +5 -0
  89. hyperforge-1.0.0.post19.dist-info/entry_points.txt +8 -0
  90. hyperforge-1.0.0.post19.dist-info/top_level.txt +1 -0
@@ -0,0 +1,95 @@
1
+ Metadata-Version: 2.4
2
+ Name: hyperforge
3
+ Version: 1.0.0.post19
4
+ Summary: Agentic Framework for Orchestrated Runtime, Governance, and Execution
5
+ Author-email: AI Data Team <learning@nuclia.com>
6
+ License-Expression: Apache-2.0
7
+ Project-URL: Progress, https://progress.com
8
+ Project-URL: Github, https://github.com/nuclia/forge
9
+ Project-URL: API Reference, https://docs.rag.progress.cloud
10
+ Classifier: Programming Language :: Python :: 3
11
+ Classifier: Operating System :: OS Independent
12
+ Requires-Python: >=3.10
13
+ Description-Content-Type: text/markdown
14
+ Requires-Dist: alembic
15
+ Requires-Dist: pydantic
16
+ Requires-Dist: nuclia>=4.9.25
17
+ Requires-Dist: nuclia-models>=0.52.1
18
+ Requires-Dist: nucliadb-models>=6.13.1.post6414
19
+ Requires-Dist: nucliadb-sdk>=6.13.1.post6414
20
+ Requires-Dist: nucliadb-telemetry[otel]
21
+ Requires-Dist: pydantic_settings
22
+ Requires-Dist: mcp>=1.26.0
23
+ Requires-Dist: prometheus_client
24
+ Requires-Dist: mrflagly>=0.2.11
25
+ Requires-Dist: aiodns
26
+ Requires-Dist: httpx
27
+ Requires-Dist: jinja2
28
+ Requires-Dist: databases[asyncpg]
29
+ Requires-Dist: sqlalchemy
30
+ Requires-Dist: cryptography
31
+ Requires-Dist: mmh3
32
+ Requires-Dist: psycopg2
33
+ Requires-Dist: tenacity
34
+ Requires-Dist: websockets
35
+ Requires-Dist: redis[hiredis]>=6.4.0
36
+ Requires-Dist: types-redis>=4.6.0.20241004
37
+ Requires-Dist: ruff>=0.15.10
38
+ Requires-Dist: lru-dict
39
+ Requires-Dist: sentry_sdk
40
+ Requires-Dist: fastapi
41
+
42
+ # Hyperforge
43
+
44
+ Hyperforge is the core agentic workflow framework in this repository. It
45
+ provides the runtime, HTTP API, workflow orchestration, broker integration,
46
+ persistence layer, and support for loading Hyperforge agent packages.
47
+
48
+ ## Install
49
+
50
+ From the workspace root:
51
+
52
+ ```bash
53
+ uv sync
54
+ ```
55
+
56
+ ## Run
57
+
58
+ Start the API service:
59
+
60
+ ```bash
61
+ uv run hyperforge-api
62
+ ```
63
+
64
+ Useful endpoints:
65
+
66
+ - `/health/ready`
67
+ - `/health/alive`
68
+ - `/metrics`
69
+
70
+ ## Configuration
71
+
72
+ Runtime configuration is provided through environment variables consumed by
73
+ Pydantic settings. Common settings include:
74
+
75
+ - `HTTP_HOST` and `HTTP_PORT`
76
+ - `MEMORY_READER_NUCLIADB`, `MEMORY_WRITER_NUCLIADB`, and
77
+ `MEMORY_SEARCH_NUCLIADB`
78
+ - `MEMORY_APIKEY_NUCLIADB`
79
+ - `VALKEY_URL`
80
+ - `LOAD_MODULES`
81
+
82
+ ## Development
83
+
84
+ Run the package tests from the workspace root:
85
+
86
+ ```bash
87
+ uv run pytest hyperforge
88
+ ```
89
+
90
+ Format and lint with the root `Makefile`:
91
+
92
+ ```bash
93
+ make fmt
94
+ make lint
95
+ ```
@@ -0,0 +1,90 @@
1
+ hyperforge/__init__.py,sha256=RWw55-BOVL10jbttWYFXTHKg2cwm1H3r12lHELBQLnU,332
2
+ hyperforge/agent.py,sha256=kLMFW7kAPMzfGAkC-DzWCgo0RfmCSqI-iPOaZNYo2B0,2547
3
+ hyperforge/arag.py,sha256=QOcFssmXjboPKgZR1OJA6uuAp-t8XMCBNHVFIFPNRlI,658
4
+ hyperforge/configure.py,sha256=0wqpnaaLpogM2ZxTfFHf2b-NOxbGYvRB4SU_BnQhF2Y,18634
5
+ hyperforge/database.py,sha256=msnX0jtjzq0EihJuOkPqGaI6rfiGOtEriHVDQJdZ7LE,50
6
+ hyperforge/definition.py,sha256=e_gm8mFDMGEcLjqYEv9n8vAlCMPJigVP9CopPoJ0uOU,209
7
+ hyperforge/driver.py,sha256=ytCZxkqPYgH6IaWHANOs4UMijj5oEomgULI7wz6XqeU,760
8
+ hyperforge/dummy.py,sha256=kBi3K1PfxaxumKK_PVE2O5zre-zIvX6AoPKGST_23jU,905
9
+ hyperforge/engine.py,sha256=KgLdAAVQO7uKL6IiywE4UvQtL4bvktasxGjuhfm1-es,6325
10
+ hyperforge/exceptions.py,sha256=HOVG8SN4Gld4yXl1A8_EZPkqo-s5TkSmdk3Oa6hos8I,177
11
+ hyperforge/feature_flag.py,sha256=tI9eTnzNtX_fEHCsLCyDgECzLObf2rW_6MVbGonbsFY,3373
12
+ hyperforge/fixtures.py,sha256=ZRlzfQii1RhkaLWx8MhH26sTOoKpLsEdm7CdSnjdhrI,17056
13
+ hyperforge/interaction.py,sha256=jGz9T-SVIqp2m4AOyAjzNb3LISBhJPxNnwQE65gLJ7s,3100
14
+ hyperforge/llm.py,sha256=a8QDmJ5v71OOqXcWkOerp2sIoMdNUvaLlKuGEnCnxLY,2924
15
+ hyperforge/manager.py,sha256=OAkedc5oEYYk6sA8eZe7JtSuprVAUvtuFWG2iTTHoM8,14729
16
+ hyperforge/minimal_fixtures.py,sha256=NUN7jj4yU5TSSNduVEz-wEMKsoWfrWzQyjIaLRhpq1s,2874
17
+ hyperforge/models.py,sha256=ObtiL6WqND5XEGk_1Eo8jPo0EGVs7uw8xW77CIkLhBs,9404
18
+ hyperforge/nua.py,sha256=Qmtf5CtHP8IcHV_AWZv1NJ4hV0LXaNXyRmpMeFYXO0E,10781
19
+ hyperforge/openapi.py,sha256=7N-pwKZ_OYYyivuguTexMla5qAvRW6LmWQ9Qxck_2Ow,2148
20
+ hyperforge/prompts.py,sha256=vc4YQIUnyRXpH9MRFXlJV3ItZc3nfoilykP6zuGNtYY,7958
21
+ hyperforge/pubsub.py,sha256=a7_ViLc3FASVInZxYZu7YxejXuOlCSeSjsZUafCUszk,2288
22
+ hyperforge/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
23
+ hyperforge/redis_utils.py,sha256=ppg9X098oOhmm07kazK92MdkaSCjpUlYGj5DTKgJza4,2670
24
+ hyperforge/settings.py,sha256=AmXqV-TKf-ARKKm-6wvWCsZztG--9xAq_ztNVDSjhsk,671
25
+ hyperforge/trace.py,sha256=2IU0LFHN2wvKFxFvC8SGF1vJrURxX-Jid1edfcGlnVY,1090
26
+ hyperforge/workflows.py,sha256=OyHD133T51RARy8_-w6qoNRbPRwNnFiOVV0aX30oD-Y,1143
27
+ hyperforge/api/__init__.py,sha256=mhqaNTgEDORu5oKQUtcYHZUbTgELbapa9KsmcLWl338,523
28
+ hyperforge/api/app.py,sha256=Wg3oihkwdrapXcZsXoHGeENgI6SL9Ffxda5IX0z-3ec,5453
29
+ hyperforge/api/authentication.py,sha256=GMW9_Jyu8q1EagRIpx1K8LSaV2fBESFEoslljmbXT9A,9906
30
+ hyperforge/api/commands.py,sha256=nbvdp33s-WMgP7GqF7sg09I6FqZVGG1b35xwvq7B4x8,1051
31
+ hyperforge/api/logging.py,sha256=P1wKCD7nDAOzjytL-_MBNvAg3ceqqpICPi6ifIbQQ8M,584
32
+ hyperforge/api/models.py,sha256=7_EtnaL8IgTD2HFBtD_yqthVsSepNT61pNLrirf42Jo,2673
33
+ hyperforge/api/session.py,sha256=D9UDgHegilpmop74F5kMyZAiD2Rt4VYEi-D-CM0MqgI,4917
34
+ hyperforge/api/settings.py,sha256=3aZekskjEATwIzCZ0IxuLTR5oflh9Gm1kJrn-ZueKIc,1318
35
+ hyperforge/api/utils.py,sha256=0y3pdLCkh5vqnRAIPcyjwghSRq6YqzHfSU_l-1w_eb0,13033
36
+ hyperforge/api/internal/__init__.py,sha256=AaX8wty5QAItojQQplez0QthA0cH8ISH5FHgssTGD5U,82
37
+ hyperforge/api/internal/inspect.py,sha256=mU_m9sAwU3caLr4NfG28XWvsiJEpamNdAdANSFZWDO8,988
38
+ hyperforge/api/internal/router.py,sha256=WC-uHckLF4NDWjrglwto1tdjseQ-HzxM6U5f_evnoRI,60
39
+ hyperforge/api/v1/__init__.py,sha256=GyU2V486WS4m_vmKL8JQOszhaPwoAQxKkjmI7yS8dxM,316
40
+ hyperforge/api/v1/agents.py,sha256=TajOOqu-75k7XmDniZ0fhmzelkFr6p_7dImwN90jSNU,16643
41
+ hyperforge/api/v1/interaction.py,sha256=yGlkT44l9v2u40LfKSBxv0w0dX2wYbD3mdQr3udjdfM,14957
42
+ hyperforge/api/v1/mcp_content.py,sha256=WE62jE1VGfq2_o1gtofJmOWpeuKVkKICOh3Rm_nQkdY,11220
43
+ hyperforge/api/v1/mcp_interaction.py,sha256=BJb2pydHdrccMmRmG4SM1R-3OIWV4tY2hY3yflmokQ8,11017
44
+ hyperforge/api/v1/oauth.py,sha256=4-_aDgZjEUY5NrhoqSwKIcsnRarUztLfC62IbWnF8uA,1839
45
+ hyperforge/api/v1/prompt.py,sha256=5dtHbo53qEg-p0SJSHKsdjxKj1Bq51IEdy7i5z3Fj-k,4085
46
+ hyperforge/api/v1/router.py,sha256=WC-uHckLF4NDWjrglwto1tdjseQ-HzxM6U5f_evnoRI,60
47
+ hyperforge/api/v1/schema.py,sha256=YNa3wMnXEHEk7aCVs53JiwPUxs51-N6x8X0q-P7lKX4,1874
48
+ hyperforge/api/v1/session.py,sha256=Mhvz3_5aGNI0DHwpsCaOrB4-d9PLhkZsaNaf3gXTkbI,5402
49
+ hyperforge/api/v1/utils.py,sha256=LZumX72FmozHi-M4kjvACkoeghtFaFIk_gP0aOrNA0o,289
50
+ hyperforge/api/v1/workflows.py,sha256=9aNPxQepIUJHkFePBvAecamwF5vVsyU7pa9JJv-AW4o,19473
51
+ hyperforge/broker/__init__.py,sha256=-RqoDJsYMGM3fwGZv_XU3X_DjF3WD-rIkMTht-CWmTY,1418
52
+ hyperforge/broker/local.py,sha256=8eGHb9Abkl0ODSv79JFngX0sNsO9GFoQfKG04rFweZE,4145
53
+ hyperforge/broker/redis.py,sha256=1_NjztwOLao1ZHbv-ORBvP7CNAEnAxNGVmJ1XsTHC0s,5564
54
+ hyperforge/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
55
+ hyperforge/context/agent.py,sha256=X4mv3w3_QBwpgA5kDaWKFKYghdc_7cXx9H5noCgFl0s,14067
56
+ hyperforge/context/config.py,sha256=Ho45-2YtU1gxjbtKYXTefvePScoX3WzogN4HcxbtgOM,4028
57
+ hyperforge/db/__init__.py,sha256=XIKe4I3mSXNbLaW3Nez30Z9TWt00GNsDm7Kz7riGFHk,116
58
+ hyperforge/db/agents.py,sha256=OW3U9WzT4U90LjBJZ1v8BHzKK58TtJgzMJTvPPSwNKo,55600
59
+ hyperforge/db/encryption.py,sha256=-IvRu7u9wKxfBPD3WeyiXC5xaKP1xE1HMWybYxXj1iU,2926
60
+ hyperforge/db/exceptions.py,sha256=56Zq6qS1TcFmc0mO0jhVCLaDBMm1d3cTUJHVQernL40,809
61
+ hyperforge/db/settings.py,sha256=4ktMkRHmFJyq-2I4hqDrVInh3qhrnjMIgVUT4uq2fsg,434
62
+ hyperforge/db/workflow_cleanup.py,sha256=RLtL2CNoxwD6MWEUutUwGf539Z4RHpKLL4KD60JLiSg,2331
63
+ hyperforge/memory/__init__.py,sha256=rkalYr97T7wpQPksbEHZZv0kvonBdGgtExUT7C8nPCw,149
64
+ hyperforge/memory/memory.py,sha256=3bVPIPAG2pLcMnmrpxmnE3rzK4UJxRE8rxLeUBWWrUo,36136
65
+ hyperforge/retrieval/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
66
+ hyperforge/retrieval/agent.py,sha256=zjclK3iU1doQ9xBKGE6cz0mRuTqlFQoDLAXnZxdlLfM,6147
67
+ hyperforge/retrieval/config.py,sha256=gOi5IXf_rJydQoEnc7ksco90YKSc-DhVwqNpzyvotPA,3170
68
+ hyperforge/server/__init__.py,sha256=ZJcUgBR6y4y6VdOKUfALvtRTCs56-pUcnRm1ypoB4rc,100
69
+ hyperforge/server/cache.py,sha256=UvTRU2zLyqrcQfTsCrhMtJDKfesk3ylhr_0DhBjqq5k,4252
70
+ hyperforge/server/run.py,sha256=DS5q2WnBxAAFaB2x3am5LeyHKb1giZz_9jYrtjAMQuQ,3452
71
+ hyperforge/server/sandbox.py,sha256=mtFIp5KEe4QMHhGl0ofGwDew5bmirtK5-yJD-_jo8dg,1874
72
+ hyperforge/server/session.py,sha256=j607VGJ6DtioCK8gtFNev4Qu3xcA9-SotTiZwWD1Y54,13947
73
+ hyperforge/server/settings.py,sha256=bAtVxF9Jkm0JZP6KKKP5dunAVdx8TH22HvToVAegGwY,1556
74
+ hyperforge/server/utils.py,sha256=klF0u1bae8dt6CcVB8wJbCug9frFSHbP8I6FSHf9OuE,1490
75
+ hyperforge/server/web.py,sha256=ytiPaG308LdmZWeZvucFK1wssEbeeMZ2oqDVz7zfWPA,914
76
+ hyperforge/standalone/__init__.py,sha256=WxKNOugcom4tySmJPEOgbVCveBjx6cL9tsfceLf6ClE,94
77
+ hyperforge/standalone/agent.py,sha256=PMA8YmbgZ2XThGrBpsc8i6GbAoMrqOaTz0ga1qCmdAI,7216
78
+ hyperforge/standalone/app.py,sha256=dWhx-_yzlMxjNKlK268P6mgxIq7EOyMrnKc9TYZh9DU,10041
79
+ hyperforge/standalone/config.py,sha256=ugJeSu2XIUVTYskh1aWNodzT1Q3KmiX3CisMFzC63fs,4765
80
+ hyperforge/standalone/const.py,sha256=lDTsuVEgLyIkXiu7CPUb34sMtHSm3wTdKviHJV_ueC8,29
81
+ hyperforge/standalone/run.py,sha256=W-5CzYo8T8vuyljLjOAW_XxNqt4mjg4Yk2unB2019pU,1973
82
+ hyperforge/standalone/settings.py,sha256=mCorHrD6avbmFRXSF0iaDfoYYygUwXGXXH0d6PvclUA,5071
83
+ hyperforge/standalone/ui_router.py,sha256=eBEjmfA-dvAaIBubz75AaSGR4r2K3qi81oKcLnn2Dyg,8634
84
+ hyperforge/utils/__init__.py,sha256=oRA3PQB0oRm58KiX90OJ2kR1ggS-3RLzP04GVsnC_nI,3408
85
+ hyperforge/utils/http.py,sha256=RLFSdE0EvW-bVN0jeokEaYKZzVCMr9zMZ4tqzoO0upU,1602
86
+ hyperforge-1.0.0.post19.dist-info/METADATA,sha256=xyynDcCCsde40k6UtZ0egIjz6F8NXgch80wA9dEtfK0,2257
87
+ hyperforge-1.0.0.post19.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
88
+ hyperforge-1.0.0.post19.dist-info/entry_points.txt,sha256=kEA0bmO84olNRZA99tzlNVjeyXZyPUYyID1ajMYujT0,422
89
+ hyperforge-1.0.0.post19.dist-info/top_level.txt,sha256=UAH24tAEqmv3Uv2LW3AzpawWAcPKK7VCeIQsDKOVaCc,11
90
+ hyperforge-1.0.0.post19.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (82.0.1)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1,8 @@
1
+ [console_scripts]
2
+ hyperforge-api = hyperforge.api:commands.run
3
+ hyperforge-downloads-cronjob = hyperforge.downloads.command:run
4
+ hyperforge-extract-openapi = hyperforge.api.commands:extract_openapi
5
+ hyperforge-sandbox = hyperforge.sandbox:run.run
6
+ hyperforge-server = hyperforge.server:run.run
7
+ hyperforge-standalone = hyperforge.standalone:run.run
8
+ hyperforge-workflows-cleanup-cronjob = hyperforge.agents.workflow_cleanup:run
@@ -0,0 +1 @@
1
+ hyperforge