aigency 0.0.1rc238211992__py3-none-any.whl → 0.1.0__py3-none-any.whl

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.
@@ -1,267 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: aigency
3
- Version: 0.0.1rc238211992
4
- Summary: Add your description here
5
- Requires-Python: >=3.12
6
- Description-Content-Type: text/markdown
7
- Requires-Dist: google-adk>=1.11.0
8
- Requires-Dist: a2a-sdk==0.3.0
9
- Requires-Dist: litellm<1.73.0,>=1.72.6
10
- Requires-Dist: pyyaml==6.0.2
11
- Requires-Dist: PyJWT==2.10.1
12
-
13
- # aigency-lib
14
-
15
- A library for creating and managing AI agents.
16
-
17
- ## Quick Start
18
-
19
- To test a simple agent:
20
-
21
- ```bash
22
- cd examples/simple_agents/hello_world_agent
23
- docker compose up
24
- ```
25
-
26
- ## 🔧 Version Management
27
-
28
- This project includes an automated system for managing versions in both development and production.
29
-
30
- ### Version Manager
31
-
32
- The `scripts/version_manager.py` script helps you manage your package versions locally.
33
-
34
- #### Available Commands
35
-
36
- ##### 1. View current information
37
- ```bash
38
- python scripts/version_manager.py show
39
- ```
40
- **What it does:**
41
- - Shows the current version in `pyproject.toml`
42
- - Shows the current git branch
43
- - Shows the current commit
44
- - If you're not on `main`, suggests a development version
45
-
46
- **Example output:**
47
- ```
48
- Current version: 0.0.1
49
- Branch: feature/new-agent
50
- Commit: a1b2c3d
51
- Suggested dev version: 0.0.1.dev20250409143022+feature/new-agent.a1b2c3d
52
- ```
53
-
54
- ##### 2. Create development version
55
- ```bash
56
- python scripts/version_manager.py dev
57
- ```
58
- **What it does:**
59
- - Takes the current version and creates a development version
60
- - Format: `version.devYYYYMMDDHHMMSS+branch.commit`
61
- - Automatically updates the `pyproject.toml`
62
-
63
- **Example:**
64
- ```bash
65
- # If you're on branch "feature/auth" with commit "abc123"
66
- python scripts/version_manager.py dev
67
- # Result: 0.0.1.dev20250409143022
68
- ```
69
-
70
- ##### 3. Set specific version
71
- ```bash
72
- python scripts/version_manager.py set --version "0.1.0"
73
- ```
74
- **What it does:**
75
- - Changes the version to the one you specify
76
- - Useful for releases or to fix versions
77
-
78
- **Examples:**
79
- ```bash
80
- # Release version
81
- python scripts/version_manager.py set --version "1.0.0"
82
-
83
- # Beta version
84
- python scripts/version_manager.py set --version "1.0.0b1"
85
-
86
- # Alpha version
87
- python scripts/version_manager.py set --version "1.0.0a1"
88
- ```
89
-
90
- ##### 4. Create Release Candidate version
91
- ```bash
92
- python scripts/version_manager.py rc --version "1.0.1"
93
- ```
94
- **What it does:**
95
- - Creates an RC version with the format `version-rc<commit>`
96
- - Useful for preparing releases on `release/*` branches
97
-
98
- ##### 5. Validate current version
99
- ```bash
100
- python scripts/version_manager.py validate
101
- ```
102
- **What it does:**
103
- - Validates that the current version is appropriate for the branch
104
- - Verifies semantic format on `main` and `release/*` branches
105
-
106
- ##### 6. Create dev with custom base version
107
- ```bash
108
- python scripts/version_manager.py dev --base-version "0.2.0"
109
- ```
110
- **What it does:**
111
- - Uses a different base version than the current one
112
- - Useful when you want to prepare a dev version for the next release
113
-
114
- ### 🚀 Recommended Workflow
115
-
116
- #### For daily development:
117
- ```bash
118
- # 1. View current status
119
- python scripts/version_manager.py show
120
-
121
- # 2. If you're on a feature branch, create dev version
122
- python scripts/version_manager.py dev
123
-
124
- # 3. Make your changes and commits
125
- git add .
126
- git commit -m "feat: new functionality"
127
-
128
- # 4. If you need to update the dev version (optional)
129
- python scripts/version_manager.py dev
130
- ```
131
-
132
- #### For releases:
133
- ```bash
134
- # 1. On main branch, set release version
135
- python scripts/version_manager.py set --version "1.0.0"
136
-
137
- # 2. Commit the version
138
- git add pyproject.toml
139
- git commit -m "bump: version 1.0.0"
140
-
141
- # 3. Use GitHub workflow to publish
142
- ```
143
-
144
- #### For testing:
145
- ```bash
146
- # Create specific test version
147
- python scripts/version_manager.py set --version "1.0.0rc1"
148
- ```
149
-
150
- ### ⚠️ PyPI Limitations
151
-
152
- PyPI doesn't allow "local versions" (versions with `+` and local identifiers). That's why we've adapted the format:
153
-
154
- - ❌ Not allowed: `1.0.0.dev20250409+feature.abc123`
155
- - ✅ Allowed: `1.0.0.dev20250409`
156
-
157
- **Solution for Release Candidates:**
158
- - We convert the commit hash (hexadecimal) to decimal
159
- - Example: commit `abc123` → `11256099` → version `1.0.1rc11256099`
160
- - This maintains commit uniqueness in a PyPI-compatible format
161
-
162
- **Result:**
163
- - Dev versions include unique timestamp
164
- - RC versions include commit hash (in decimal)
165
- - We maintain traceability without using local versions
166
-
167
- ### 📋 Practical Use Cases
168
-
169
- **Scenario 1: Working on a feature**
170
- ```bash
171
- git checkout -b feature/new-auth
172
- python scripts/version_manager.py dev
173
- # Now you have: 0.0.1.dev20250409143022
174
- ```
175
-
176
- **Scenario 2: Preparing release**
177
- ```bash
178
- git checkout main
179
- python scripts/version_manager.py set --version "1.0.0"
180
- git add pyproject.toml
181
- git commit -m "release: v1.0.0"
182
- ```
183
-
184
- **Scenario 3: Preparing Release Candidate**
185
- ```bash
186
- git checkout -b release/1.0.1
187
- python scripts/version_manager.py rc --version "1.0.1"
188
- # Result: 1.0.1rc12345678 (where 12345678 is the commit hash in decimal)
189
- ```
190
-
191
- **Scenario 4: Urgent hotfix**
192
- ```bash
193
- git checkout -b hotfix/critical-bug
194
- python scripts/version_manager.py dev --base-version "1.0.1"
195
- # Result: 1.0.1.dev20250409143022
196
- ```
197
-
198
- ## 🔄 Intelligent CI/CD Workflow
199
-
200
- The project includes a single intelligent workflow (`python-publish.yml`) that automatically handles different version types based on the branch:
201
-
202
- ### Automatic behavior by branch:
203
-
204
- #### 🚀 `main` Branch - Production Versions
205
- - **Trigger**: Push to `main` or manual execution
206
- - **Version**: Uses exactly the version from `pyproject.toml`
207
- - **Validations**:
208
- - ✅ Verifies it's a valid semantic version (e.g.: `1.0.0`)
209
- - ✅ Verifies it doesn't already exist on PyPI
210
- - ❌ Fails if it contains development suffixes (`dev`, `rc`, `alpha`, `beta`)
211
- - **Target**: PyPI production
212
-
213
- #### 🎯 `release/*` Branches - Release Candidates
214
- - **Trigger**: Push to `release/X.Y.Z` branch or manual execution
215
- - **Version**: `X.Y.ZrcN` where N is the commit hash in decimal (e.g.: `1.0.1rc12345678`)
216
- - **Validations**:
217
- - ✅ Verifies that `X.Y.Z` is a valid semantic version
218
- - ✅ Extracts version from branch name
219
- - ✅ Uses commit hash as unique identifier
220
- - ✅ PyPI-compatible format
221
- - **Target**: PyPI production
222
- - **Example**: Branch `release/1.0.1` + commit `abc123` → Version `1.0.1rc11256099`
223
-
224
- #### 🔧 Other Branches - Development Versions
225
- - **Trigger**: Push to any other branch or manual execution
226
- - **Version**: `current.devYYYYMMDDHHMMSS` (e.g.: `0.0.1.dev20250409143022`)
227
- - **Target**: PyPI production
228
- - **Note**: No local versions for PyPI compatibility
229
-
230
- ### Recommended workflow:
231
-
232
- ```bash
233
- # 1. Development on feature branch
234
- git checkout -b feature/new-functionality
235
- # Automatic version: 0.0.1.dev20250409143022+feature-new-functionality.abc123
236
-
237
- # 2. Prepare release
238
- git checkout -b release/1.0.0
239
- git push origin release/1.0.0
240
- # Automatic version: 1.0.0rc12345678
241
-
242
- # 3. Final release
243
- git checkout main
244
- python scripts/version_manager.py set --version "1.0.0"
245
- git add pyproject.toml
246
- git commit -m "release: v1.0.0"
247
- git push origin main
248
- # Version: 1.0.0 (with validations)
249
- ```
250
-
251
- ## 📦 Installation
252
-
253
- ```bash
254
- pip install aigency
255
- ```
256
-
257
- ## 🛠️ Development
258
-
259
- 1. Clone the repository
260
- 2. Install development dependencies
261
- 3. Use the version manager to manage versions during development
262
-
263
- ```bash
264
- git clone <repo-url>
265
- cd aigency-lib
266
- pip install -e .
267
- ```
@@ -1,26 +0,0 @@
1
- aigency/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
2
- aigency/agents/client.py,sha256=JFKFnwMSAdTKrCPus5x2NJziPe-Ix9LG_nztd76Y2rI,1962
3
- aigency/agents/communicator.py,sha256=C3c2eDSbAS7l36qCMY3PxhDS5jKjGlOSlMNQPwMv8q8,4779
4
- aigency/agents/executor.py,sha256=ozT0wMwHLfyHi7bLcIPvs1gqnuj8w33SzlsSLB0W55k,5276
5
- aigency/agents/generator.py,sha256=Zq8Ge_pJz-WH2PNH4p9PqJIgakKrg-2AcExXxRzB3M4,5080
6
- aigency/schemas/aigency_config.py,sha256=trFOLAFCekuBtEcCofMTXw_e_d7DRMB9UYum9Ci8Qg4,491
7
- aigency/schemas/agent/agent.py,sha256=Cy8tx4CdYWyIyEzoAp2WFK7u4b34GVd0CAYGnCCL1gM,519
8
- aigency/schemas/agent/model.py,sha256=8gY7xXJdpePESctRDMMFfXIZbRtHJEbIXSyvy89Bbyo,316
9
- aigency/schemas/agent/remote_agent.py,sha256=D1EmkfHKLnv66t1tRd64KeyP8lY_0IoBc8OROQKQuy4,180
10
- aigency/schemas/agent/skills.py,sha256=5yhcoQmadaCf0Yg67PuOGDWy3ZIA-T-8dZ0uRyJw0EE,225
11
- aigency/schemas/agent/tools.py,sha256=FgEx5LW_JwoR8OjSNlU1e2LfBynif9Xm5vM-wir_uoc,963
12
- aigency/schemas/metadata/metadata.py,sha256=wu4TM8f8eOMb40-uOLRffJjgGptW_KVOablW4EpJBLc,156
13
- aigency/schemas/observability/observability.py,sha256=WEeXyCrow9j2VO6HS7tOPkcKItISYsVfmHzGM-ap9nQ,320
14
- aigency/schemas/observability/phoenix.py,sha256=bTJ2vhe2Khtme5h5mCHEVH1o4LJAQ8GcKP6rkjPMpjo,131
15
- aigency/schemas/service/capabilities.py,sha256=vhMHP5pIYeOQTD-aBs79p_g5O3soHb5asfc_UhS1OFA,139
16
- aigency/schemas/service/interface.py,sha256=csYJhwbD9M29LrCnd1G6pBYagFauJ-WRSfrK8NIU9oI,210
17
- aigency/schemas/service/service.py,sha256=OajLiu5ICUFUi-M8yB9nH9jKbEuBUV6foIVcPfqx9QI,304
18
- aigency/tools/generator.py,sha256=sXqZBiHMCZN6iwyXBk7gTrvIN3plNEuWqwwD1heFGc8,2446
19
- aigency/utils/config_service.py,sha256=yN0Hj_IsDSSoTM4cYmBvR_x6vZ4bsxkoPc3Xle1SnjY,3201
20
- aigency/utils/logger.py,sha256=NYvEknt2BeSqn484ivaLFwP0KbAtBxDXFoJiiKiXKeI,3796
21
- aigency/utils/singleton.py,sha256=u5stRwgwiXRt6b2vTX4W8zuchWvQ9kbcvztQDceaF3E,313
22
- aigency/utils/utils.py,sha256=CAyF2n6V64xqiosal9KZmL8RIw-RfGevQR2cIvGKg9Y,3098
23
- aigency-0.0.1rc238211992.dist-info/METADATA,sha256=mnh0dJbUK7XNiLmoLP9IjOcfI38yt1rYDq1FSpggrkw,7170
24
- aigency-0.0.1rc238211992.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
25
- aigency-0.0.1rc238211992.dist-info/top_level.txt,sha256=nr33Htucgjs3wJFNugPV8w7b9ZgSnytxCtRiinR3eb8,8
26
- aigency-0.0.1rc238211992.dist-info/RECORD,,