fontlab-aidus-agentus 1.1.14__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.
- fontlab_aidus_agentus-1.1.14/.gitignore +23 -0
- fontlab_aidus_agentus-1.1.14/CONFIGURE.md +89 -0
- fontlab_aidus_agentus-1.1.14/DEPENDENCIES.md +64 -0
- fontlab_aidus_agentus-1.1.14/LICENSE +12 -0
- fontlab_aidus_agentus-1.1.14/LICENSE-3RD-PARTY.md +47 -0
- fontlab_aidus_agentus-1.1.14/PKG-INFO +301 -0
- fontlab_aidus_agentus-1.1.14/README.md +268 -0
- fontlab_aidus_agentus-1.1.14/RELEASE.md +29 -0
- fontlab_aidus_agentus-1.1.14/Scripts/Aidus Agentus/Enable FontLab MCP.py +14 -0
- fontlab_aidus_agentus-1.1.14/Scripts/Aidus Agentus/Open Configuration.py +14 -0
- fontlab_aidus_agentus-1.1.14/Scripts/Aidus Agentus/README.md +28 -0
- fontlab_aidus_agentus-1.1.14/Scripts/Aidus Agentus/Start Aidus Agentus.py +14 -0
- fontlab_aidus_agentus-1.1.14/conftest.py +35 -0
- fontlab_aidus_agentus-1.1.14/install.vfpy +39 -0
- fontlab_aidus_agentus-1.1.14/pyproject.toml +66 -0
- fontlab_aidus_agentus-1.1.14/run_in_fontlab/check_aidus_in_fontlab.vfpy +54 -0
- fontlab_aidus_agentus-1.1.14/run_in_fontlab/enable_fontlab_mcp.vfpy +4 -0
- fontlab_aidus_agentus-1.1.14/run_in_fontlab/introspect_pythonqt.vfpy +89 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/__init__.py +20 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/boot.py +19 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core/__init__.py +15 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core/acp_server.py +72 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core/agents.yml +120 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core/boot.py +96 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core/config.py +111 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core/errors.py +62 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core/fontlab_mcp.py +144 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core/health.py +65 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core/plugin_tools.py +49 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core/prompts/__init__.py +3 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core/prompts/fontlab_api.md +246 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core/py.typed +0 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core/py_version_check.py +21 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/core_launcher.py +4 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/install.py +468 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/launchers.py +130 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/plugin/__init__.py +62 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/plugin/brain_log.py +91 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/plugin/client.py +548 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/plugin/config.py +189 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/plugin/executor.py +643 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/plugin/main.py +235 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/plugin/transport.py +849 -0
- fontlab_aidus_agentus-1.1.14/src/fontlab_aidus_agentus/plugin/ui.py +575 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/LICENSE +12 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/LICENSE-3RD-PARTY.txt +47 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/@fortawesome-fontawesome-free/LICENSE.txt.txt +165 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/@mdi-svg/LICENSE.txt +20 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/@primer-octicons/LICENSE.txt +21 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/clipboard/LICENSE.txt +21 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/delegate/readme.md.txt +3 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/escape-html/LICENSE.txt +24 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/focus-visible/LICENSE.md.txt +5 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/good-listener/readme.md.txt +3 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/lucide-static/LICENSE.txt +43 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/lunr/LICENSE.txt +19 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/material-design-color/LICENSE.txt +21 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/retained/apache-2.0.txt.txt +201 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/retained/cc-by-4.0.txt.txt +156 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/retained/materialx-10.1.8-LICENSE.txt +19 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/retained/mit-basecoat-css.txt.txt +21 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/retained/mit-daisyui.txt.txt +21 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/retained/mit-tailwindcss.txt.txt +21 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/retained/ofl-roboto.txt.txt +93 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/retained/ofl-robotomono.txt.txt +93 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/retained/w3c-focus-visible.txt.txt +26 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/rxjs/LICENSE.txt.txt +202 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/select/readme.md.txt +3 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/tiny-emitter/LICENSE.txt +22 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/tslib/CopyrightNotice.txt.txt +15 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend/tslib/LICENSE.txt.txt +12 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/current-frontend-notices.json +2065 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/assets/english-search-omissions.json +503 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/configure.md +90 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/development-and-limits.md +54 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/dock-and-acp.md +120 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/guides/architecture.md +120 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/guides/assets/icon.png +0 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/guides/external-agents-mcp.md +177 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/guides/fontlab-installations.md +186 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/guides/fontlab-mcp.md +104 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/guides/manual-tests.md +101 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/guides/troubleshooting.md +61 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/index.md +40 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/installation.md +62 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/licence.md +54 -0
- fontlab_aidus_agentus-1.1.14/src_docs/md/stylesheets/local.css +2 -0
- fontlab_aidus_agentus-1.1.14/stubs/PythonQt/__init__.pyi +47 -0
- fontlab_aidus_agentus-1.1.14/stubs/fl.pyi +19 -0
- fontlab_aidus_agentus-1.1.14/test.sh +19 -0
- fontlab_aidus_agentus-1.1.14/tests/conftest.py +217 -0
- fontlab_aidus_agentus-1.1.14/tests/core/__init__.py +3 -0
- fontlab_aidus_agentus-1.1.14/tests/core/conftest.py +29 -0
- fontlab_aidus_agentus-1.1.14/tests/core/fixtures/acp_core.py +21 -0
- fontlab_aidus_agentus-1.1.14/tests/core/fixtures/mcp_server.py +26 -0
- fontlab_aidus_agentus-1.1.14/tests/core/test_acp_server.py +105 -0
- fontlab_aidus_agentus-1.1.14/tests/core/test_agents_yml.py +324 -0
- fontlab_aidus_agentus-1.1.14/tests/core/test_boot.py +30 -0
- fontlab_aidus_agentus-1.1.14/tests/core/test_boot_serve.py +122 -0
- fontlab_aidus_agentus-1.1.14/tests/core/test_config.py +45 -0
- fontlab_aidus_agentus-1.1.14/tests/core/test_errors.py +29 -0
- fontlab_aidus_agentus-1.1.14/tests/core/test_fontlab_mcp.py +94 -0
- fontlab_aidus_agentus-1.1.14/tests/core/test_health.py +43 -0
- fontlab_aidus_agentus-1.1.14/tests/core/test_mcp_roundtrip.py +202 -0
- fontlab_aidus_agentus-1.1.14/tests/core/test_plugin_tools.py +153 -0
- fontlab_aidus_agentus-1.1.14/tests/plugin/__init__.py +1 -0
- fontlab_aidus_agentus-1.1.14/tests/plugin/conftest.py +413 -0
- fontlab_aidus_agentus-1.1.14/tests/plugin/test_acp_protocol.py +449 -0
- fontlab_aidus_agentus-1.1.14/tests/plugin/test_client.py +234 -0
- fontlab_aidus_agentus-1.1.14/tests/plugin/test_config.py +196 -0
- fontlab_aidus_agentus-1.1.14/tests/plugin/test_edge_cases.py +393 -0
- fontlab_aidus_agentus-1.1.14/tests/plugin/test_enable_mcp.py +20 -0
- fontlab_aidus_agentus-1.1.14/tests/plugin/test_executor.py +169 -0
- fontlab_aidus_agentus-1.1.14/tests/plugin/test_mcp_acp_client.py +100 -0
- fontlab_aidus_agentus-1.1.14/tests/plugin/test_transport.py +342 -0
- fontlab_aidus_agentus-1.1.14/tests/plugin/test_ui_formatting.py +198 -0
- fontlab_aidus_agentus-1.1.14/tests/test_active_glyph_read.py +133 -0
- fontlab_aidus_agentus-1.1.14/tests/test_automatic_metric_guard.py +174 -0
- fontlab_aidus_agentus-1.1.14/tests/test_brain_edges.py +166 -0
- fontlab_aidus_agentus-1.1.14/tests/test_brain_log.py +97 -0
- fontlab_aidus_agentus-1.1.14/tests/test_client_protocol.py +284 -0
- fontlab_aidus_agentus-1.1.14/tests/test_dependency_pins.py +29 -0
- fontlab_aidus_agentus-1.1.14/tests/test_executor_config_edges.py +402 -0
- fontlab_aidus_agentus-1.1.14/tests/test_executor_preflight_errors.py +38 -0
- fontlab_aidus_agentus-1.1.14/tests/test_fly_examples.py +80 -0
- fontlab_aidus_agentus-1.1.14/tests/test_help_resources.py +49 -0
- fontlab_aidus_agentus-1.1.14/tests/test_info_read_preservation.py +67 -0
- fontlab_aidus_agentus-1.1.14/tests/test_install.py +803 -0
- fontlab_aidus_agentus-1.1.14/tests/test_native_boundaries.py +251 -0
- fontlab_aidus_agentus-1.1.14/tests/test_plugin_boot_integration.py +176 -0
- fontlab_aidus_agentus-1.1.14/tests/test_plugin_main.py +448 -0
- fontlab_aidus_agentus-1.1.14/tests/test_production_entrypoint.py +57 -0
- fontlab_aidus_agentus-1.1.14/tests/test_registered_unicode.py +87 -0
- fontlab_aidus_agentus-1.1.14/tests/test_residue_port.py +80 -0
- fontlab_aidus_agentus-1.1.14/tests/test_scripts_menu.py +422 -0
- fontlab_aidus_agentus-1.1.14/tests/test_standalone_install.py +64 -0
- fontlab_aidus_agentus-1.1.14/tests/test_transport_boundaries.py +149 -0
- fontlab_aidus_agentus-1.1.14/tests/test_transport_process.py +473 -0
- fontlab_aidus_agentus-1.1.14/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.14
|
|
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.
|