hani 0.3.2__tar.gz → 0.4.0__tar.gz

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 (113) hide show
  1. {hani-0.3.2 → hani-0.4.0}/CHANGELOG.md +81 -3
  2. hani-0.4.0/PKG-INFO +899 -0
  3. hani-0.4.0/README.md +857 -0
  4. {hani-0.3.2 → hani-0.4.0}/pyproject.toml +7 -6
  5. {hani-0.3.2 → hani-0.4.0}/src/hani/app.py +2498 -191
  6. {hani-0.3.2 → hani-0.4.0}/src/hani/common.py +30 -2
  7. hani-0.4.0/src/hani/default_settings/autopilot_settings.json +7 -0
  8. hani-0.4.0/src/hani/default_settings/support_agent_settings.json +28 -0
  9. {hani-0.3.2 → hani-0.4.0}/src/hani/helpers.py +2 -2
  10. hani-0.4.0/src/hani/llm_logging.py +146 -0
  11. hani-0.4.0/src/hani/make_scenarios.py +312 -0
  12. hani-0.4.0/src/hani/ollama_fallback.py +71 -0
  13. {hani-0.3.2 → hani-0.4.0}/src/hani/run.py +124 -0
  14. {hani-0.3.2 → hani-0.4.0}/src/hani/runapp.py +30 -3
  15. {hani-0.3.2 → hani-0.4.0}/src/hani/runguest.py +27 -2
  16. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Grocery/Grocery.yml +1 -1
  17. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Island/Island.yml +1 -1
  18. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Trade/Trade.yml +1 -1
  19. {hani-0.3.2 → hani-0.4.0}/src/hani/scenario_makers.py +2 -2
  20. {hani-0.3.2 → hani-0.4.0}/src/hani/scenarios/grocery.py +2 -3
  21. {hani-0.3.2 → hani-0.4.0}/src/hani/scenarios/island.py +2 -2
  22. {hani-0.3.2 → hani-0.4.0}/src/hani/scenarios/trade.py +2 -2
  23. hani-0.4.0/src/hani/support_agent/__init__.py +38 -0
  24. hani-0.4.0/src/hani/support_agent/admin_ui.py +121 -0
  25. hani-0.4.0/src/hani/support_agent/autopilot.py +227 -0
  26. hani-0.4.0/src/hani/support_agent/capabilities.py +132 -0
  27. hani-0.4.0/src/hani/support_agent/floating_ui.py +412 -0
  28. hani-0.4.0/src/hani/support_agent/runtime.py +648 -0
  29. hani-0.4.0/src/hani/support_agent/settings.py +201 -0
  30. hani-0.4.0/src/hani/support_agent/tool_controller.py +223 -0
  31. hani-0.4.0/src/hani/support_agent/tools.py +529 -0
  32. {hani-0.3.2 → hani-0.4.0}/src/hani/tools/generator.py +6 -3
  33. {hani-0.3.2 → hani-0.4.0}/src/hani/tools/histograms.py +70 -15
  34. {hani-0.3.2 → hani-0.4.0}/src/hani/tools/history.py +10 -0
  35. {hani-0.3.2 → hani-0.4.0}/src/hani/tools/preferences.py +65 -4
  36. {hani-0.3.2 → hani-0.4.0}/src/hani/tools/results.py +20 -2
  37. {hani-0.3.2 → hani-0.4.0}/src/hani/tools/scenario_info.py +1 -0
  38. {hani-0.3.2 → hani-0.4.0}/src/hani/tools/tool.py +105 -11
  39. {hani-0.3.2 → hani-0.4.0}/src/hani/tools/urange.py +61 -6
  40. hani-0.4.0/src/hani.egg-info/PKG-INFO +899 -0
  41. {hani-0.3.2 → hani-0.4.0}/src/hani.egg-info/SOURCES.txt +18 -1
  42. {hani-0.3.2 → hani-0.4.0}/src/hani.egg-info/requires.txt +2 -1
  43. hani-0.4.0/tests/test_async_step.py +116 -0
  44. hani-0.4.0/tests/test_autopilot.py +344 -0
  45. hani-0.4.0/tests/test_support_agent.py +621 -0
  46. hani-0.4.0/tests/test_tutorial_agents.py +74 -0
  47. hani-0.3.2/PKG-INFO +0 -426
  48. hani-0.3.2/README.md +0 -385
  49. hani-0.3.2/src/hani/make_scenarios.py +0 -86
  50. hani-0.3.2/src/hani.egg-info/PKG-INFO +0 -426
  51. {hani-0.3.2 → hani-0.4.0}/LICENSE +0 -0
  52. {hani-0.3.2 → hani-0.4.0}/MANIFEST.in +0 -0
  53. {hani-0.3.2 → hani-0.4.0}/setup.cfg +0 -0
  54. {hani-0.3.2 → hani-0.4.0}/src/hani/__init__.py +0 -0
  55. {hani-0.3.2 → hani-0.4.0}/src/hani/announcements.md +0 -0
  56. {hani-0.3.2 → hani-0.4.0}/src/hani/auth.py +0 -0
  57. {hani-0.3.2 → hani-0.4.0}/src/hani/color_palettes.py +0 -0
  58. {hani-0.3.2 → hani-0.4.0}/src/hani/config/default.yaml +0 -0
  59. {hani-0.3.2 → hani-0.4.0}/src/hani/default_settings/consent.md +0 -0
  60. {hani-0.3.2 → hani-0.4.0}/src/hani/default_settings/env.json +0 -0
  61. {hani-0.3.2 → hani-0.4.0}/src/hani/default_settings/llm_settings.json +0 -0
  62. {hani-0.3.2 → hani-0.4.0}/src/hani/default_settings/scenario_order.txt +0 -0
  63. {hani-0.3.2 → hani-0.4.0}/src/hani/dual_auth.py +0 -0
  64. {hani-0.3.2 → hani-0.4.0}/src/hani/event_analytics.py +0 -0
  65. {hani-0.3.2 → hani-0.4.0}/src/hani/event_tracking.py +0 -0
  66. {hani-0.3.2 → hani-0.4.0}/src/hani/events.py +0 -0
  67. {hani-0.3.2 → hani-0.4.0}/src/hani/experiment_selector.py +0 -0
  68. {hani-0.3.2 → hani-0.4.0}/src/hani/find_scenario_source.py +0 -0
  69. {hani-0.3.2 → hani-0.4.0}/src/hani/helpers/__init__.py +0 -0
  70. {hani-0.3.2 → hani-0.4.0}/src/hani/helpers/negotiators.py +0 -0
  71. {hani-0.3.2 → hani-0.4.0}/src/hani/images/hani.JPG +0 -0
  72. {hani-0.3.2 → hani-0.4.0}/src/hani/images/hani1.JPG +0 -0
  73. {hani-0.3.2 → hani-0.4.0}/src/hani/images/hani2.JPG +0 -0
  74. {hani-0.3.2 → hani-0.4.0}/src/hani/images/hani3.JPG +0 -0
  75. {hani-0.3.2 → hani-0.4.0}/src/hani/images/hani4.JPG +0 -0
  76. {hani-0.3.2 → hani-0.4.0}/src/hani/llm_service.py +0 -0
  77. {hani-0.3.2 → hani-0.4.0}/src/hani/negotiator.py +0 -0
  78. {hani-0.3.2 → hani-0.4.0}/src/hani/register.py +0 -0
  79. {hani-0.3.2 → hani-0.4.0}/src/hani/runanalytics.py +0 -0
  80. {hani-0.3.2 → hani-0.4.0}/src/hani/runexperiment.py +0 -0
  81. {hani-0.3.2 → hani-0.4.0}/src/hani/runregister.py +0 -0
  82. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Grocery/_info.yaml +0 -0
  83. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Grocery/agent.yml +0 -0
  84. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Grocery/display.py +0 -0
  85. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Grocery/human.yml +0 -0
  86. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Island/_info.yaml +0 -0
  87. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Island/agent.yml +0 -0
  88. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Island/display.py +0 -0
  89. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Island/human.yml +0 -0
  90. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Trade/Buyer.yml +0 -0
  91. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Trade/Seller.yml +0 -0
  92. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Trade/_info.yaml +0 -0
  93. {hani-0.3.2 → hani-0.4.0}/src/hani/sample_scenarios/Default/Trade/display.py +0 -0
  94. {hani-0.3.2 → hani-0.4.0}/src/hani/scenarios/__init__.py +0 -0
  95. {hani-0.3.2 → hani-0.4.0}/src/hani/scenarios/base.py +0 -0
  96. {hani-0.3.2 → hani-0.4.0}/src/hani/scenarios/common.py +0 -0
  97. {hani-0.3.2 → hani-0.4.0}/src/hani/serve_dual.py +0 -0
  98. {hani-0.3.2 → hani-0.4.0}/src/hani/static/theme.css +0 -0
  99. {hani-0.3.2 → hani-0.4.0}/src/hani/templates/basic_login.html +0 -0
  100. {hani-0.3.2 → hani-0.4.0}/src/hani/templates/logout.html +0 -0
  101. {hani-0.3.2 → hani-0.4.0}/src/hani/tools/__init__.py +0 -0
  102. {hani-0.3.2 → hani-0.4.0}/src/hani/tools/helpers/__init__.py +0 -0
  103. {hani-0.3.2 → hani-0.4.0}/src/hani/tools/outcome_plot.py +0 -0
  104. {hani-0.3.2 → hani-0.4.0}/src/hani/tools/random.py +0 -0
  105. {hani-0.3.2 → hani-0.4.0}/src/hani/tools/utility_plot2d.py +0 -0
  106. {hani-0.3.2 → hani-0.4.0}/src/hani.egg-info/dependency_links.txt +0 -0
  107. {hani-0.3.2 → hani-0.4.0}/src/hani.egg-info/entry_points.txt +0 -0
  108. {hani-0.3.2 → hani-0.4.0}/src/hani.egg-info/top_level.txt +0 -0
  109. {hani-0.3.2 → hani-0.4.0}/tests/test_auth.py +0 -0
  110. {hani-0.3.2 → hani-0.4.0}/tests/test_event_tracking.py +0 -0
  111. {hani-0.3.2 → hani-0.4.0}/tests/test_registration.py +0 -0
  112. {hani-0.3.2 → hani-0.4.0}/tests/test_scenario_loading.py +0 -0
  113. {hani-0.3.2 → hani-0.4.0}/tests/test_tools.py +0 -0
@@ -5,6 +5,84 @@ All notable changes to the HANI (Human-Agent Negotiation Interface) project will
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [Unreleased]
9
+
10
+ ## [0.4.0] - 2026-11-16
11
+
12
+ ### Added
13
+ - **`ask_user`**: the support agent can ask the human a question (answer buttons and/or a
14
+ typed reply) and wait for the answer, as `SupportAgent.ask_user()` and as an LLM tool.
15
+ Returns `None` on timeout or while Autopilot is on.
16
+ - **`message_user`**: the agent can tell the human something at any moment through the chat,
17
+ a toast notification or the status strip (`SupportAgent.message_user()` and LLM tool).
18
+ - Tutorial levels 6 (control the interface) and 7 (ask the user) with screenshots, plus a
19
+ table of everything the agent can do to the interface.
20
+ - **Support-agent tutorial** (`docs/tutorial.md`): six levels from installation and a
21
+ 6-line echo agent, through a rule-based advisor, an LLM coach and a custom tool,
22
+ to a finished Deal Coach, each with a full-screen screenshot of a real run.
23
+ Runnable code in `examples/support_agent_tutorial/` (tested in
24
+ `tests/test_tutorial_agents.py`).
25
+ - **Downloadable agent template** (`examples/agent_template/`, also served from the docs
26
+ site as `downloads/hani-agent-template.zip`) with an example tool, proactive hook,
27
+ settings file and offline smoke test.
28
+ - **Optional Negotiation Support Agent** (`hani.support_agent`): an LLM-driven
29
+ assistant, enabled by default (with a user on/off switch), that can:
30
+ - chat with the user (and post messages unprompted) via a floating **chat
31
+ bubble** (bottom-right) that opens a `pn.chat.ChatInterface`, with a master
32
+ on/off switch and capability/autonomy controls the user can narrow within
33
+ the admin ceiling;
34
+ - send toast notifications;
35
+ - control any tool's enable/disable, visibility, and order (new
36
+ `ToolController`, which also activates the previously-stubbed tool
37
+ move/close buttons);
38
+ - drive the action panel (fill the offer, write the message, send a
39
+ counter-offer, accept, or end) through a shared action API extracted from
40
+ `action_panel` and exposed in `session_state["actions"]`.
41
+ - Multi-turn tool-calling via `litellm` (any provider; own key/host/port in
42
+ `support_agent_settings.json`), run off the IOLoop with all UI effects
43
+ marshalled through the session document.
44
+ - **Capability + autonomy model**: an admin grants a ceiling
45
+ (`suggest`/`semi`/`full` autonomy + per-capability switches); the human
46
+ negotiator can only narrow it, never widen. Agent-initiated actions are
47
+ logged distinctly (`component="SupportAgent"`, `actor="agent"`).
48
+ - **Enablement**: resolved from the `--support-agent on|off|auto` CLI flag
49
+ (`hani` / `hani-app` / `hani-guest`) → `HANI_SUPPORT_AGENT` env var →
50
+ settings `mode` (legacy `enabled` bool still honoured). Default is now
51
+ **on for everyone**; in Prolific sessions the user-facing Support Agent
52
+ switch starts **off** by default (and remains user-toggleable).
53
+ - Human-facing control for proactive Support Agent messages: choose whether
54
+ unprompted/event-triggered messages appear as toast notifications or on the
55
+ always-visible bottom status board (chat replies remain in chat).
56
+
57
+ - **Documentation**: README rewritten around the current feature set (Support
58
+ Agent, Autopilot, agent groups / per-session opponent pools, named
59
+ experiments, the Prolific workflow, data collection & analytics); new
60
+ `docs/experiments.md` and `docs/agents.md`; Ollama local-fallback and
61
+ per-negotiation LLM logging documented; index/nav updated.
62
+
63
+ ### Changed
64
+ - The support agent can now show, hide, enable and disable **every** tool, including the
65
+ pinned ones (Scenario Info, Preferences, User Results). Hidden tools are restored when
66
+ the participant switches the assistant off, and a tool that is shown again keeps its
67
+ enabled state.
68
+ - The agent status strip is a thin bar fixed to the bottom of the window, so it is visible
69
+ at every window size (it showed nothing on small displays before); it shows a placeholder
70
+ until the agent writes.
71
+ - Slimmer top bar (no title text), giving the panels about 30px of extra height.
72
+ - Requires `negmas>=0.17.0`; outcome spaces are stored and referenced as the negmas 0.17
73
+ `Enumerable*OutcomeSpace` types.
74
+ - Package and documentation links now point at `autoneg/hani`
75
+ (`https://github.com/autoneg/hani`, `https://autoneg.github.io/hani/`); older releases
76
+ on PyPI still show the former `yasserfarouk` URLs.
77
+
78
+ ### Fixed
79
+ - Action panel now rebuilds when the turn transitions from "no offer on the
80
+ table" to "partner offer available" (and vice versa), so the participant no
81
+ longer gets stuck with an End-only row after a later partner offer arrives.
82
+ - Timer worker thread no longer depends on module-global `session_state` lookup;
83
+ it uses an instance-held session reference, preventing `NameError` crashes in
84
+ countdown rendering and timeout handling.
85
+
8
86
  ## [0.3.2] - 2026-05-22
9
87
 
10
88
  ### Added
@@ -345,6 +423,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
345
423
  ---
346
424
 
347
425
  ## Links
348
- - [Repository](https://github.com/yasserfarouk/hani)
349
- - [Documentation](https://yasserfarouk.github.io/hani/)
350
- - [Issue Tracker](https://github.com/yasserfarouk/hani/issues)
426
+ - [Repository](https://github.com/autoneg/hani)
427
+ - [Documentation](https://autoneg.github.io/hani/)
428
+ - [Issue Tracker](https://github.com/autoneg/hani/issues)