interagent-framework 0.3.0__tar.gz → 0.4.0__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 (47) hide show
  1. interagent_framework-0.4.0/PKG-INFO +28 -0
  2. interagent_framework-0.4.0/README.md +12 -0
  3. interagent_framework-0.4.0/interagent_framework.egg-info/PKG-INFO +28 -0
  4. interagent_framework-0.4.0/interagent_framework.egg-info/SOURCES.txt +7 -0
  5. interagent_framework-0.4.0/interagent_framework.egg-info/requires.txt +1 -0
  6. interagent_framework-0.4.0/interagent_framework.egg-info/top_level.txt +1 -0
  7. interagent_framework-0.4.0/pyproject.toml +25 -0
  8. interagent_framework-0.3.0/LICENSE +0 -21
  9. interagent_framework-0.3.0/MANIFEST.in +0 -8
  10. interagent_framework-0.3.0/PKG-INFO +0 -370
  11. interagent_framework-0.3.0/README.md +0 -336
  12. interagent_framework-0.3.0/examples/README.md +0 -187
  13. interagent_framework-0.3.0/examples/basic_workflow.py +0 -267
  14. interagent_framework-0.3.0/examples/cli_session.bat +0 -75
  15. interagent_framework-0.3.0/examples/cli_session.sh +0 -101
  16. interagent_framework-0.3.0/examples/parallel_workflow.py +0 -151
  17. interagent_framework-0.3.0/pyproject.toml +0 -78
  18. interagent_framework-0.3.0/src/interagent/__init__.py +0 -23
  19. interagent_framework-0.3.0/src/interagent/cli.py +0 -1317
  20. interagent_framework-0.3.0/src/interagent/constants.py +0 -129
  21. interagent_framework-0.3.0/src/interagent/locking.py +0 -147
  22. interagent_framework-0.3.0/src/interagent/messaging.py +0 -185
  23. interagent_framework-0.3.0/src/interagent/session.py +0 -156
  24. interagent_framework-0.3.0/src/interagent/task.py +0 -204
  25. interagent_framework-0.3.0/src/interagent/templates/__init__.py +0 -35
  26. interagent_framework-0.3.0/src/interagent/templates/agents_guide.md +0 -172
  27. interagent_framework-0.3.0/src/interagent/templates/ai_context.md +0 -119
  28. interagent_framework-0.3.0/src/interagent/templates/review_request.md +0 -68
  29. interagent_framework-0.3.0/src/interagent/templates/roles_template.md +0 -59
  30. interagent_framework-0.3.0/src/interagent/templates/task_delegation.md +0 -69
  31. interagent_framework-0.3.0/src/interagent/templates/update_prompt.md +0 -70
  32. interagent_framework-0.3.0/src/interagent/transport/__init__.py +0 -32
  33. interagent_framework-0.3.0/src/interagent/transport/base.py +0 -37
  34. interagent_framework-0.3.0/src/interagent/transport/config.py +0 -47
  35. interagent_framework-0.3.0/src/interagent/transport/git.py +0 -368
  36. interagent_framework-0.3.0/src/interagent/transport/http.py +0 -72
  37. interagent_framework-0.3.0/src/interagent/transport/local.py +0 -71
  38. interagent_framework-0.3.0/src/interagent/utils.py +0 -90
  39. interagent_framework-0.3.0/src/interagent/validator.py +0 -171
  40. interagent_framework-0.3.0/src/interagent/watchdog.py +0 -197
  41. interagent_framework-0.3.0/src/interagent_framework.egg-info/PKG-INFO +0 -370
  42. interagent_framework-0.3.0/src/interagent_framework.egg-info/SOURCES.txt +0 -38
  43. interagent_framework-0.3.0/src/interagent_framework.egg-info/entry_points.txt +0 -4
  44. interagent_framework-0.3.0/src/interagent_framework.egg-info/requires.txt +0 -7
  45. interagent_framework-0.3.0/src/interagent_framework.egg-info/top_level.txt +0 -1
  46. {interagent_framework-0.3.0/src → interagent_framework-0.4.0}/interagent_framework.egg-info/dependency_links.txt +0 -0
  47. {interagent_framework-0.3.0 → interagent_framework-0.4.0}/setup.cfg +0 -0
@@ -0,0 +1,28 @@
1
+ Metadata-Version: 2.4
2
+ Name: interagent-framework
3
+ Version: 0.4.0
4
+ Summary: DEPRECATED — renamed to agentweave-ai. Install: pip install agentweave-ai
5
+ Author: gutohuida
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/gutohuida/AgentWeave
8
+ Keywords: deprecated,agentweave,agents,ai
9
+ Classifier: Development Status :: 7 - Inactive
10
+ Classifier: Intended Audience :: Developers
11
+ Classifier: Operating System :: OS Independent
12
+ Classifier: Programming Language :: Python :: 3
13
+ Requires-Python: >=3.8
14
+ Description-Content-Type: text/markdown
15
+ Requires-Dist: agentweave-ai>=0.4.0
16
+
17
+ # interagent-framework — DEPRECATED
18
+
19
+ This package has been renamed to **[agentweave-ai](https://pypi.org/project/agentweave-ai/)**.
20
+
21
+ Please update your installation:
22
+
23
+ ```bash
24
+ pip uninstall interagent-framework
25
+ pip install agentweave-ai
26
+ ```
27
+
28
+ This stub package installs `agentweave-ai` as a dependency to ease migration.
@@ -0,0 +1,12 @@
1
+ # interagent-framework — DEPRECATED
2
+
3
+ This package has been renamed to **[agentweave-ai](https://pypi.org/project/agentweave-ai/)**.
4
+
5
+ Please update your installation:
6
+
7
+ ```bash
8
+ pip uninstall interagent-framework
9
+ pip install agentweave-ai
10
+ ```
11
+
12
+ This stub package installs `agentweave-ai` as a dependency to ease migration.
@@ -0,0 +1,28 @@
1
+ Metadata-Version: 2.4
2
+ Name: interagent-framework
3
+ Version: 0.4.0
4
+ Summary: DEPRECATED — renamed to agentweave-ai. Install: pip install agentweave-ai
5
+ Author: gutohuida
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/gutohuida/AgentWeave
8
+ Keywords: deprecated,agentweave,agents,ai
9
+ Classifier: Development Status :: 7 - Inactive
10
+ Classifier: Intended Audience :: Developers
11
+ Classifier: Operating System :: OS Independent
12
+ Classifier: Programming Language :: Python :: 3
13
+ Requires-Python: >=3.8
14
+ Description-Content-Type: text/markdown
15
+ Requires-Dist: agentweave-ai>=0.4.0
16
+
17
+ # interagent-framework — DEPRECATED
18
+
19
+ This package has been renamed to **[agentweave-ai](https://pypi.org/project/agentweave-ai/)**.
20
+
21
+ Please update your installation:
22
+
23
+ ```bash
24
+ pip uninstall interagent-framework
25
+ pip install agentweave-ai
26
+ ```
27
+
28
+ This stub package installs `agentweave-ai` as a dependency to ease migration.
@@ -0,0 +1,7 @@
1
+ README.md
2
+ pyproject.toml
3
+ interagent_framework.egg-info/PKG-INFO
4
+ interagent_framework.egg-info/SOURCES.txt
5
+ interagent_framework.egg-info/dependency_links.txt
6
+ interagent_framework.egg-info/requires.txt
7
+ interagent_framework.egg-info/top_level.txt
@@ -0,0 +1 @@
1
+ agentweave-ai>=0.4.0
@@ -0,0 +1,25 @@
1
+ [build-system]
2
+ requires = ["setuptools>=61.0", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "interagent-framework"
7
+ version = "0.4.0"
8
+ description = "DEPRECATED — renamed to agentweave-ai. Install: pip install agentweave-ai"
9
+ readme = "README.md"
10
+ license = "MIT"
11
+ authors = [
12
+ {name = "gutohuida"},
13
+ ]
14
+ keywords = ["deprecated", "agentweave", "agents", "ai"]
15
+ classifiers = [
16
+ "Development Status :: 7 - Inactive",
17
+ "Intended Audience :: Developers",
18
+ "Operating System :: OS Independent",
19
+ "Programming Language :: Python :: 3",
20
+ ]
21
+ requires-python = ">=3.8"
22
+ dependencies = ["agentweave-ai>=0.4.0"]
23
+
24
+ [project.urls]
25
+ Homepage = "https://github.com/gutohuida/AgentWeave"
@@ -1,21 +0,0 @@
1
- MIT License
2
-
3
- Copyright (c) 2024 InterAgent Team
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
@@ -1,8 +0,0 @@
1
- include README.md
2
- include LICENSE
3
- include pyproject.toml
4
- recursive-include src/interagent/templates *
5
- recursive-include examples *.py *.sh *.bat *.md
6
- global-exclude __pycache__
7
- global-exclude *.py[co]
8
- global-exclude .DS_Store
@@ -1,370 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: interagent-framework
3
- Version: 0.3.0
4
- Summary: Multi-agent AI collaboration framework (Claude, Kimi, Gemini, Codex, and more)
5
- Author: gutohuida
6
- License-Expression: MIT
7
- Project-URL: Homepage, https://github.com/gutohuida/InterAgentFramework
8
- Project-URL: Documentation, https://github.com/gutohuida/InterAgentFramework#readme
9
- Project-URL: Repository, https://github.com/gutohuida/InterAgentFramework
10
- Project-URL: Issues, https://github.com/gutohuida/InterAgentFramework/issues
11
- Project-URL: Changelog, https://github.com/gutohuida/InterAgentFramework/blob/master/CHANGELOG.md
12
- Keywords: claude,kimi,gemini,codex,collaboration,agents,ai,code,multi-agent
13
- Classifier: Development Status :: 4 - Beta
14
- Classifier: Intended Audience :: Developers
15
- Classifier: Operating System :: OS Independent
16
- Classifier: Programming Language :: Python :: 3
17
- Classifier: Programming Language :: Python :: 3.8
18
- Classifier: Programming Language :: Python :: 3.9
19
- Classifier: Programming Language :: Python :: 3.10
20
- Classifier: Programming Language :: Python :: 3.11
21
- Classifier: Programming Language :: Python :: 3.12
22
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
- Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
24
- Requires-Python: >=3.8
25
- Description-Content-Type: text/markdown
26
- License-File: LICENSE
27
- Provides-Extra: dev
28
- Requires-Dist: pytest>=7.0; extra == "dev"
29
- Requires-Dist: pytest-cov>=4.0; extra == "dev"
30
- Requires-Dist: black>=23.0; extra == "dev"
31
- Requires-Dist: ruff>=0.1.0; extra == "dev"
32
- Requires-Dist: mypy>=1.0; extra == "dev"
33
- Dynamic: license-file
34
-
35
- # InterAgent
36
-
37
- [![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/)
38
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
39
- [![PyPI version](https://badge.fury.io/py/interagent-framework.svg)](https://badge.fury.io/py/interagent-framework)
40
-
41
- > **A collaboration framework for Claude Code and Kimi Code**
42
-
43
- InterAgent lets Claude Code and Kimi Code work together on the same project — on the same machine or across machines. After a one-time setup, you orchestrate everything through **natural language prompts** — no manual CLI commands required during your session.
44
-
45
- ---
46
-
47
- ## How It Works
48
-
49
- InterAgent creates a shared `.interagent/` directory that both agents use as a communication channel. The user acts as the messenger, passing relay prompts between agents.
50
-
51
- ```
52
- You (setup once)
53
- └─ interagent init --project "My App" --principal claude
54
-
55
- You (natural language)
56
- └─ "Claude, delegate the auth module to Kimi"
57
-
58
- Claude (runs CLI via Bash automatically)
59
- └─ interagent quick --to kimi "Implement auth module"
60
- └─ interagent relay --agent kimi
61
- └─ [shows you the relay prompt to paste into Kimi]
62
-
63
- You
64
- └─ paste relay prompt into Kimi Code
65
-
66
- Kimi (reads AGENTS.md + context.md, runs CLI via terminal)
67
- └─ interagent task update <id> --status in_progress
68
- └─ [does the work]
69
- └─ interagent task update <id> --status completed
70
- └─ interagent msg send --to claude --subject "Done" --message "..."
71
-
72
- You
73
- └─ "Claude, Kimi is done"
74
-
75
- Claude (runs CLI via Bash automatically)
76
- └─ interagent inbox --agent claude
77
- └─ interagent summary
78
- └─ [reviews Kimi's work and continues]
79
- ```
80
-
81
- **The only manual step is pasting the relay prompt into Kimi.** Both agents handle all CLI commands themselves — you just have a conversation.
82
-
83
- ---
84
-
85
- ## Quick Start
86
-
87
- ### 1. Install
88
-
89
- ```bash
90
- pip install interagent-framework
91
- ```
92
-
93
- ### 2. Initialize (once per project)
94
-
95
- ```bash
96
- cd your-project/
97
- interagent init --project "My App" --principal claude
98
- ```
99
-
100
- This creates:
101
- - `.interagent/AGENTS.md` — full collaboration guide that both agents read on startup
102
- - `.interagent/shared/context.md` — fill this with your project description
103
- - `.interagent/session.json` — session state
104
-
105
- ### 3. Fill in project context
106
-
107
- Edit `.interagent/shared/context.md` and paste in your project description, current state, and any constraints. Both agents read this at the start of every task.
108
-
109
- ### 4. Start working — just prompt Claude
110
-
111
- From this point, use natural language. Claude handles the CLI:
112
-
113
- > "Claude, read `.interagent/AGENTS.md` to understand how we're collaborating,
114
- > then delegate the database schema design to Kimi."
115
-
116
- Claude will run `interagent quick` and `interagent relay` via Bash, then show you a prompt to paste into Kimi Code.
117
-
118
- ---
119
-
120
- ## Cross-Machine Collaboration (v0.2.0+)
121
-
122
- By default, InterAgent works on a single machine via the local `.interagent/` directory. If your collaborator is on a different machine, enable **Git transport** with one command:
123
-
124
- ```bash
125
- interagent transport setup --type git
126
- ```
127
-
128
- This creates an orphan branch (`interagent/collab`) on your git remote. Messages and tasks are synced through it using git plumbing — your working tree and current branch are never touched.
129
-
130
- ### How to set up cross-machine
131
-
132
- ```bash
133
- # Both developers run this (same git remote required):
134
- interagent transport setup --type git --remote origin
135
-
136
- # Check status
137
- interagent transport status
138
-
139
- # Force-fetch latest messages
140
- interagent transport pull
141
-
142
- # Revert to local-only
143
- interagent transport disable
144
- ```
145
-
146
- All existing commands (`quick`, `inbox`, `relay`, `task`, etc.) work identically — transport is transparent.
147
-
148
- ### Start watching for incoming messages
149
-
150
- ```bash
151
- interagent-watch
152
- ```
153
-
154
- Automatically adapts to the active transport. For git transport, polls every 10 seconds instead of 5.
155
-
156
- ---
157
-
158
- ## Commands Reference
159
-
160
- ### Session
161
-
162
- ```bash
163
- interagent init --project "Name" --principal claude # Initialize
164
- interagent status # Full status
165
- interagent summary # Quick overview
166
- ```
167
-
168
- ### Delegation
169
-
170
- ```bash
171
- interagent quick --to kimi "Task description" # Create + assign task
172
- interagent relay --agent kimi # Generate relay prompt
173
- interagent relay --agent claude # Generate relay for Claude
174
- ```
175
-
176
- ### Tasks
177
-
178
- ```bash
179
- interagent task list # List all tasks
180
- interagent task show <task_id> # View task details
181
- interagent task update <task_id> --status in_progress
182
- interagent task update <task_id> --status completed
183
- interagent task update <task_id> --status approved
184
- interagent task update <task_id> --status needs_revision --note "Fix X"
185
- ```
186
-
187
- ### Messaging
188
-
189
- ```bash
190
- interagent inbox --agent claude # Check Claude's inbox
191
- interagent inbox --agent kimi # Check Kimi's inbox
192
- interagent msg send --to claude --subject "Done" --message "Implemented X"
193
- ```
194
-
195
- ### Transport (cross-machine)
196
-
197
- ```bash
198
- interagent transport setup --type git # Enable git transport
199
- interagent transport status # Show active transport
200
- interagent transport pull # Force immediate fetch
201
- interagent transport disable # Revert to local
202
- ```
203
-
204
- ### Template Maintenance
205
-
206
- ```bash
207
- interagent update-template --agent claude --template-path ~/projects/template.txt
208
- interagent update-template --agent claude --focus "sub-agents"
209
- ```
210
-
211
- ---
212
-
213
- ## What Gets Created on Init
214
-
215
- ```
216
- .interagent/
217
- ├── AGENTS.md # Collaboration guide — both agents read this
218
- ├── README.md # Quick command reference
219
- ├── session.json # Session config (id, mode, principal)
220
- ├── shared/
221
- │ └── context.md # Project state — fill this with your project description
222
- ├── tasks/
223
- │ ├── active/ # JSON files for each active task
224
- │ └── completed/ # Archived completed tasks
225
- ├── messages/
226
- │ ├── pending/ # Unread messages
227
- │ └── archive/ # Message history
228
- └── agents/ # Agent status files
229
- ```
230
-
231
- `.interagent/AGENTS.md` is the key file. Both Claude and Kimi read it on every session start to understand their roles, available commands, and the collaboration protocol.
232
-
233
- ---
234
-
235
- ## Prompt-First Workflow
236
-
237
- ### Delegating to Kimi
238
-
239
- Just tell Claude what to assign. No CLI needed.
240
-
241
- **You → Claude:**
242
- > "Delegate the user authentication module to Kimi. It should include login, logout,
243
- > JWT tokens, and password reset. See PLAN.md for the API design."
244
-
245
- **Claude does automatically:**
246
- ```bash
247
- interagent quick --to kimi "Implement user authentication: login, logout, JWT tokens, password reset. See PLAN.md §3 for API design."
248
- interagent relay --agent kimi
249
- ```
250
-
251
- **Claude shows you:**
252
- ```
253
- ====================================================================
254
- RELAY PROMPT FOR KIMI
255
- ====================================================================
256
- Copy and paste this to the agent:
257
-
258
- @kimi - You have work in the InterAgent collaboration system.
259
-
260
- Your role: delegate
261
- Collaboration guide: read .interagent/AGENTS.md for commands, workflow, and protocol.
262
- Project context: read .interagent/shared/context.md before starting.
263
-
264
- [TASK] You have 1 new task(s):
265
- - Implement user authentication (task-a3f2c1)
266
- ...
267
- ====================================================================
268
- ```
269
-
270
- **You:** paste that into Kimi Code.
271
-
272
- ---
273
-
274
- ### Getting Kimi's Work Back to Claude
275
-
276
- When Kimi is done:
277
-
278
- **You → Claude:**
279
- > "Kimi is done."
280
-
281
- **Claude does automatically:**
282
- ```bash
283
- interagent inbox --agent claude
284
- interagent summary
285
- ```
286
-
287
- ---
288
-
289
- ## Safety Features
290
-
291
- **File locking** — prevents race conditions when both agents work simultaneously. Tasks and messages use file-based mutexes with a 5-minute automatic timeout.
292
-
293
- **Schema validation** — all JSON state files are validated before saving. Agent names, task statuses, and required fields are enforced.
294
-
295
- **Input sanitization** — string length limits and type coercion before any write.
296
-
297
- **Conflict-free git sync** — GitTransport appends files with UUID-suffixed names; two machines can never produce the same filename. Push conflicts are retried automatically.
298
-
299
- ---
300
-
301
- ## Roles
302
-
303
- | Role | Agent | Responsibilities |
304
- |---|---|---|
305
- | Principal | Claude | Architecture, planning, review, final decisions |
306
- | Delegate | Kimi | Implementation, execution, reporting back |
307
-
308
- In hierarchical mode (default), Claude assigns work and reviews results.
309
- In peer mode, both agents can assign tasks to each other.
310
-
311
- ---
312
-
313
- ## Roadmap
314
-
315
- | Phase | Status | Description |
316
- |---|---|---|
317
- | Local transport | Done | Single-machine via `.interagent/` filesystem |
318
- | Git transport | Done (v0.2.0) | Cross-machine via orphan branch, zero infra |
319
- | InterAgent Hub | Planned | MCP server for multi-team collaboration, web dashboard |
320
-
321
- The Hub (Phase 3) will be an **MCP server** — Claude Code and Kimi Code connect to it as a native MCP tool provider, enabling real-time delivery without polling and a web dashboard for project oversight. See [ROADMAP.md](ROADMAP.md) for the full plan.
322
-
323
- ---
324
-
325
- ## Installation Options
326
-
327
- ```bash
328
- # From PyPI
329
- pip install interagent-framework
330
-
331
- # From source
332
- git clone https://github.com/gutohuida/InterAgentFramework.git
333
- cd InterAgentFramework
334
- pip install -e .
335
- ```
336
-
337
- ---
338
-
339
- ## FAQ
340
-
341
- **Q: Do I need to run CLI commands during my session?**
342
- No. After `interagent init`, just talk to Claude. It runs all `interagent` commands via Bash automatically. The only manual step is pasting the relay prompt into Kimi.
343
-
344
- **Q: How does Kimi know how to use the system?**
345
- `interagent init` writes `.interagent/AGENTS.md` — a complete guide covering commands, workflow, and protocol. The relay prompt tells Kimi to read it before starting work.
346
-
347
- **Q: Should I commit `.interagent/` to Git?**
348
- Partially. The `.gitignore` excludes runtime state (tasks, messages, session.json, transport.json) but keeps AGENTS.md and README.md. This gives you documentation without committing transient data.
349
-
350
- **Q: Can I use this with just Claude (no Kimi)?**
351
- Yes — just skip the relay step. The session, task, and summary commands are useful even for single-agent projects to track progress.
352
-
353
- **Q: Do both developers need the same git remote for cross-machine sync?**
354
- Yes. Git transport requires a shared remote (e.g. `origin`). One developer runs `interagent transport setup --type git` to create the orphan branch, then the other runs the same command to connect to it.
355
-
356
- **Q: What if Kimi doesn't have terminal access?**
357
- The relay prompt includes the task details inline, so Kimi can read and respond without running any commands. The collaboration is less structured but still works.
358
-
359
- ---
360
-
361
- ## Links
362
-
363
- - **GitHub:** https://github.com/gutohuida/InterAgentFramework
364
- - **PyPI:** https://pypi.org/project/interagent-framework/
365
- - **Issues:** https://github.com/gutohuida/InterAgentFramework/issues
366
- - **Roadmap:** [ROADMAP.md](ROADMAP.md)
367
-
368
- ---
369
-
370
- MIT License