aelix-agent-core 0.1.0b2__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 (44) hide show
  1. aelix_agent_core-0.1.0b2/.gitignore +150 -0
  2. aelix_agent_core-0.1.0b2/LICENSE +201 -0
  3. aelix_agent_core-0.1.0b2/NOTICE +15 -0
  4. aelix_agent_core-0.1.0b2/PKG-INFO +55 -0
  5. aelix_agent_core-0.1.0b2/README.md +26 -0
  6. aelix_agent_core-0.1.0b2/THIRD-PARTY-NOTICES.md +84 -0
  7. aelix_agent_core-0.1.0b2/pyproject.toml +86 -0
  8. aelix_agent_core-0.1.0b2/src/aelix_agent_core/__init__.py +97 -0
  9. aelix_agent_core-0.1.0b2/src/aelix_agent_core/agent.py +190 -0
  10. aelix_agent_core-0.1.0b2/src/aelix_agent_core/contracts/__init__.py +118 -0
  11. aelix_agent_core-0.1.0b2/src/aelix_agent_core/contracts/api_level.py +51 -0
  12. aelix_agent_core-0.1.0b2/src/aelix_agent_core/contracts/descriptor.py +157 -0
  13. aelix_agent_core-0.1.0b2/src/aelix_agent_core/contracts/manifest.py +340 -0
  14. aelix_agent_core-0.1.0b2/src/aelix_agent_core/contracts/primitives.py +100 -0
  15. aelix_agent_core-0.1.0b2/src/aelix_agent_core/contracts/slots.py +49 -0
  16. aelix_agent_core-0.1.0b2/src/aelix_agent_core/default_convert.py +29 -0
  17. aelix_agent_core-0.1.0b2/src/aelix_agent_core/harness/__init__.py +128 -0
  18. aelix_agent_core-0.1.0b2/src/aelix_agent_core/harness/_extension_runner.py +328 -0
  19. aelix_agent_core-0.1.0b2/src/aelix_agent_core/harness/_fork_point.py +22 -0
  20. aelix_agent_core-0.1.0b2/src/aelix_agent_core/harness/_frontmatter.py +75 -0
  21. aelix_agent_core-0.1.0b2/src/aelix_agent_core/harness/_session_stats.py +283 -0
  22. aelix_agent_core-0.1.0b2/src/aelix_agent_core/harness/core.py +4815 -0
  23. aelix_agent_core-0.1.0b2/src/aelix_agent_core/harness/hooks.py +2735 -0
  24. aelix_agent_core-0.1.0b2/src/aelix_agent_core/harness/prompt_templates.py +350 -0
  25. aelix_agent_core-0.1.0b2/src/aelix_agent_core/harness/skills.py +584 -0
  26. aelix_agent_core-0.1.0b2/src/aelix_agent_core/loop.py +1021 -0
  27. aelix_agent_core-0.1.0b2/src/aelix_agent_core/py.typed +0 -0
  28. aelix_agent_core-0.1.0b2/src/aelix_agent_core/runtime/__init__.py +32 -0
  29. aelix_agent_core-0.1.0b2/src/aelix_agent_core/runtime/_types.py +288 -0
  30. aelix_agent_core-0.1.0b2/src/aelix_agent_core/runtime/agent_session_runtime.py +1225 -0
  31. aelix_agent_core-0.1.0b2/src/aelix_agent_core/session/__init__.py +141 -0
  32. aelix_agent_core-0.1.0b2/src/aelix_agent_core/session/branch_summarization.py +356 -0
  33. aelix_agent_core-0.1.0b2/src/aelix_agent_core/session/compaction.py +1223 -0
  34. aelix_agent_core-0.1.0b2/src/aelix_agent_core/session/context.py +422 -0
  35. aelix_agent_core-0.1.0b2/src/aelix_agent_core/session/entries.py +547 -0
  36. aelix_agent_core-0.1.0b2/src/aelix_agent_core/session/fs.py +274 -0
  37. aelix_agent_core-0.1.0b2/src/aelix_agent_core/session/jsonl_repo.py +530 -0
  38. aelix_agent_core-0.1.0b2/src/aelix_agent_core/session/jsonl_storage.py +601 -0
  39. aelix_agent_core-0.1.0b2/src/aelix_agent_core/session/memory_storage.py +174 -0
  40. aelix_agent_core-0.1.0b2/src/aelix_agent_core/session/repo_utils.py +82 -0
  41. aelix_agent_core-0.1.0b2/src/aelix_agent_core/session/session.py +329 -0
  42. aelix_agent_core-0.1.0b2/src/aelix_agent_core/session/session_cwd.py +200 -0
  43. aelix_agent_core-0.1.0b2/src/aelix_agent_core/session/storage.py +101 -0
  44. aelix_agent_core-0.1.0b2/src/aelix_agent_core/types.py +367 -0
@@ -0,0 +1,150 @@
1
+ # Python
2
+ __pycache__/
3
+ *.py[cod]
4
+ *$py.class
5
+ *.egg-info/
6
+ build/
7
+ dist/
8
+ .coverage
9
+ .pytest_cache/
10
+
11
+ # Virtual environments
12
+ .venv/
13
+ venv/
14
+
15
+ # Local environment
16
+ .env
17
+ .env.local
18
+ # Plaintext key dumps carried between machines. `.env` above covers the file the
19
+ # code reads; these cover the shapes it arrives in. Neither is in the pyproject
20
+ # `exclude` lists, so this file is their only guard — see the `.claude` block
21
+ # below for why that distinction matters.
22
+ env.txt
23
+
24
+ # Container-escape exports (RESTORE.md). Root-level and large, and the sdist's
25
+ # default file set is the whole repo root, so an unignored one ships.
26
+ /aelix-export-*.tar.gz
27
+
28
+ # Editor / OS
29
+ .DS_Store
30
+ .idea/
31
+ .vscode/
32
+
33
+ # Agent / OMC developer state — never publish (#111 B-7).
34
+ #
35
+ # The previous rules were `.omc/state/` + `.omc/sessions/`. A gitignore pattern
36
+ # with a slash in the middle is ANCHORED to the directory holding the .gitignore,
37
+ # so those two matched ONLY `/.omc/state/` at the repo root. A nested
38
+ # `packages/aelix-coding-agent/src/aelix_coding_agent/.omc/state/` escaped them
39
+ # entirely, stayed untracked-but-present on a maintainer's disk, and hatchling
40
+ # (which honours these ignore rules when selecting build files) swept maintainer
41
+ # session transcripts straight into the published wheel and sdist.
42
+ #
43
+ # A NESTED `.omc` is always developer state and is ignored at any depth, which is
44
+ # what closes the leak. The REPO-ROOT `.omc/` is different: `.omc/specs/` is the
45
+ # committed sprint-plan record, not scratch — 50 files are tracked there and every
46
+ # recent sprint (P2, P3, W1-A, #114, #118) commits its plan alongside the code it
47
+ # describes. Requiring `git add -f` for those is friction pointed at the wrong
48
+ # thing: P1's plan was written, left unstaged, and lost exactly that way.
49
+ #
50
+ # So: ignore everything directly under the root `.omc/` EXCEPT `specs/`. Git
51
+ # cannot re-include a path whose parent directory is excluded, which is why this
52
+ # is `/.omc/*` (contents) rather than `/.omc/` (the directory itself).
53
+ #
54
+ # Publishing is NOT what this rule protects — the wheel and sdist are guarded
55
+ # independently by the `exclude` blocks in each pyproject, proven by
56
+ # `tests/packaging/test_build_hygiene.py`: strip `.omc` from those excludes and
57
+ # planted state leaks into the wheel even with this file untouched.
58
+ /.omc/*
59
+ !/.omc/specs/
60
+ **/*/.omc/
61
+ .ruff_cache/
62
+
63
+ # Agent instruction files — local to a maintainer's checkout, not product.
64
+ CLAUDE.md
65
+ AGENTS.md
66
+
67
+ # Exported TUI session transcripts (`/export`) land in the CWD.
68
+ aelix-session-*.html
69
+
70
+ # Claude Code per-checkout state (#143).
71
+ #
72
+ # This used to be just `.claude/settings.local.json`, with the rest of `.claude/`
73
+ # covered by `.git/info/exclude`. That file is PER-CLONE and does not travel, so
74
+ # the protection existed only on the machines that had already set it up — and
75
+ # hatchling, which selects build files by honouring VCS ignore rules, had nothing
76
+ # to go on here. A maintainer's local `uv build --sdist` at ee1623c swept
77
+ # `.claude/worktrees/` into the tarball — complete internal working copies of this
78
+ # repo, one directory per agent session, uncommitted work included — ready to be
79
+ # attached to a public GitHub Release.
80
+ #
81
+ # HOW BIG IS A MOVING TARGET, so do not read the figures as a size. Three builds
82
+ # of that SAME commit, same machine, measured 1,994 entries under
83
+ # `.claude/worktrees/` in a 20,039,596-byte tarball; then 4,112 six minutes
84
+ # later; then 7,233 in a 48,004,955-byte tarball later the same day. The commit
85
+ # never changed — agents kept creating worktrees. Each number is a floor observed
86
+ # at a moment, and it rises for as long as this repo is worked on by agents.
87
+ #
88
+ # `.claude/` is developer state, and the repo root's copy is ignored wholesale
89
+ # (all but one file — see the exception below). Publishing is guarded
90
+ # independently by the `exclude` blocks in every pyproject (most of
91
+ # tests/packaging/test_build_hygiene.py deletes this file before building,
92
+ # precisely so the excludes are what gets measured) — this rule is the belt.
93
+ #
94
+ # The live agent worktrees under `.claude/worktrees/` are registered in
95
+ # `.git/worktrees/`, not by being tracked, so ignoring the directory does not
96
+ # disturb them: `git worktree list` is unaffected.
97
+ #
98
+ # ONE EXCEPTION, `.claude/settings.json`: Claude Code's documented CHECKED-IN
99
+ # team configuration (`settings.local.json` is the personal sibling and stays
100
+ # ignored). Nothing tracks it today — `git ls-files .claude/` is empty — so this
101
+ # breaks nothing now; it exists so that a maintainer who adds team settings
102
+ # tomorrow does not watch git silently swallow them.
103
+ #
104
+ # THE FOUR LINES ARE NOT INTERCHANGEABLE. Git cannot re-include a path whose
105
+ # parent directory is excluded, so the obvious `.claude/` + `!/.claude/settings.json`
106
+ # does NOT work — measured, the file stays ignored by `.claude/`. The root
107
+ # directory has to be re-admitted (`!/.claude/`), its contents re-excluded
108
+ # (`/.claude/*`, which keeps git from descending into `worktrees/`), and only then
109
+ # can the one file be named.
110
+ #
111
+ # AND EVERY ONE OF THEM IS ANCHORED, WHICH IS THE OPPOSITE OF THE `.omc` RULE
112
+ # ABOVE — deliberately, and it cost a build to learn. The agent worktrees this
113
+ # repo is developed in LIVE under `.claude/worktrees/`, so a build run from one
114
+ # has `.claude` sitting in its own root path. An UNANCHORED rule naming that
115
+ # directory therefore matches the build root itself, and hatchling responds by
116
+ # discarding this entire file for that build: measured twice, first with
117
+ # `.claude/` and again with `**/*/.claude/`, and both times a planted `.env.local`
118
+ # — a file only this rule excludes, in a repo whose real `.env` holds provider
119
+ # keys and a PyPI token — shipped into the sdist. Anchoring to `/.claude/` fixed
120
+ # it in the same tree, same command. The cost is real and accepted: a nested
121
+ # `packages/**/.claude/` is no longer ignored by git. It still reaches no
122
+ # artifact, because the pyproject `exclude` lists name `.claude` unanchored and
123
+ # those are read as build config rather than as VCS rules, so they do not trip
124
+ # this. `.omc` can use the `**/*/` form for the same job only because nothing
125
+ # ever builds from inside a `.omc/` directory.
126
+ #
127
+ # AND THE NEGATION CHANGES WHAT THE BUILD SHIPS, which is not obvious and was not
128
+ # free. hatchling reads THIS FILE and concatenates its lines with the pyproject
129
+ # `exclude` patterns into one gitignore spec, and in that spec a pattern matching
130
+ # the FILE outranks a pattern matching its parent DIRECTORY no matter which came
131
+ # later — so `!/.claude/settings.json` here beat `.claude` there, and a real
132
+ # `uv build --sdist` shipped `.claude/settings.json` into the tarball. Every
133
+ # pyproject `exclude` list therefore names that exact path as well. Keep the two
134
+ # in step: a negation added here needs its counterpart there, or this file
135
+ # quietly re-opens #143 one path at a time.
136
+ #
137
+ # With both in place the halves are independent again, as intended: git MAY track
138
+ # that one file, and it still reaches no artifact.
139
+ # tests/packaging/test_build_hygiene.py proves the second half by building with
140
+ # this file present — the older fixtures there delete it on purpose and so cannot
141
+ # see this interaction at all.
142
+ /.claude/
143
+ !/.claude/
144
+ /.claude/*
145
+ !/.claude/settings.json
146
+
147
+ # Name-reservation build output (scripts/reserve_*_names.py) — regenerable
148
+ /dist-reservation/
149
+ /npm-reservation/
150
+ /.reservation-build/
@@ -0,0 +1,201 @@
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity authorized by
13
+ the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all
16
+ other entities that control, are controlled by, or are under common
17
+ control with that entity. For the purposes of this definition,
18
+ "control" means (i) the power, direct or indirect, to cause the
19
+ direction or management of such entity, whether by contract or
20
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
+ outstanding shares, or (iii) beneficial ownership of such entity.
22
+
23
+ "You" (or "Your") shall mean an individual or Legal Entity
24
+ exercising permissions granted by this License.
25
+
26
+ "Source" form shall mean the preferred form for making modifications,
27
+ including but not limited to software source code, documentation
28
+ source, and configuration files.
29
+
30
+ "Object" form shall mean any form resulting from mechanical
31
+ transformation or translation of a Source form, including but
32
+ not limited to compiled object code, generated documentation,
33
+ and conversions to other media types.
34
+
35
+ "Work" shall mean the work of authorship, whether in Source or
36
+ Object form, made available under the License, as indicated by a
37
+ copyright notice that is included in or attached to the work
38
+ (an example is provided in the Appendix below).
39
+
40
+ "Derivative Works" shall mean any work, whether in Source or Object
41
+ form, that is based on (or derived from) the Work and for which the
42
+ editorial revisions, annotations, elaborations, or other modifications
43
+ represent, as a whole, an original work of authorship. For the purposes
44
+ of this License, Derivative Works shall not include works that remain
45
+ separable from, or merely link (or bind by name) to the interfaces of,
46
+ the Work and Derivative Works thereof.
47
+
48
+ "Contribution" shall mean any work of authorship, including
49
+ the original version of the Work and any modifications or additions
50
+ to that Work or Derivative Works thereof, that is intentionally
51
+ submitted to Licensor for inclusion in the Work by the copyright owner
52
+ or by an individual or Legal Entity authorized to submit on behalf of
53
+ the copyright owner. For the purposes of this definition, "submitted"
54
+ means any form of electronic, verbal, or written communication sent
55
+ to the Licensor or its representatives, including but not limited to
56
+ communication on electronic mailing lists, source code control systems,
57
+ and issue tracking systems that are managed by, or on behalf of, the
58
+ Licensor for the purpose of discussing and improving the Work, but
59
+ excluding communication that is conspicuously marked or otherwise
60
+ designated in writing by the copyright owner as "Not a Contribution."
61
+
62
+ "Contributor" shall mean Licensor and any individual or Legal Entity
63
+ on behalf of whom a Contribution has been received by Licensor and
64
+ subsequently incorporated within the Work.
65
+
66
+ 2. Grant of Copyright License. Subject to the terms and conditions of
67
+ this License, each Contributor hereby grants to You a perpetual,
68
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
+ copyright license to reproduce, prepare Derivative Works of,
70
+ publicly display, publicly perform, sublicense, and distribute the
71
+ Work and such Derivative Works in Source or Object form.
72
+
73
+ 3. Grant of Patent License. Subject to the terms and conditions of
74
+ this License, each Contributor hereby grants to You a perpetual,
75
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
+ (except as stated in this section) patent license to make, have made,
77
+ use, offer to sell, sell, import, and otherwise transfer the Work,
78
+ where such license applies only to those patent claims licensable
79
+ by such Contributor that are necessarily infringed by their
80
+ Contribution(s) alone or by combination of their Contribution(s)
81
+ with the Work to which such Contribution(s) was submitted. If You
82
+ institute patent litigation against any entity (including a
83
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
84
+ or a Contribution incorporated within the Work constitutes direct
85
+ or contributory patent infringement, then any patent licenses
86
+ granted to You under this License for that Work shall terminate
87
+ as of the date such litigation is filed.
88
+
89
+ 4. Redistribution. You may reproduce and distribute copies of the
90
+ Work or Derivative Works thereof in any medium, with or without
91
+ modifications, and in Source or Object form, provided that You
92
+ meet the following conditions:
93
+
94
+ (a) You must give any other recipients of the Work or
95
+ Derivative Works a copy of this License; and
96
+
97
+ (b) You must cause any modified files to carry prominent notices
98
+ stating that You changed the files; and
99
+
100
+ (c) You must retain, in the Source form of any Derivative Works
101
+ that You distribute, all copyright, patent, trademark, and
102
+ attribution notices from the Source form of the Work,
103
+ excluding those notices that do not pertain to any part of
104
+ the Derivative Works; and
105
+
106
+ (d) If the Work includes a "NOTICE" text file as part of its
107
+ distribution, then any Derivative Works that You distribute must
108
+ include a readable copy of the attribution notices contained
109
+ within such NOTICE file, excluding those notices that do not
110
+ pertain to any part of the Derivative Works, in at least one
111
+ of the following places: within a NOTICE text file distributed
112
+ as part of the Derivative Works; within the Source form or
113
+ documentation, if provided along with the Derivative Works; or,
114
+ within a display generated by the Derivative Works, if and
115
+ wherever such third-party notices normally appear. The contents
116
+ of the NOTICE file are for informational purposes only and
117
+ do not modify the License. You may add Your own attribution
118
+ notices within Derivative Works that You distribute, alongside
119
+ or as an addendum to the NOTICE text from the Work, provided
120
+ that such additional attribution notices cannot be construed
121
+ as modifying the License.
122
+
123
+ You may add Your own copyright statement to Your modifications and
124
+ may provide additional or different license terms and conditions
125
+ for use, reproduction, or distribution of Your modifications, or
126
+ for any such Derivative Works as a whole, provided Your use,
127
+ reproduction, and distribution of the Work otherwise complies with
128
+ the conditions stated in this License.
129
+
130
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
131
+ any Contribution intentionally submitted for inclusion in the Work
132
+ by You to the Licensor shall be under the terms and conditions of
133
+ this License, without any additional terms or conditions.
134
+ Notwithstanding the above, nothing herein shall supersede or modify
135
+ the terms of any separate license agreement you may have executed
136
+ with Licensor regarding such Contributions.
137
+
138
+ 6. Trademarks. This License does not grant permission to use the trade
139
+ names, trademarks, service marks, or product names of the Licensor,
140
+ except as required for reasonable and customary use in describing the
141
+ origin of the Work and reproducing the content of the NOTICE file.
142
+
143
+ 7. Disclaimer of Warranty. Unless required by applicable law or
144
+ agreed to in writing, Licensor provides the Work (and each
145
+ Contributor provides its Contributions) on an "AS IS" BASIS,
146
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
+ implied, including, without limitation, any warranties or conditions
148
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
+ PARTICULAR PURPOSE. You are solely responsible for determining the
150
+ appropriateness of using or redistributing the Work and assume any
151
+ risks associated with Your exercise of permissions under this License.
152
+
153
+ 8. Limitation of Liability. In no event and under no legal theory,
154
+ whether in tort (including negligence), contract, or otherwise,
155
+ unless required by applicable law (such as deliberate and grossly
156
+ negligent acts) or agreed to in writing, shall any Contributor be
157
+ liable to You for damages, including any direct, indirect, special,
158
+ incidental, or consequential damages of any character arising as a
159
+ result of this License or out of the use or inability to use the
160
+ Work (including but not limited to damages for loss of goodwill,
161
+ work stoppage, computer failure or malfunction, or any and all
162
+ other commercial damages or losses), even if such Contributor
163
+ has been advised of the possibility of such damages.
164
+
165
+ 9. Accepting Warranty or Additional Liability. While redistributing
166
+ the Work or Derivative Works thereof, You may choose to offer,
167
+ and charge a fee for, acceptance of support, warranty, indemnity,
168
+ or other liability obligations and/or rights consistent with this
169
+ License. However, in accepting such obligations, You may act only
170
+ on Your own behalf and on Your sole responsibility, not on behalf
171
+ of any other Contributor, and only if You agree to indemnify,
172
+ defend, and hold each Contributor harmless for any liability
173
+ incurred by, or claims asserted against, such Contributor by reason
174
+ of your accepting any such warranty or additional liability.
175
+
176
+ END OF TERMS AND CONDITIONS
177
+
178
+ APPENDIX: How to apply the Apache License to your work.
179
+
180
+ To apply the Apache License to your work, attach the following
181
+ boilerplate notice, with the fields enclosed by brackets "[]"
182
+ replaced with your own identifying information. (Don't include
183
+ the brackets!) The text should be enclosed in the appropriate
184
+ comment syntax for the file format. We also recommend that a
185
+ file or class name and description of purpose be included on the
186
+ same "printed page" as the copyright notice for easier
187
+ identification within third-party archives.
188
+
189
+ Copyright [yyyy] [name of copyright owner]
190
+
191
+ Licensed under the Apache License, Version 2.0 (the "License");
192
+ you may not use this file except in compliance with the License.
193
+ You may obtain a copy of the License at
194
+
195
+ http://www.apache.org/licenses/LICENSE-2.0
196
+
197
+ Unless required by applicable law or agreed to in writing, software
198
+ distributed under the License is distributed on an "AS IS" BASIS,
199
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
+ See the License for the specific language governing permissions and
201
+ limitations under the License.
@@ -0,0 +1,15 @@
1
+ Aelix
2
+ Copyright 2026 Aelix Contributors
3
+
4
+ This product includes software derived from pi
5
+ (https://github.com/earendil-works/pi), Copyright (c) 2025 Mario Zechner,
6
+ licensed under the MIT License. Substantial portions of Aelix are a
7
+ TypeScript-to-Python port of pi (reference commit earendil-works/pi@734e08e).
8
+ The full MIT license text and copyright notice are reproduced in
9
+ THIRD-PARTY-NOTICES.md, which accompanies this file in all source and
10
+ binary distributions of Aelix.
11
+
12
+ The bundled model catalog (aelix_ai/models_generated.json) is derived from
13
+ pi's generated catalog, which is in turn generated from data published by
14
+ models.dev (https://github.com/sst/models.dev), Copyright (c) 2025
15
+ models.dev, licensed under the MIT License.
@@ -0,0 +1,55 @@
1
+ Metadata-Version: 2.5
2
+ Name: aelix-agent-core
3
+ Version: 0.1.0b2
4
+ Summary: Aelix agent loop + harness + hook bus. Pi-agent-core parity.
5
+ Project-URL: Homepage, https://github.com/handochan/aelix-ai
6
+ Project-URL: Repository, https://github.com/handochan/aelix-ai
7
+ Project-URL: Issues, https://github.com/handochan/aelix-ai/issues
8
+ Author: Aelix Contributors
9
+ License-Expression: Apache-2.0
10
+ License-File: LICENSE
11
+ License-File: NOTICE
12
+ License-File: THIRD-PARTY-NOTICES.md
13
+ Keywords: agent,agent-loop,ai,harness,hooks,llm
14
+ Classifier: Development Status :: 4 - Beta
15
+ Classifier: Intended Audience :: Developers
16
+ Classifier: Operating System :: MacOS
17
+ Classifier: Operating System :: POSIX :: Linux
18
+ Classifier: Programming Language :: Python :: 3
19
+ Classifier: Programming Language :: Python :: 3.11
20
+ Classifier: Programming Language :: Python :: 3.12
21
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
22
+ Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
23
+ Requires-Python: >=3.11
24
+ Requires-Dist: aelix-ai==0.1.0b2
25
+ Requires-Dist: pathspec>=0.12
26
+ Requires-Dist: pydantic<3,>=2.7
27
+ Requires-Dist: pyyaml>=6.0
28
+ Description-Content-Type: text/markdown
29
+
30
+ # aelix-agent-core
31
+
32
+ The low-level agent runtime for [Aelix](https://github.com/handochan/aelix-ai):
33
+ the stateful `Agent`, the hook-aware `AgentHarness`, the typed `HookBus`, and the
34
+ async agent loop. Core runtime with no extension dependencies. Pi-agent-core
35
+ parity.
36
+
37
+ This package is part of the Aelix distribution set. For the full runtime, install
38
+ the umbrella package:
39
+
40
+ ```bash
41
+ pip install aelix
42
+ ```
43
+
44
+ > **Below `0.1.0b2` that command installs a placeholder, not Aelix.** The PyPI
45
+ > names were reserved by a metadata-only `0.0.0a0` pre-release, and with nothing
46
+ > but pre-releases on the index pip takes the newest — so it reported success and
47
+ > left you with no `aelix` command. From `0.1.0b2` on a pre-release tag publishes
48
+ > the real distribution (ADR-0240) and the command above resolves it. The
49
+ > checksum-verified installer described in the project README is still the
50
+ > recommended path: it is the only one that verifies the wheels it installs.
51
+
52
+ See the [project README](https://github.com/handochan/aelix-ai#readme) for
53
+ architecture, usage, and the CLI/TUI.
54
+
55
+ Licensed under Apache-2.0.
@@ -0,0 +1,26 @@
1
+ # aelix-agent-core
2
+
3
+ The low-level agent runtime for [Aelix](https://github.com/handochan/aelix-ai):
4
+ the stateful `Agent`, the hook-aware `AgentHarness`, the typed `HookBus`, and the
5
+ async agent loop. Core runtime with no extension dependencies. Pi-agent-core
6
+ parity.
7
+
8
+ This package is part of the Aelix distribution set. For the full runtime, install
9
+ the umbrella package:
10
+
11
+ ```bash
12
+ pip install aelix
13
+ ```
14
+
15
+ > **Below `0.1.0b2` that command installs a placeholder, not Aelix.** The PyPI
16
+ > names were reserved by a metadata-only `0.0.0a0` pre-release, and with nothing
17
+ > but pre-releases on the index pip takes the newest — so it reported success and
18
+ > left you with no `aelix` command. From `0.1.0b2` on a pre-release tag publishes
19
+ > the real distribution (ADR-0240) and the command above resolves it. The
20
+ > checksum-verified installer described in the project README is still the
21
+ > recommended path: it is the only one that verifies the wheels it installs.
22
+
23
+ See the [project README](https://github.com/handochan/aelix-ai#readme) for
24
+ architecture, usage, and the CLI/TUI.
25
+
26
+ Licensed under Apache-2.0.
@@ -0,0 +1,84 @@
1
+ # Third-Party Notices
2
+
3
+ Aelix is licensed under the Apache License 2.0 (see [LICENSE](LICENSE)). This
4
+ file reproduces the license texts and copyright notices of third-party software
5
+ that Aelix is derived from, as required by those licenses. It accompanies the
6
+ `LICENSE` and `NOTICE` files in all source and binary distributions of Aelix.
7
+
8
+ ## pi (earendil-works/pi)
9
+
10
+ Substantial portions of Aelix are a TypeScript-to-Python port of **pi**
11
+ (<https://github.com/earendil-works/pi>, reference commit `734e08e`): the agent
12
+ loop and harness, session and compaction machinery, provider adapters, built-in
13
+ tools, model registry and generated model catalog, CLI modes, and HTML export
14
+ are derived from the corresponding pi modules. Per-module provenance markers
15
+ (`Pi parity: <file>.ts (SHA 734e08e)`) are preserved in source docstrings.
16
+
17
+ ```
18
+ MIT License
19
+
20
+ Copyright (c) 2025 Mario Zechner
21
+
22
+ Permission is hereby granted, free of charge, to any person obtaining a copy
23
+ of this software and associated documentation files (the "Software"), to deal
24
+ in the Software without restriction, including without limitation the rights
25
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
26
+ copies of the Software, and to permit persons to whom the Software is
27
+ furnished to do so, subject to the following conditions:
28
+
29
+ The above copyright notice and this permission notice shall be included in all
30
+ copies or substantial portions of the Software.
31
+
32
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
33
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
34
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
35
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
36
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
37
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
38
+ SOFTWARE.
39
+ ```
40
+
41
+ ## models.dev (model catalog data)
42
+
43
+ The generated model catalog
44
+ (`packages/aelix-ai/src/aelix_ai/models_generated.json`) is derived from pi's
45
+ `models.generated.ts`, which pi generates from data published by **models.dev**
46
+ (<https://github.com/sst/models.dev> / <https://models.dev>).
47
+
48
+ ```
49
+ MIT License
50
+
51
+ Copyright (c) 2025 models.dev
52
+
53
+ Permission is hereby granted, free of charge, to any person obtaining a copy
54
+ of this software and associated documentation files (the "Software"), to deal
55
+ in the Software without restriction, including without limitation the rights
56
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
57
+ copies of the Software, and to permit persons to whom the Software is
58
+ furnished to do so, subject to the following conditions:
59
+
60
+ The above copyright notice and this permission notice shall be included in all
61
+ copies or substantial portions of the Software.
62
+
63
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
64
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
65
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
66
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
67
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
68
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
69
+ SOFTWARE.
70
+ ```
71
+
72
+ ## Python package dependencies
73
+
74
+ Aelix's wheels and sdists do not vendor or bundle third-party Python packages;
75
+ dependencies are declared as installation requirements and are installed
76
+ separately by pip/uv under their own licenses. The full dependency inventory
77
+ with licenses is recorded in the CycloneDX SBOM under [`sbom/`](sbom/).
78
+
79
+ If you redistribute Aelix *together with* its resolved dependencies (for
80
+ example a frozen binary, a container image, or vendored `site-packages`), you
81
+ must additionally comply with those packages' licenses. In the current locked
82
+ set this notably includes `certifi`, `pathspec`, and parts of `tqdm` (Mozilla
83
+ Public License 2.0 — file-level copyleft: include their license texts and keep
84
+ their source availability).
@@ -0,0 +1,86 @@
1
+ [build-system]
2
+ requires = ["hatchling>=1.27"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "aelix-agent-core"
7
+ version = "0.1.0b2"
8
+ description = "Aelix agent loop + harness + hook bus. Pi-agent-core parity."
9
+ readme = "README.md"
10
+ requires-python = ">=3.11"
11
+ license = "Apache-2.0"
12
+ license-files = ["LICENSE", "NOTICE", "THIRD-PARTY-NOTICES.md"]
13
+ authors = [{ name = "Aelix Contributors" }]
14
+ keywords = ["ai", "agent", "llm", "agent-loop", "harness", "hooks"]
15
+ classifiers = [
16
+ "Development Status :: 4 - Beta",
17
+ "Intended Audience :: Developers",
18
+ "Operating System :: MacOS",
19
+ "Operating System :: POSIX :: Linux",
20
+ "Programming Language :: Python :: 3",
21
+ "Programming Language :: Python :: 3.11",
22
+ "Programming Language :: Python :: 3.12",
23
+ "Topic :: Software Development :: Libraries :: Application Frameworks",
24
+ "Topic :: Scientific/Engineering :: Artificial Intelligence",
25
+ ]
26
+ dependencies = [
27
+ # Pinned to the shared release version; the workspace source below is
28
+ # dev-only and stripped from the built metadata.
29
+ "aelix-ai==0.1.0b2",
30
+ # Sprint 6h₁ (ADR-0069, P-216/P-217): prompt-templates frontmatter
31
+ # parsing + skills .gitignore-style ignore matching.
32
+ "PyYAML>=6.0",
33
+ "pathspec>=0.12",
34
+ # Sprint 6h₉a (ADR-0094/0095/0096): contracts Pydantic models for the
35
+ # 4-tier extension architecture (descriptor envelope, manifest, primitives).
36
+ "pydantic>=2.7,<3",
37
+ ]
38
+
39
+ [project.urls]
40
+ Homepage = "https://github.com/handochan/aelix-ai"
41
+ Repository = "https://github.com/handochan/aelix-ai"
42
+ Issues = "https://github.com/handochan/aelix-ai/issues"
43
+
44
+ [tool.uv.sources]
45
+ aelix-ai = { workspace = true }
46
+
47
+ # #111 B-7 — developer-state exclusions on both targets. See the root
48
+ # pyproject.toml for the rationale. NARROW ON PURPOSE: exact directory names,
49
+ # exact file names and one scoped glob only. Never widen to an extension glob —
50
+ # the distributions carry content files, not only .py sources.
51
+ [tool.hatch.build.targets.wheel]
52
+ packages = ["src/aelix_agent_core"]
53
+ exclude = [
54
+ ".claude",
55
+ ".claude/settings.json",
56
+ ".uv-cache",
57
+ ".omc",
58
+ "__pycache__",
59
+ "*.pyc",
60
+ "*.pyo",
61
+ ".ruff_cache",
62
+ ".pytest_cache",
63
+ "CLAUDE.md",
64
+ "AGENTS.md",
65
+ "aelix-session-*.html",
66
+ ".env",
67
+ ".env.local",
68
+ ]
69
+
70
+ [tool.hatch.build.targets.sdist]
71
+ exclude = [
72
+ ".claude",
73
+ ".claude/settings.json",
74
+ ".uv-cache",
75
+ ".omc",
76
+ "__pycache__",
77
+ "*.pyc",
78
+ "*.pyo",
79
+ ".ruff_cache",
80
+ ".pytest_cache",
81
+ "CLAUDE.md",
82
+ "AGENTS.md",
83
+ "aelix-session-*.html",
84
+ ".env",
85
+ ".env.local",
86
+ ]