fontlab-aidus-agentus 1.1.15__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 (139) hide show
  1. fontlab_aidus_agentus-1.1.15/.gitignore +23 -0
  2. fontlab_aidus_agentus-1.1.15/CONFIGURE.md +89 -0
  3. fontlab_aidus_agentus-1.1.15/DEPENDENCIES.md +64 -0
  4. fontlab_aidus_agentus-1.1.15/LICENSE +12 -0
  5. fontlab_aidus_agentus-1.1.15/LICENSE-3RD-PARTY.md +47 -0
  6. fontlab_aidus_agentus-1.1.15/PKG-INFO +301 -0
  7. fontlab_aidus_agentus-1.1.15/README.md +268 -0
  8. fontlab_aidus_agentus-1.1.15/RELEASE.md +29 -0
  9. fontlab_aidus_agentus-1.1.15/Scripts/Aidus Agentus/Enable FontLab MCP.py +14 -0
  10. fontlab_aidus_agentus-1.1.15/Scripts/Aidus Agentus/Open Configuration.py +14 -0
  11. fontlab_aidus_agentus-1.1.15/Scripts/Aidus Agentus/README.md +28 -0
  12. fontlab_aidus_agentus-1.1.15/Scripts/Aidus Agentus/Start Aidus Agentus.py +14 -0
  13. fontlab_aidus_agentus-1.1.15/conftest.py +35 -0
  14. fontlab_aidus_agentus-1.1.15/install.vfpy +39 -0
  15. fontlab_aidus_agentus-1.1.15/pyproject.toml +66 -0
  16. fontlab_aidus_agentus-1.1.15/run_in_fontlab/check_aidus_in_fontlab.vfpy +54 -0
  17. fontlab_aidus_agentus-1.1.15/run_in_fontlab/enable_fontlab_mcp.vfpy +4 -0
  18. fontlab_aidus_agentus-1.1.15/run_in_fontlab/introspect_pythonqt.vfpy +89 -0
  19. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/__init__.py +20 -0
  20. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/boot.py +19 -0
  21. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core/__init__.py +15 -0
  22. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core/acp_server.py +72 -0
  23. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core/agents.yml +120 -0
  24. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core/boot.py +96 -0
  25. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core/config.py +111 -0
  26. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core/errors.py +62 -0
  27. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core/fontlab_mcp.py +144 -0
  28. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core/health.py +65 -0
  29. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core/plugin_tools.py +49 -0
  30. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core/prompts/__init__.py +3 -0
  31. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core/prompts/fontlab_api.md +246 -0
  32. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core/py.typed +0 -0
  33. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core/py_version_check.py +21 -0
  34. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/core_launcher.py +4 -0
  35. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/install.py +468 -0
  36. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/launchers.py +130 -0
  37. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/plugin/__init__.py +62 -0
  38. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/plugin/brain_log.py +91 -0
  39. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/plugin/client.py +548 -0
  40. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/plugin/config.py +189 -0
  41. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/plugin/executor.py +643 -0
  42. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/plugin/main.py +235 -0
  43. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/plugin/transport.py +849 -0
  44. fontlab_aidus_agentus-1.1.15/src/fontlab_aidus_agentus/plugin/ui.py +575 -0
  45. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/LICENSE +12 -0
  46. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/LICENSE-3RD-PARTY.txt +47 -0
  47. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/@fortawesome-fontawesome-free/LICENSE.txt.txt +165 -0
  48. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/@mdi-svg/LICENSE.txt +20 -0
  49. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/@primer-octicons/LICENSE.txt +21 -0
  50. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/clipboard/LICENSE.txt +21 -0
  51. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/delegate/readme.md.txt +3 -0
  52. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/escape-html/LICENSE.txt +24 -0
  53. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/focus-visible/LICENSE.md.txt +5 -0
  54. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/good-listener/readme.md.txt +3 -0
  55. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/lucide-static/LICENSE.txt +43 -0
  56. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/lunr/LICENSE.txt +19 -0
  57. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/material-design-color/LICENSE.txt +21 -0
  58. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/retained/apache-2.0.txt.txt +201 -0
  59. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/retained/cc-by-4.0.txt.txt +156 -0
  60. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/retained/materialx-10.1.8-LICENSE.txt +19 -0
  61. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/retained/mit-basecoat-css.txt.txt +21 -0
  62. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/retained/mit-daisyui.txt.txt +21 -0
  63. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/retained/mit-tailwindcss.txt.txt +21 -0
  64. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/retained/ofl-roboto.txt.txt +93 -0
  65. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/retained/ofl-robotomono.txt.txt +93 -0
  66. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/retained/w3c-focus-visible.txt.txt +26 -0
  67. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/rxjs/LICENSE.txt.txt +202 -0
  68. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/select/readme.md.txt +3 -0
  69. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/tiny-emitter/LICENSE.txt +22 -0
  70. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/tslib/CopyrightNotice.txt.txt +15 -0
  71. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend/tslib/LICENSE.txt.txt +12 -0
  72. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/current-frontend-notices.json +2065 -0
  73. fontlab_aidus_agentus-1.1.15/src_docs/md/assets/english-search-omissions.json +503 -0
  74. fontlab_aidus_agentus-1.1.15/src_docs/md/configure.md +90 -0
  75. fontlab_aidus_agentus-1.1.15/src_docs/md/development-and-limits.md +54 -0
  76. fontlab_aidus_agentus-1.1.15/src_docs/md/dock-and-acp.md +120 -0
  77. fontlab_aidus_agentus-1.1.15/src_docs/md/guides/architecture.md +120 -0
  78. fontlab_aidus_agentus-1.1.15/src_docs/md/guides/assets/icon.png +0 -0
  79. fontlab_aidus_agentus-1.1.15/src_docs/md/guides/external-agents-mcp.md +177 -0
  80. fontlab_aidus_agentus-1.1.15/src_docs/md/guides/fontlab-installations.md +186 -0
  81. fontlab_aidus_agentus-1.1.15/src_docs/md/guides/fontlab-mcp.md +104 -0
  82. fontlab_aidus_agentus-1.1.15/src_docs/md/guides/manual-tests.md +101 -0
  83. fontlab_aidus_agentus-1.1.15/src_docs/md/guides/troubleshooting.md +61 -0
  84. fontlab_aidus_agentus-1.1.15/src_docs/md/index.md +40 -0
  85. fontlab_aidus_agentus-1.1.15/src_docs/md/installation.md +62 -0
  86. fontlab_aidus_agentus-1.1.15/src_docs/md/licence.md +54 -0
  87. fontlab_aidus_agentus-1.1.15/src_docs/md/stylesheets/local.css +2 -0
  88. fontlab_aidus_agentus-1.1.15/stubs/PythonQt/__init__.pyi +47 -0
  89. fontlab_aidus_agentus-1.1.15/stubs/fl.pyi +19 -0
  90. fontlab_aidus_agentus-1.1.15/test.sh +19 -0
  91. fontlab_aidus_agentus-1.1.15/tests/conftest.py +217 -0
  92. fontlab_aidus_agentus-1.1.15/tests/core/__init__.py +3 -0
  93. fontlab_aidus_agentus-1.1.15/tests/core/conftest.py +29 -0
  94. fontlab_aidus_agentus-1.1.15/tests/core/fixtures/acp_core.py +21 -0
  95. fontlab_aidus_agentus-1.1.15/tests/core/fixtures/mcp_server.py +26 -0
  96. fontlab_aidus_agentus-1.1.15/tests/core/test_acp_server.py +105 -0
  97. fontlab_aidus_agentus-1.1.15/tests/core/test_agents_yml.py +324 -0
  98. fontlab_aidus_agentus-1.1.15/tests/core/test_boot.py +30 -0
  99. fontlab_aidus_agentus-1.1.15/tests/core/test_boot_serve.py +122 -0
  100. fontlab_aidus_agentus-1.1.15/tests/core/test_config.py +45 -0
  101. fontlab_aidus_agentus-1.1.15/tests/core/test_errors.py +29 -0
  102. fontlab_aidus_agentus-1.1.15/tests/core/test_fontlab_mcp.py +94 -0
  103. fontlab_aidus_agentus-1.1.15/tests/core/test_health.py +43 -0
  104. fontlab_aidus_agentus-1.1.15/tests/core/test_mcp_roundtrip.py +202 -0
  105. fontlab_aidus_agentus-1.1.15/tests/core/test_plugin_tools.py +153 -0
  106. fontlab_aidus_agentus-1.1.15/tests/plugin/__init__.py +1 -0
  107. fontlab_aidus_agentus-1.1.15/tests/plugin/conftest.py +413 -0
  108. fontlab_aidus_agentus-1.1.15/tests/plugin/test_acp_protocol.py +449 -0
  109. fontlab_aidus_agentus-1.1.15/tests/plugin/test_client.py +234 -0
  110. fontlab_aidus_agentus-1.1.15/tests/plugin/test_config.py +196 -0
  111. fontlab_aidus_agentus-1.1.15/tests/plugin/test_edge_cases.py +393 -0
  112. fontlab_aidus_agentus-1.1.15/tests/plugin/test_enable_mcp.py +20 -0
  113. fontlab_aidus_agentus-1.1.15/tests/plugin/test_executor.py +169 -0
  114. fontlab_aidus_agentus-1.1.15/tests/plugin/test_mcp_acp_client.py +100 -0
  115. fontlab_aidus_agentus-1.1.15/tests/plugin/test_transport.py +342 -0
  116. fontlab_aidus_agentus-1.1.15/tests/plugin/test_ui_formatting.py +198 -0
  117. fontlab_aidus_agentus-1.1.15/tests/test_active_glyph_read.py +133 -0
  118. fontlab_aidus_agentus-1.1.15/tests/test_automatic_metric_guard.py +174 -0
  119. fontlab_aidus_agentus-1.1.15/tests/test_brain_edges.py +166 -0
  120. fontlab_aidus_agentus-1.1.15/tests/test_brain_log.py +97 -0
  121. fontlab_aidus_agentus-1.1.15/tests/test_client_protocol.py +284 -0
  122. fontlab_aidus_agentus-1.1.15/tests/test_dependency_pins.py +29 -0
  123. fontlab_aidus_agentus-1.1.15/tests/test_executor_config_edges.py +402 -0
  124. fontlab_aidus_agentus-1.1.15/tests/test_executor_preflight_errors.py +38 -0
  125. fontlab_aidus_agentus-1.1.15/tests/test_fly_examples.py +80 -0
  126. fontlab_aidus_agentus-1.1.15/tests/test_help_resources.py +49 -0
  127. fontlab_aidus_agentus-1.1.15/tests/test_info_read_preservation.py +67 -0
  128. fontlab_aidus_agentus-1.1.15/tests/test_install.py +803 -0
  129. fontlab_aidus_agentus-1.1.15/tests/test_native_boundaries.py +251 -0
  130. fontlab_aidus_agentus-1.1.15/tests/test_plugin_boot_integration.py +176 -0
  131. fontlab_aidus_agentus-1.1.15/tests/test_plugin_main.py +448 -0
  132. fontlab_aidus_agentus-1.1.15/tests/test_production_entrypoint.py +57 -0
  133. fontlab_aidus_agentus-1.1.15/tests/test_registered_unicode.py +87 -0
  134. fontlab_aidus_agentus-1.1.15/tests/test_residue_port.py +80 -0
  135. fontlab_aidus_agentus-1.1.15/tests/test_scripts_menu.py +422 -0
  136. fontlab_aidus_agentus-1.1.15/tests/test_standalone_install.py +64 -0
  137. fontlab_aidus_agentus-1.1.15/tests/test_transport_boundaries.py +149 -0
  138. fontlab_aidus_agentus-1.1.15/tests/test_transport_process.py +473 -0
  139. fontlab_aidus_agentus-1.1.15/tests/test_ui_dock.py +305 -0
@@ -0,0 +1,23 @@
1
+ # this_file: .gitignore
2
+ .venv/
3
+ .venv-*/
4
+ .coverage
5
+ .coverage.*
6
+ htmlcov/
7
+ __pycache__/
8
+ *.pyc
9
+ .pytest_cache/
10
+ dist/
11
+ *.egg-info/
12
+ .env
13
+ # Private and scratch state: macOS metadata, agent scratch dirs, local envs (never source)
14
+ .DS_Store
15
+ .omc/
16
+ **/.omc/
17
+ .local/
18
+ .superpowers/
19
+ .worktrees/
20
+ *.vfpyc
21
+
22
+ # Isolated documentation tooling
23
+ .docs-venv/
@@ -0,0 +1,89 @@
1
+ ---
2
+ this_file: CONFIGURE.md
3
+ ---
4
+ # Configure Aidus Agentus
5
+
6
+ Install the host and separate Python 3.13 brain first ([README](README.md)).
7
+ Run **Aidus Agentus > Open Configuration** in FontLab's Scripts menu. It opens the
8
+ loaded file, or creates a small template at `~/.config/aidus_agentus/config.json`.
9
+ If no valid config loads but a file exists, it opens that file for repair.
10
+ Existing contents are preserved. Edit in a text editor and save as UTF-8 JSON
11
+ (double quotes, no comments).
12
+
13
+ ## Minimal example
14
+
15
+ Replace the interpreter path with the brain environment's actual Python path:
16
+
17
+ ```json
18
+ {
19
+ "python_exe": "/absolute/path/to/brain/bin/python",
20
+ "api_keys": {
21
+ "openai": "~/.config/aidus_agentus/openai-key.txt",
22
+ "anthropic": "~/.config/aidus_agentus/anthropic-key.txt"
23
+ }
24
+ }
25
+ ```
26
+
27
+ The bundled agents use OpenAI and Anthropic. To use another provider, change the
28
+ agent models as described in [agents and models](src_docs/md/guides/architecture.md#agents-and-models).
29
+ Changing `api_keys` alone does not select a model.
30
+
31
+ ## Keys in the JSON file
32
+
33
+ | Key | Default | Meaning |
34
+ | --- | --- | --- |
35
+ | `python_exe` | `null` | External Python 3.13+ executable with the brain extra installed. `AIDUS_PYTHON` overrides it; otherwise a `fontlab-aidus-python` executable on FontLab's PATH is tried. Use an absolute path; `~` is expanded. |
36
+ | `api_keys` | `{}` | Provider name to a private key-file path or `env:VARIABLE_NAME`. Never put the raw key here. File contents are stripped of surrounding whitespace. |
37
+ | `timeout_seconds` | `30` | Positive number of seconds allowed without matching progress on an outstanding ACP request. Idle time does not count. |
38
+ | `core_path` | `null` | Advanced: directory containing `core_launcher.py` (or legacy `boot.py`). Leave unset to use the installed launcher package. |
39
+ | `log_level` | `"INFO"` | Retained compatibility field; currently does not change logging. The brain configures INFO logging on stderr. |
40
+
41
+ The loader uses the **first valid JSON object**, in this order: `aidus_config.json`
42
+ beside the installed packages (repository root when running source), that filename
43
+ inside `src/fontlab_aidus_agentus/plugin/`, `~/.config/aidus_agentus/config.json`, then
44
+ `~/.aidus_config.json`. It overlays that one file on defaults; files are not merged.
45
+ Invalid/unreadable files are reported with their path and skipped, including
46
+ files saved in another encoding. Their contents are never printed or replaced.
47
+ Set `AIDUS_CONFIG` in FontLab's environment to use only that path; a
48
+ missing/invalid explicit file falls back to defaults.
49
+ `_loaded_from`, if shown by the loader, is diagnostic output, not a setting.
50
+
51
+ ## Store provider keys safely
52
+
53
+ 1. Outside the repository, create the two key files named in the example, using
54
+ a text editor. Each file contains only its provider key. Do not paste keys
55
+ into scripts, chat, screenshots or terminal commands.
56
+ 2. On macOS/Linux, restrict access in a terminal:
57
+
58
+ ```sh
59
+ chmod 600 ~/.config/aidus_agentus/openai-key.txt ~/.config/aidus_agentus/anthropic-key.txt
60
+ ```
61
+
62
+ 3. Alternatively use a mapping such as `"openai": "env:MY_OPENAI_KEY"`. The
63
+ variable must exist in **FontLab's process environment**; a terminal export
64
+ does not update an already running GUI application. Without a mapping, the
65
+ brain inherits canonical variables such as `OPENAI_API_KEY` from FontLab.
66
+
67
+ The plugin passes resolved mappings as `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, etc.
68
+ to its child only; it does not add them to FontLab's parent environment or ACP
69
+ messages. Provider aliases `gemini` and `mistralai` map to `GOOGLE_API_KEY` and
70
+ `MISTRAL_API_KEY`. The external brain validates the selected models' credentials.
71
+
72
+ ## Verify
73
+
74
+ In FontLab's Python console, check paths and key availability without printing keys:
75
+
76
+ ```python
77
+ from fontlab_aidus_agentus.plugin.config import load_config, get_api_key
78
+ c = load_config()
79
+ print("Config:", c.get("_loaded_from", "defaults"))
80
+ print("Python:", c.get("python_exe"))
81
+ print("OpenAI key available:", bool(get_api_key(c, "openai")))
82
+ print("Anthropic key available:", bool(get_api_key(c, "anthropic")))
83
+ ```
84
+
85
+ Shut down the dock with `fontlab_aidus_agentus.shutdown()` (import it first), then
86
+ run **Start Aidus Agentus** and wait for readiness. Ask for a read-only list of open
87
+ fonts. A `True` key check only confirms availability; a successful response checks
88
+ authentication. Reconnect alone does not reload host JSON or mapped key files.
89
+ See [troubleshooting](src_docs/md/guides/troubleshooting.md) if it fails.
@@ -0,0 +1,64 @@
1
+ ---
2
+ this_file: DEPENDENCIES.md
3
+ ---
4
+
5
+ ## 2026-11-09 — Issue 242 single distribution
6
+
7
+ The separate `aidus-code-core` brain distribution was removed in the Aidus Agentus restructure; the brain now ships only as the `[brain]` extra of `fontlab-aidus-agentus`. That extra keeps the seven exact AgentPool/Pydantic AI/provider SDK pins adopted on 2026-11-06: AgentPool 2.9.18 with Pydantic AI 2.66.0 broke real imports (removed `builtin_tools`) despite passing dependency checks. Upgrade the coherent tuple together after real consumer imports and the two-interpreter suite pass. No dependency was added to the embedded Python 3.11 host.
8
+
9
+ # Dependencies
10
+
11
+ Transport framing uses the Python standard library incremental UTF-8 decoder;
12
+ no dependency was added. API reference: [Python3.11 codecs](https://docs.python.org/3.11/library/codecs.html#incrementaldecoder-objects).
13
+
14
+ The embedded base has no external runtime dependencies. PythonQt and fontlab are provided by the host.
15
+
16
+ The Scripts-menu helpers add no dependencies. They use host PythonQt single-shot
17
+ QTimer instances and QDesktopServices with local-file QUrls; file creation uses
18
+ stdlib pathlib's exclusive-create mode. References consulted for this follow-up:
19
+ [QTimer](https://doc.qt.io/qt-6/qtimer.html),
20
+ [QDesktopServices](https://doc.qt.io/qt-6/qdesktopservices.html),
21
+ [PythonQt](https://mevislab.github.io/pythonqt/),
22
+ [pathlib](https://docs.python.org/3.11/library/pathlib.html), and
23
+ [uv package installation](https://docs.astral.sh/uv/pip/packages/).
24
+ The target FontLab PythonQt binding still needs a live launcher check.
25
+
26
+ The brain extra requires external Python 3.13+ through AgentPool 2.8.8's own Python requirement. PydanticAI slim and graph are pinned to 1.50.0: clean resolution originally selected 2.55.0, which removed `pydantic_ai.builtin_tools` required by AgentPool 2.8.8. Provider SDKs retain the verified versions: OpenAI 2.16.0, Anthropic 0.77.0, Mistral 1.9.11 and Google GenAI 1.61.0. OpenAI major 3 and Anthropic major 1 broke constructor compatibility: their new HTTPX2 clients reject the HTTPX clients passed by PydanticAI 1.50. AgentPool provides the existing coding agent and production ACP implementation. fontlab-remopy (>=1.2.0, the first release with the mcp.relay module) owns native remote control and SDK relay; mcp 1.x, AnyIO 4.x provide transport. Retained supporting dependencies are PyYAML, structlog, Pydantic, pydantic-settings, HTTPX, aiofiles and ag-ui-protocol. hatchling and hatch-vcs build tag-versioned artifacts; pytest and pytest-asyncio run tests.
27
+
28
+ API references checked: AgentPool 2.8.8 installed source (`agentpool.models.manifest`, `agentpool_server.acp_server.acp_agent`), MCP v1.26 installed source (`stdio_client`, `ClientSession`); https://doc.qt.io/archives/qt-5.15/qprocess.html (QByteArray readers and two-argument finished signal), https://mevislab.github.io/pythonqt/ (embedded binding).
29
+
30
+ ## Re-evaluation 2026-10-15 (R046)
31
+
32
+ - The in-FontLab base and the `Scripts/Aidus Agentus/` launchers have no pip dependencies.
33
+ - `[brain]` runs in a separate CPython >=3.13 (AgentPool 2.8.8 requirement), never in
34
+ FontLab's Python 3.11.
35
+ - `acp` (`acp_server.py`) is vendored inside the agentpool 2.8.8 wheel; it is not a
36
+ separate distribution, and the agentpool pin covers it.
37
+ - Provider SDKs (openai 2.16.0, anthropic 0.77.0, mistralai 1.9.11, google-genai 1.61.0),
38
+ pydantic-ai-slim/pydantic-graph 1.50.0 and ag-ui-protocol <0.2 are pinned for
39
+ AgentPool 2.8.8 compatibility. Each is one or more major versions behind (latest:
40
+ openai 3.31, anthropic 1.14, mistralai 3.2, google-genai 2.31, pydantic-ai 2.56,
41
+ ag-ui-protocol 1.0). They will not receive upstream fixes.
42
+ - Review trigger: review the whole set when AgentPool publishes a release built on
43
+ PydanticAI 2.x (the latest is 2.9.18, 2026-04-05), or when a security advisory
44
+ affects a pinned SDK, AgentPool or pydantic-ai. Change the pins only together,
45
+ and only after a full brain suite run.
46
+ - mcp stays `>=1.26,<2`, matching fontlab-remopy. MCP 2.x (2.3.0) exists; migrating is
47
+ planned, separate work, never an implicit upgrade.
48
+ - Licences: all MIT, Apache-2.0, BSD-3-Clause, or MIT OR Apache-2.0.
49
+
50
+ ## 2026-10-16 (issue 106)
51
+
52
+ - The dev extra adds `pytest-cov` (coverage 7.x; MIT/Apache-2.0) to measure all
53
+ three packages. Coverage runs with `core = "sysmon"` (Python 3.12+
54
+ sys.monitoring) and its subprocess patch, configured in pyproject.toml.
55
+ - The new installer and tests use only the standard library. The host-side test
56
+ environment (`.venv-host`) holds pytest, pytest-asyncio, pytest-cov and
57
+ fontlab-remopy without dependencies, mirroring what FontLab itself imports.
58
+
59
+
60
+ ## Documentation only
61
+
62
+ A separate Python 3.13 environment uses the exact 31-package hash-locked
63
+ `src_docs/requirements.txt`: ProperDocs 1.6.7, MkDocs 1.6.1, MaterialX 10.1.8 and
64
+ PyMdown 11.0.1. No product dependency or runtime lock changes accompany this site.
@@ -0,0 +1,12 @@
1
+ Proprietary License
2
+
3
+ Copyright (c) 2025 Fontlab Ltd. All Rights Reserved.
4
+
5
+ This software and associated documentation files (the "Software") are the
6
+ exclusive property of Fontlab Ltd. Unauthorized copying, modification,
7
+ distribution, or use of this Software, via any medium, is strictly prohibited.
8
+
9
+ The Software is provided under license to authorized users only. No rights are
10
+ granted to any party not explicitly authorized in writing by Fontlab Ltd.
11
+
12
+ For licensing inquiries, contact: dev@fontlab.com
@@ -0,0 +1,47 @@
1
+ # Third-Party Licenses
2
+
3
+ This document lists the licenses of third-party dependencies used by Aidus Agentus.
4
+
5
+ ## Runtime Dependencies (Core)
6
+
7
+ ### agentpool
8
+ - License: MIT
9
+ - Source: https://github.com/phil65/agentpool
10
+
11
+ ### structlog
12
+ - License: MIT/Apache-2.0
13
+ - Source: https://github.com/hynek/structlog
14
+
15
+ ### pydantic
16
+ - License: MIT
17
+ - Source: https://github.com/pydantic/pydantic
18
+
19
+ ### pydantic-settings
20
+ - License: MIT
21
+ - Source: https://github.com/pydantic/pydantic-settings
22
+
23
+ ### httpx
24
+ - License: BSD-3-Clause
25
+ - Source: https://github.com/encode/httpx
26
+
27
+ ### aiofiles
28
+ - License: Apache-2.0
29
+ - Source: https://github.com/Tinche/aiofiles
30
+
31
+ ## Development Dependencies
32
+
33
+ ### pytest
34
+ - License: MIT
35
+ - Source: https://github.com/pytest-dev/pytest
36
+
37
+ ### ruff
38
+ - License: MIT
39
+ - Source: https://github.com/astral-sh/ruff
40
+
41
+ ### pyright
42
+ - License: MIT
43
+ - Source: https://github.com/microsoft/pyright
44
+
45
+ ---
46
+
47
+ All trademarks are the property of their respective owners.
@@ -0,0 +1,301 @@
1
+ Metadata-Version: 2.5
2
+ Name: fontlab-aidus-agentus
3
+ Version: 1.1.15
4
+ Summary: Embedded FontLab ACP client and optional external AgentPool coding brain
5
+ Project-URL: Repository, https://github.com/fontlabcom/fontlab-aidus-agentus
6
+ License-Expression: LicenseRef-Proprietary
7
+ License-File: LICENSE
8
+ License-File: LICENSE-3RD-PARTY.md
9
+ Requires-Python: >=3.11
10
+ Provides-Extra: brain
11
+ Requires-Dist: ag-ui-protocol<0.2,>=0.1.10; extra == 'brain'
12
+ Requires-Dist: agentpool[ag-ui]==2.8.8; extra == 'brain'
13
+ Requires-Dist: aiofiles>=24.1; extra == 'brain'
14
+ Requires-Dist: anthropic==0.77.0; extra == 'brain'
15
+ Requires-Dist: anyio<5,>=4.12; extra == 'brain'
16
+ Requires-Dist: fontlab-remopy>=1.2.0; extra == 'brain'
17
+ Requires-Dist: google-genai==1.61.0; extra == 'brain'
18
+ Requires-Dist: httpx>=0.28; extra == 'brain'
19
+ Requires-Dist: mcp<2,>=1.26; extra == 'brain'
20
+ Requires-Dist: mistralai==1.9.11; extra == 'brain'
21
+ Requires-Dist: openai==2.16.0; extra == 'brain'
22
+ Requires-Dist: pydantic-ai-slim==1.50.0; extra == 'brain'
23
+ Requires-Dist: pydantic-graph==1.50.0; extra == 'brain'
24
+ Requires-Dist: pydantic-settings>=2.6; extra == 'brain'
25
+ Requires-Dist: pydantic>=2.10; extra == 'brain'
26
+ Requires-Dist: pyyaml>=6; extra == 'brain'
27
+ Requires-Dist: structlog>=25.5; extra == 'brain'
28
+ Provides-Extra: dev
29
+ Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
30
+ Requires-Dist: pytest-cov>=5; extra == 'dev'
31
+ Requires-Dist: pytest>=8.3; extra == 'dev'
32
+ Description-Content-Type: text/markdown
33
+
34
+ ---
35
+ this_file: README.md
36
+ ---
37
+
38
+ ## Development status — 2026-11-05
39
+
40
+ Canonical source inspected for this proposal: `37b7f48522a7`. This is a dated source observation, not an installed or native acceptance claim.
41
+
42
+ Reconcile the qualified Issue 207 consolidated `src/fontlab_aidus_agentus` and `Scripts/Aidus Agentus` candidate against this canonical split; do not describe the candidate as installed.
43
+
44
+ Qualify active-editor/CurrentGlyph preservation, M1–M11, provider authentication, dock lifecycle and shutdown before operational brain cutover.
45
+
46
+ ## Repository and development
47
+
48
+ `src/fontlab_aidus_agentus/` is the host entry point; `src/fontlab_aidus_agentus/plugin/` owns the dock; `src/fontlab_aidus_agentus/core/` owns the brain. `Scripts/Aidus Agentus/` has the menu scripts and `run_in_fontlab/` the developer checks run inside FontLab.
49
+
50
+ Prepare the two environments in README, then run `./test.sh`. The brain uses Python 3.13+; host tests use Python 3.11. `AIDUS_TEST_PYTHON` and `AIDUS_HOST_PYTHON` select existing interpreters. Never load provider keys during tests.
51
+
52
+ Keep runtime, ordinary installed artifacts, native workflows and published documentation as separate acceptance results. Track open checks in [TODO.md](TODO.md), the implementation route in [PLAN.md](PLAN.md), and dated evidence in [CHANGELOG.md](CHANGELOG.md).
53
+
54
+ # Aidus Agentus for FontLab 9
55
+
56
+ Aidus Agentus adds an AI chat dock inside FontLab 9. You can ask about the current
57
+ glyph, inspect fonts and metrics, change spacing, or generate and run FontLab
58
+ Python code. Responses stream into the dock. The selected AI provider receives
59
+ your prompts and the tool results used by the agent; use a disposable font for
60
+ your first editing experiments.
61
+
62
+ The FontLab plugin runs in the host's Python 3.11/PythonQt environment. The AI
63
+ brain runs in a **separate Python 3.13+ process**, using AgentPool 2.8.8. Installing
64
+ AI libraries into FontLab's embedded Python is unnecessary.
65
+
66
+ Read [Configure Aidus Agentus](CONFIGURE.md) for the short setup guide,
67
+ [architecture](src_docs/md/guides/architecture.md) for the process/tool boundaries, and
68
+ [troubleshooting](src_docs/md/guides/troubleshooting.md) when something fails.
69
+
70
+ ## Install from this checkout
71
+
72
+ To install into FontLab 9, open `install.vfpy` from a checkout in FontLab
73
+ (double-click it or drop it onto FontLab), then restart FontLab. The file is a
74
+ short stub that hands the work to
75
+ [fontlab-instamix](https://github.com/fontlabcom/fontlab-python-instamix); if
76
+ instamix is not installed yet, the stub installs it from PyPI first. Instamix
77
+ installs the package into FontLab's own `site-packages` and records the install
78
+ under the extension id `com.fontlab.aidus-agentus`.
79
+
80
+ You need FontLab 9, [uv](https://docs.astral.sh/uv/), and access to the
81
+ [FontLab Remopy wheel](https://github.com/fontlabcom/fontlab-remopy/releases).
82
+ Download that wheel first; replace the example wheel path below with its actual
83
+ path. These commands run in a terminal **at this repository's root**.
84
+
85
+ 1. Install the lightweight host package into a dedicated folder:
86
+
87
+ ```sh
88
+ uv pip install --python 3.11 --target ~/.local/share/fontlab-aidus/host .
89
+ # Optional: required for the Enable FontLab MCP menu script.
90
+ uv pip install --python 3.11 --target ~/.local/share/fontlab-aidus/host --no-deps /path/to/fontlab_remopy-VERSION-py3-none-any.whl
91
+ ```
92
+
93
+ Remopy's in-FontLab enable helper needs only the host's `fontlab` module;
94
+ its external MCP dependencies belong in the brain environment.
95
+
96
+ 2. In FontLab's Python console, make that host folder importable:
97
+
98
+ ```python
99
+ import os, site
100
+ site.addsitedir(os.path.expanduser("~/.local/share/fontlab-aidus/host"))
101
+ import fontlab_aidus_agentus
102
+ print(fontlab_aidus_agentus.__version__)
103
+ ```
104
+
105
+ This adds the path for the current FontLab session. Repeat after restarting
106
+ FontLab, or have your FontLab environment setup add it on each launch. The
107
+ Scripts-menu folder link alone does not install the package or add this path.
108
+
109
+ 3. Create the separate brain environment and install the real AI dependencies:
110
+
111
+ ```sh
112
+ uv venv --python 3.13 ~/.local/share/fontlab-aidus/brain
113
+ uv pip install --python ~/.local/share/fontlab-aidus/brain/bin/python '.[brain]' /path/to/fontlab_remopy-VERSION-py3-none-any.whl
114
+ ```
115
+
116
+ Remopy is supplied explicitly because it may be absent from the package
117
+ registry. If you maintain a sibling `fontlab-remopy` checkout, use its path
118
+ instead of the wheel. On Windows use the environment's `Scripts/python.exe`
119
+ wherever these examples use `bin/python`.
120
+
121
+ 4. Set `python_exe` and provider-key sources in the host JSON file as described
122
+ in [CONFIGURE.md](CONFIGURE.md). The bundled manifest uses OpenAI for the
123
+ copilot/analyst and Anthropic for the coder. Configure both providers, or
124
+ [supply your own manifest](src_docs/md/guides/architecture.md#agents-and-models).
125
+
126
+ For an existing release, substitute its downloaded Aidus wheel for `.` and use
127
+ `'/path/to/fontlab_aidus_agentus-VERSION-py3-none-any.whl[brain]'` for `'.[brain]'`.
128
+ See [RELEASE.md](RELEASE.md) for v0.2.0 hashes and its historical verification.
129
+ **The new menu scripts require the current checkout's host package**; v0.2.0
130
+ predates the installed launcher helpers. No PyPI installation is assumed.
131
+
132
+ ## Run in FontLab
133
+
134
+ The root [Aidus Agentus](Aidus%20Code/README.md) folder holds three thin `.py`
135
+ entry scripts and a README for FontLab's Scripts menu. In this workspace the
136
+ orchestrator links it into FontLab's Scripts folder. Elsewhere, copy the scripts
137
+ with the installer from the host package (run it in a terminal, not in FontLab):
138
+
139
+ ```sh
140
+ PYTHONPATH=~/.local/share/fontlab-aidus/host python3 -m fontlab_aidus_agentus.install install
141
+ PYTHONPATH=~/.local/share/fontlab-aidus/host python3 -m fontlab_aidus_agentus.install check
142
+ ```
143
+
144
+ `--user-folder` selects another FontLab user folder. The installer writes
145
+ `Scripts/Aidus Agentus` plus a manifest with the sha256 of each file it wrote.
146
+ Your own files in that folder are kept. A script you edited, or a symlink in place
147
+ of one, stops `install` before anything changes; `uninstall` removes only the
148
+ unmodified files it wrote and the folder only if it is then empty. Each write or
149
+ removal re-checks its file first, and an interrupted install is completed by the
150
+ next run. A folder (or link) without a valid manifest is never touched. `check`
151
+ prints JSON and exits 0 only when the scripts are current and the brain Python
152
+ is configured. With a full `pip install`, the same commands are
153
+ `fontlab-aidus-install install|check|uninstall`.
154
+
155
+ 1. Run **Open Configuration** to edit the host JSON file.
156
+ 2. Run **Enable FontLab MCP**, or enable **Preferences > Aidus > Allow external
157
+ MCP clients to control FontLab**. The script enables/notifies the running
158
+ listener; it does not save the full preference set.
159
+ 3. Run **Start Aidus Agentus**. It queues startup on FontLab's Qt event loop, then
160
+ returns promptly. The separate brain may take longer to connect.
161
+ 4. Wait for the dock to be ready. Ask: "List the open fonts without changing
162
+ them." A streamed answer verifies a provider call; a tool result also checks
163
+ the FontLab connection.
164
+
165
+ To start directly from FontLab's Python console:
166
+
167
+ ```python
168
+ import fontlab_aidus_agentus
169
+ fontlab_aidus_agentus.run()
170
+ # Before starting again, or after editing host configuration:
171
+ fontlab_aidus_agentus.shutdown()
172
+ ```
173
+
174
+ The menu launcher shows an existing dock instead of starting another child.
175
+ **Reconnect** starts a fresh child and ACP session using the already loaded host
176
+ settings. It discards pending requests and never replays an edit. After changing
177
+ host JSON or key files, shut down and start again to reload them. Idle sessions
178
+ stay connected. A response timeout means the outcome may be unknown; inspect
179
+ the font before resubmitting an edit.
180
+
181
+ Chat entries are saved locally to `~/.config/aidus_agentus/history.json` (newest
182
+ 500 rows, at most 2 MB, messages cut at 20,000 characters) and reappear when the
183
+ dock starts; **Clear** clears the dock and removes
184
+ that file. There is no model picker in the dock. Metric edits made through the
185
+ fallback tools are one Edit > Undo step ("Aidus: Set Glyph Metrics"). Brain
186
+ warnings and errors appear in FontLab's Output panel as `[Aidus brain]` lines
187
+ (at most 50 per brain process); if the brain exits with an error, the dock shows
188
+ its exit code and last five messages.
189
+
190
+ ## The dock (GUI)
191
+
192
+ The graphical part is `src/fontlab_aidus_agentus/plugin/ui.py`: `AidusAgentusDock`, a PythonQt
193
+ `QDockWidget` that docks left or right in FontLab 9 and is the only window Aidus
194
+ adds. It has a status label (connected or disconnected), **Reconnect** and **Clear**
195
+ buttons, a read-only chat transcript with a colour per role (user, assistant, tool
196
+ call, tool result, error), a "Thinking..." indicator and a one-line input field.
197
+ `src/fontlab_aidus_agentus/plugin/main.py` creates it, `client.py` feeds it streamed updates and
198
+ `transport.py` owns the brain process. It runs in the host and uses no PySide2.
199
+ The dock is chat only: there is no model picker or settings panel yet (see
200
+ [PLAN.md](PLAN.md)); configuration stays in the JSON file that **Open Configuration** shows.
201
+
202
+ ## Code it can write: the FontLab package set
203
+
204
+ Aidus is the coding agent for the FontLab Python ecosystem, not only for the
205
+ native `fontlab` module. The system prompt
206
+ ([`src/fontlab_aidus_agentus/core/prompts/fontlab_api.md`](src/fontlab_aidus_agentus/core/prompts/fontlab_api.md))
207
+ teaches the agents which layer to target, with import names and one-line usage:
208
+
209
+ | Package | Aidus writes code for |
210
+ | --- | --- |
211
+ | fontlab-echopy (`echopy`) | The documented, typed `fontlab`, `fontgate`, `fontpr` and `PythonQt` shims that Aidus builds upon |
212
+ | fontlab-fly (`fly`) | Short aliases (`fl`, `fg`, `tr`, `pr`, `qt`, `ap`, `qs`, `gp`, `fp`, `pens`) in scripts |
213
+ | fontlab-fontlabapp (`fontlabapp`) | Dialogs, panels, drawing, reports and guarded edits; glyph-window painters |
214
+ | pythonqtside | Qt5 widgets with PySide2-style names on host PythonQt |
215
+ | fontlab-glyport (`fontlab_glyport`) | Running Glyphs.app scripts and plugins |
216
+ | fontlab-fontport (`fontlab_fontport`) | FontParts and UFO interchange |
217
+ | fontlab-python-plugmix (current core: `fontlabapp.plugins`) | Native Reporter APIs through `fly.ap.plugins`; overlays use `flCanvas.appendPythonPainter` (with an `EditorPainters` fallback) |
218
+ | fontlab-python-pens (`fontlab_pens`) | Font drawing pens through `fly.pens` |
219
+ | fontlab-python-scriptmix | Scripts-menu tools (a folder of scripts, not an importable package) |
220
+ | fontlab-remopy (`fontlab_remopy`) | Driving FontLab from an external process; also the bridge Aidus itself uses |
221
+
222
+ Generated FontLab scripts use `fontlab-fly >=1.3.0` and the needed providers
223
+ in FontLab's scripting environment. Native APIs use `fly.fl`, dialogs use `fly.ap`,
224
+ and other providers use their Fly aliases. Missing packages need installation;
225
+ Aidus reports the requirement instead of generating direct provider imports.
226
+ The separate AI brain does not need Fly merely to generate these scripts.
227
+ Generated code runs through the native MCP `run_python` tool or the fallback
228
+ `run_fontlab_script`; neither installs packages. To see what a given FontLab
229
+ session can import, run `open -a "/Applications/FontLab 9.app" run_in_fontlab/check_aidus_in_fontlab.vfpy`
230
+ (or open it in FontLab). It writes a JSON report (`AIDUS_LOAD_CHECK` sets the path) and only imports.
231
+
232
+ ## External ACP clients
233
+
234
+ The brain also provides `fontlab-aidus-acp` (alias `aidus-core`) for stdio ACP
235
+ protocol version 1. It is not an HTTP server. FontLab must be running with native
236
+ MCP available for an external editor to control fonts; the fallback executor is
237
+ provided by the embedded dock. The host JSON credential mappings are applied by
238
+ the plugin, so external clients must supply their own provider environment.
239
+ See [architecture](src_docs/md/guides/architecture.md#external-clients).
240
+
241
+ ## Automatic-layer metrics
242
+
243
+ `set_glyph_metrics` refuses explicit width or sidebearing assignments to native
244
+ automatic layers before setters or history notifications. This includes equal
245
+ values: the previous no-op path still invoked setters. An empty request remains
246
+ successful. This source guard does not qualify the current-glyph read path or
247
+ whole-font Undo/Redo preservation; native acceptance remains open.
248
+
249
+ ## Develop and test
250
+
251
+ `./test.sh` needs two environments: the brain (Python 3.13+, `.venv`) and a
252
+ host-like one (arm64 CPython 3.11, `.venv-host`, like FontLab's own Python):
253
+
254
+ ```sh
255
+ uv venv --python 3.13 .venv
256
+ uv pip install --python .venv/bin/python -e '.[brain,dev]' /path/to/fontlab_remopy-VERSION-py3-none-any.whl
257
+ uv venv --python cpython-3.11-macos-aarch64-none .venv-host
258
+ uv pip install --python .venv-host/bin/python pytest pytest-asyncio pytest-cov
259
+ uv pip install --python .venv-host/bin/python --no-deps /path/to/fontlab_remopy-VERSION-py3-none-any.whl
260
+ ./test.sh # extra arguments go to the brain run, e.g. ./test.sh -x -k config
261
+ ```
262
+
263
+ The brain run measures coverage of all three packages; the host run repeats the
264
+ plugin, launcher and installer tests on 3.11 without AI libraries. Tests use
265
+ fakes of PythonQt, QProcess and `fontlab`, and a deterministic AgentPool
266
+ TestModel: no provider calls and no live FontLab. Every test gets an empty HOME
267
+ and no `*_API_KEY` variables, and the run stops if an `aidus_config.json` sits at
268
+ the repository root. Menu-script tests check the scheduling contract, not timing
269
+ in the real application. [docs/manual-tests.md](src_docs/md/guides/manual-tests.md) lists what
270
+ only a person at FontLab can check.
271
+
272
+ Build with `uv build`. Wheels contain the runtime packages, prompts, tool definitions and authored offline
273
+ help. Deferred startup errors print absolute paths to readable installation,
274
+ configuration or troubleshooting Markdown without opening it. The sdist also
275
+ contains the menu scripts, user docs and tests.
276
+ [DEPENDENCIES.md](DEPENDENCIES.md) explains the dependency pins.
277
+
278
+ The v0.2.0 migration's native verification is recorded in the [v1.1.7 WORK.md](https://github.com/fontlabcom/fontlab-aidus-agentus/blob/v1.1.7/WORK.md) and
279
+ [RELEASE.md](RELEASE.md). The 2026-10-16 native check (FontLab 9.0.9783) covered
280
+ import from this checkout, the installer, the executor tools on an owned font and
281
+ deterministic ACP roundtrips through the fallback executor and native MCP; it did
282
+ not open the dock or run the menu scripts.
283
+
284
+ ## History
285
+
286
+ Aidus Agentus was called Aidus Code (distribution `fontlab-aidus-code`) until
287
+ Issue 242. It absorbed the former `aidus-code` repository; that legacy repository
288
+ is retired, and its verbatim recovery archive (`original/`, `migration.json`) was
289
+ removed from this tree in the rename. Both remain in this repository's Git history
290
+ up to tag `v1.1.7`. The MCP bridge moved to fontlab-remopy, and the API
291
+ introspectors were superseded by fontlab-echopy and fontlab-python-docs.
292
+
293
+ License: proprietary Fontlab Ltd.; original notices retained.
294
+
295
+
296
+ ## Documentation source
297
+
298
+ The maintained site source is [src_docs/md/index.md](src_docs/md/index.md);
299
+ [src_docs/mkdocs.yml](src_docs/mkdocs.yml) configures the locked ProperDocs/MaterialX
300
+ light build. Generated HTML belongs in `docs/`. Private Pages publication remains
301
+ owner-held; local builds do not establish hosted or native behavior.