paintress-cli 0.4.7__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 (76) hide show
  1. paintress_cli-0.4.7/.gitignore +148 -0
  2. paintress_cli-0.4.7/LICENSE +28 -0
  3. paintress_cli-0.4.7/PKG-INFO +77 -0
  4. paintress_cli-0.4.7/README.md +52 -0
  5. paintress_cli-0.4.7/paintress_cli/__init__.py +10 -0
  6. paintress_cli-0.4.7/paintress_cli/app.py +1410 -0
  7. paintress_cli-0.4.7/paintress_cli/browser.py +164 -0
  8. paintress_cli-0.4.7/paintress_cli/cli.py +423 -0
  9. paintress_cli-0.4.7/paintress_cli/config.py +538 -0
  10. paintress_cli-0.4.7/paintress_cli/display.py +884 -0
  11. paintress_cli-0.4.7/paintress_cli/environment.py +122 -0
  12. paintress_cli-0.4.7/paintress_cli/events.py +142 -0
  13. paintress_cli-0.4.7/paintress_cli/hooks.py +96 -0
  14. paintress_cli-0.4.7/paintress_cli/logging.py +277 -0
  15. paintress_cli-0.4.7/paintress_cli/mcp.py +111 -0
  16. paintress_cli-0.4.7/paintress_cli/processes.py +395 -0
  17. paintress_cli-0.4.7/paintress_cli/runtime.py +288 -0
  18. paintress_cli-0.4.7/paintress_cli/session.py +226 -0
  19. paintress_cli-0.4.7/paintress_cli/skills/__init__.py +94 -0
  20. paintress_cli-0.4.7/paintress_cli/skills/building-agents/README.md +113 -0
  21. paintress_cli-0.4.7/paintress_cli/skills/building-agents/SKILL.md +241 -0
  22. paintress_cli-0.4.7/paintress_cli/skills/building-agents/docs/README.md +23 -0
  23. paintress_cli-0.4.7/paintress_cli/skills/building-agents/docs/context.md +150 -0
  24. paintress_cli-0.4.7/paintress_cli/skills/building-agents/docs/environment.md +202 -0
  25. paintress_cli-0.4.7/paintress_cli/skills/building-agents/docs/logging.md +106 -0
  26. paintress_cli-0.4.7/paintress_cli/skills/building-agents/docs/model.md +168 -0
  27. paintress_cli-0.4.7/paintress_cli/skills/building-agents/docs/resumable-resources.md +166 -0
  28. paintress_cli-0.4.7/paintress_cli/skills/building-agents/docs/subagent.md +159 -0
  29. paintress_cli-0.4.7/paintress_cli/skills/building-agents/docs/toolset.md +134 -0
  30. paintress_cli-0.4.7/paintress_cli/skills/building-agents/examples/.env.example +83 -0
  31. paintress_cli-0.4.7/paintress_cli/skills/building-agents/examples/__init__.py +11 -0
  32. paintress_cli-0.4.7/paintress_cli/skills/building-agents/examples/browser_use.py +285 -0
  33. paintress_cli-0.4.7/paintress_cli/skills/building-agents/examples/deepresearch.py +360 -0
  34. paintress_cli-0.4.7/paintress_cli/skills/building-agents/examples/general.py +362 -0
  35. paintress_cli-0.4.7/paintress_cli/skills/building-agents/examples/prompts/browser_use.md +56 -0
  36. paintress_cli-0.4.7/paintress_cli/skills/building-agents/examples/prompts/deepresearch.md +244 -0
  37. paintress_cli-0.4.7/paintress_cli/skills/building-agents/examples/prompts/general.md +73 -0
  38. paintress_cli-0.4.7/paintress_cli/skills/cli-config/SKILL.md +179 -0
  39. paintress_cli-0.4.7/paintress_cli/skills/cli-config/references/presets.md +74 -0
  40. paintress_cli-0.4.7/paintress_cli/skills/skill-creator/LICENSE.txt +202 -0
  41. paintress_cli-0.4.7/paintress_cli/skills/skill-creator/SKILL.md +356 -0
  42. paintress_cli-0.4.7/paintress_cli/skills/skill-creator/references/output-patterns.md +82 -0
  43. paintress_cli-0.4.7/paintress_cli/skills/skill-creator/references/workflows.md +28 -0
  44. paintress_cli-0.4.7/paintress_cli/skills/skill-creator/scripts/init_skill.py +299 -0
  45. paintress_cli-0.4.7/paintress_cli/skills/skill-creator/scripts/package_skill.py +111 -0
  46. paintress_cli-0.4.7/paintress_cli/skills/skill-creator/scripts/quick_validate.py +97 -0
  47. paintress_cli-0.4.7/paintress_cli/steering.py +193 -0
  48. paintress_cli-0.4.7/paintress_cli/templates/config.toml +109 -0
  49. paintress_cli-0.4.7/paintress_cli/templates/env.example +68 -0
  50. paintress_cli-0.4.7/paintress_cli/templates/mcp.json +3 -0
  51. paintress_cli-0.4.7/paintress_cli/templates/system_prompt.md +84 -0
  52. paintress_cli-0.4.7/paintress_cli/templates/tools.toml +7 -0
  53. paintress_cli-0.4.7/paintress_cli/toolsets/__init__.py +19 -0
  54. paintress_cli-0.4.7/paintress_cli/toolsets/process.py +299 -0
  55. paintress_cli-0.4.7/paintress_cli/usage.py +116 -0
  56. paintress_cli-0.4.7/pyproject.toml +52 -0
  57. paintress_cli-0.4.7/spec/00-overview.md +153 -0
  58. paintress_cli-0.4.7/spec/01-event-system.md +559 -0
  59. paintress_cli-0.4.7/spec/02-configuration.md +562 -0
  60. paintress_cli-0.4.7/spec/03-tui-environment.md +595 -0
  61. paintress_cli-0.4.7/spec/04-steering.md +572 -0
  62. paintress_cli-0.4.7/spec/05-browser-integration.md +444 -0
  63. paintress_cli-0.4.7/spec/06-ui-layout.md +517 -0
  64. paintress_cli-0.4.7/spec/07-logging.md +187 -0
  65. paintress_cli-0.4.7/tests/conftest.py +63 -0
  66. paintress_cli-0.4.7/tests/test_browser.py +138 -0
  67. paintress_cli-0.4.7/tests/test_config.py +510 -0
  68. paintress_cli-0.4.7/tests/test_environment.py +111 -0
  69. paintress_cli-0.4.7/tests/test_events_hooks.py +289 -0
  70. paintress_cli-0.4.7/tests/test_logging.py +227 -0
  71. paintress_cli-0.4.7/tests/test_mcp.py +119 -0
  72. paintress_cli-0.4.7/tests/test_processes.py +475 -0
  73. paintress_cli-0.4.7/tests/test_runtime.py +220 -0
  74. paintress_cli-0.4.7/tests/test_steering.py +205 -0
  75. paintress_cli-0.4.7/tests/test_toolsets.py +377 -0
  76. paintress_cli-0.4.7/tests/test_usage.py +115 -0
@@ -0,0 +1,148 @@
1
+ docs/source
2
+
3
+ # From https://raw.githubusercontent.com/github/gitignore/main/Python.gitignore
4
+
5
+ # Byte-compiled / optimized / DLL files
6
+ __pycache__/
7
+ *.py[cod]
8
+ *$py.class
9
+
10
+ # C extensions
11
+ *.so
12
+
13
+ # Distribution / packaging
14
+ .Python
15
+ build/
16
+ develop-eggs/
17
+ dist/
18
+ downloads/
19
+ eggs/
20
+ .eggs/
21
+ lib/
22
+ lib64/
23
+ parts/
24
+ sdist/
25
+ var/
26
+ wheels/
27
+ share/python-wheels/
28
+ *.egg-info/
29
+ .installed.cfg
30
+ *.egg
31
+ MANIFEST
32
+
33
+ # PyInstaller
34
+ # Usually these files are written by a python script from a template
35
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
36
+ *.manifest
37
+ *.spec
38
+
39
+ # Installer logs
40
+ pip-log.txt
41
+ pip-delete-this-directory.txt
42
+
43
+ # Unit test / coverage reports
44
+ htmlcov/
45
+ .tox/
46
+ .nox/
47
+ .coverage
48
+ .coverage.*
49
+ .cache
50
+ nosetests.xml
51
+ coverage.xml
52
+ *.cover
53
+ *.py,cover
54
+ .hypothesis/
55
+ .pytest_cache/
56
+ cover/
57
+
58
+ # Translations
59
+ *.mo
60
+ *.pot
61
+
62
+ # Django stuff:
63
+ *.log
64
+ local_settings.py
65
+ db.sqlite3
66
+ db.sqlite3-journal
67
+
68
+ # Flask stuff:
69
+ instance/
70
+ .webassets-cache
71
+
72
+ # Scrapy stuff:
73
+ .scrapy
74
+
75
+ # Sphinx documentation
76
+ docs/_build/
77
+
78
+ # PyBuilder
79
+ .pybuilder/
80
+ target/
81
+
82
+ # Jupyter Notebook
83
+ .ipynb_checkpoints
84
+
85
+ # IPython
86
+ profile_default/
87
+ ipython_config.py
88
+
89
+ # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
90
+ __pypackages__/
91
+
92
+ # Celery stuff
93
+ celerybeat-schedule
94
+ celerybeat.pid
95
+
96
+ # SageMath parsed files
97
+ *.sage.py
98
+
99
+ # Environments
100
+ .env
101
+ .venv
102
+ env/
103
+ venv/
104
+ ENV/
105
+ env.bak/
106
+ venv.bak/
107
+
108
+ # Spyder project settings
109
+ .spyderproject
110
+ .spyproject
111
+
112
+ # Rope project settings
113
+ .ropeproject
114
+
115
+ # mkdocs documentation
116
+ /site
117
+
118
+ # mypy
119
+ .mypy_cache/
120
+ .pyright/
121
+ .dmypy.json
122
+ dmypy.json
123
+
124
+ # Pyre type checker
125
+ .pyre/
126
+
127
+ # pytype static type analyzer
128
+ .pytype/
129
+
130
+ # Cython debug symbols
131
+ cython_debug/
132
+
133
+ # Vscode config files
134
+ # .vscode/
135
+
136
+ # PyCharm
137
+ # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
138
+ # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
139
+ # and can be added to the global gitignore or merged into this file. For a more nuclear
140
+ # option (not recommended) you can uncomment the following to ignore the entire idea folder.
141
+ #.idea/
142
+
143
+ TO-DO.json
144
+ dev/
145
+ pai_agent_sdk/sandbox/shell/templates/public
146
+
147
+ # Sync automaticlly
148
+ paintress_cli/paintress_cli/skills/building-agents
@@ -0,0 +1,28 @@
1
+ BSD 3-Clause License
2
+
3
+ Copyright (c) 2026, YouWare
4
+
5
+ Redistribution and use in source and binary forms, with or without
6
+ modification, are permitted provided that the following conditions are met:
7
+
8
+ 1. Redistributions of source code must retain the above copyright notice, this
9
+ list of conditions and the following disclaimer.
10
+
11
+ 2. Redistributions in binary form must reproduce the above copyright notice,
12
+ this list of conditions and the following disclaimer in the documentation
13
+ and/or other materials provided with the distribution.
14
+
15
+ 3. Neither the name of the copyright holder nor the names of its
16
+ contributors may be used to endorse or promote products derived from
17
+ this software without specific prior written permission.
18
+
19
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20
+ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
23
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
25
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
26
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
27
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
@@ -0,0 +1,77 @@
1
+ Metadata-Version: 2.4
2
+ Name: paintress-cli
3
+ Version: 0.4.7
4
+ Summary: TUI reference implementation for pai-agent-sdk
5
+ Project-URL: Repository, https://github.com/youware-labs/pai-agent-sdk
6
+ Author-email: youware <lab@youware.com>
7
+ License-File: LICENSE
8
+ Keywords: ai-agent,cli,python,tui
9
+ Classifier: Environment :: Console
10
+ Classifier: Intended Audience :: Developers
11
+ Classifier: Programming Language :: Python
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: Programming Language :: Python :: 3.11
14
+ Classifier: Programming Language :: Python :: 3.12
15
+ Classifier: Programming Language :: Python :: 3.13
16
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
17
+ Requires-Python: <3.14,>=3.11
18
+ Requires-Dist: agent-environment>=0.1.0
19
+ Requires-Dist: click>=8.0
20
+ Requires-Dist: pai-agent-sdk[all]==0.4.7
21
+ Requires-Dist: pydantic-ai
22
+ Requires-Dist: pydantic-settings>=2.0
23
+ Requires-Dist: pydantic>=2.0
24
+ Description-Content-Type: text/markdown
25
+
26
+ # Paintress CLI
27
+
28
+ TUI reference implementation for [pai-agent-sdk](https://github.com/youware-labs/pai-agent-sdk).
29
+
30
+ ## Usage
31
+
32
+ With uvx, run:
33
+
34
+ ```bash
35
+ uvx paintress-cli
36
+ ```
37
+
38
+ Or to install paintress-cli globally with uv, run:
39
+
40
+ ```bash
41
+ uv tool install paintress-cli
42
+ ...
43
+ paintress-cli
44
+ ```
45
+
46
+ To update to the latest version:
47
+
48
+ ```bash
49
+ uv tool upgrade paintress-cli
50
+ ```
51
+
52
+ Or with pip, run:
53
+
54
+ ```bash
55
+ pip install paintress-cli
56
+ ...
57
+ paintress-cli
58
+ ```
59
+
60
+ Or run as a module:
61
+
62
+ ```bash
63
+ python -m paintress_cli
64
+ ```
65
+
66
+ ## Development
67
+
68
+ This package is part of the pai-agent-sdk monorepo. To develop locally:
69
+
70
+ ```bash
71
+ cd pai-agent-sdk
72
+ uv sync --all-packages
73
+ ```
74
+
75
+ ## License
76
+
77
+ BSD 3-Clause License - see [LICENSE](LICENSE) for details.
@@ -0,0 +1,52 @@
1
+ # Paintress CLI
2
+
3
+ TUI reference implementation for [pai-agent-sdk](https://github.com/youware-labs/pai-agent-sdk).
4
+
5
+ ## Usage
6
+
7
+ With uvx, run:
8
+
9
+ ```bash
10
+ uvx paintress-cli
11
+ ```
12
+
13
+ Or to install paintress-cli globally with uv, run:
14
+
15
+ ```bash
16
+ uv tool install paintress-cli
17
+ ...
18
+ paintress-cli
19
+ ```
20
+
21
+ To update to the latest version:
22
+
23
+ ```bash
24
+ uv tool upgrade paintress-cli
25
+ ```
26
+
27
+ Or with pip, run:
28
+
29
+ ```bash
30
+ pip install paintress-cli
31
+ ...
32
+ paintress-cli
33
+ ```
34
+
35
+ Or run as a module:
36
+
37
+ ```bash
38
+ python -m paintress_cli
39
+ ```
40
+
41
+ ## Development
42
+
43
+ This package is part of the pai-agent-sdk monorepo. To develop locally:
44
+
45
+ ```bash
46
+ cd pai-agent-sdk
47
+ uv sync --all-packages
48
+ ```
49
+
50
+ ## License
51
+
52
+ BSD 3-Clause License - see [LICENSE](LICENSE) for details.
@@ -0,0 +1,10 @@
1
+ """Paintress CLI - TUI for AI agents."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import importlib.metadata
6
+
7
+ try:
8
+ __version__ = importlib.metadata.version(__name__)
9
+ except importlib.metadata.PackageNotFoundError:
10
+ __version__ = "0.0.0"