agentmatrix-core 0.7.0.0__tar.gz

agentmatrix_core-0.7.0.0/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 Agent-Matrix Contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

agentmatrix_core-0.7.0.0/MANIFEST.in

@@ -0,0 +1,68 @@
+# Include essential files
+include README.md
+include LICENSE
+include requirements.txt
+include pyproject.toml
+
+# Include example scripts
+include src/agentmatrix/cli_runner.py
+
+# Include Python source files from src
+recursive-include src/agentmatrix/agents *.py
+recursive-include src/agentmatrix/core *.py
+recursive-include src/agentmatrix/skills *.py
+recursive-include src/agentmatrix/backends *.py
+recursive-include src/agentmatrix/db *.py
+
+# Include configuration and documentation files
+recursive-include src/agentmatrix/profiles *.yaml *.yml
+exclude src/agentmatrix/profiles/.env
+recursive-include src/agentmatrix/docs *.md *.txt
+
+# Exclude test files and directories
+exclude test/*
+exclude Tests/*
+recursive-exclude test *
+recursive-exclude Tests *
+
+# Exclude sample and workspace directories
+exclude Samples/*
+exclude TestWorkspace/*
+
+# Exclude database files
+exclude *.db
+exclude agents.db
+
+# Exclude environment and configuration files
+exclude .env
+exclude .env.local
+exclude .env.*.local
+
+# Exclude log and download directories
+exclude logs/*
+exclude downloads/*
+
+# Exclude Python cache
+exclude __pycache__
+recursive-exclude __pycache__ *
+exclude *.pyc
+exclude *.pyo
+exclude *.pyd
+
+# Exclude development tools and IDE files
+exclude .vscode/*
+exclude .idea/*
+exclude *.swp
+exclude *.swo
+
+# Exclude version control
+exclude .git/*
+exclude .gitignore
+
+# Exclude project entry scripts (keep cli_runner.py as example)
+exclude main.py
+exclude server.py
+
+# Exclude OS files
+exclude .DS_Store
+exclude Thumbs.db

agentmatrix_core-0.7.0.0/PKG-INFO

@@ -0,0 +1,309 @@
+Metadata-Version: 2.4
+Name: agentmatrix-core
+Version: 0.7.0.0
+Summary: Core execution engine for building AI agent applications — MicroAgent, AgentShell protocol, Cerebellum, and skill system
+Author: Agent-Matrix Contributors
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/webdkt/agentmatrix
+Project-URL: Documentation, https://github.com/webdkt/agentmatrix/docs/core
+Project-URL: Repository, https://github.com/webdkt/agentmatrix
+Project-URL: Issues, https://github.com/webdkt/agentmatrix/issues
+Keywords: agents,ai,llm,framework,multi-agent
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: Jinja2>=3.1.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: flake8>=6.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Dynamic: license-file
+
+# AgentMatrix
+
+[English](readme.md) | [中文](readme_zh.md)
+
+**Let LLMs think. Don't make them write JSON.**
+
+Why does getting a powerful language model to do anything require first teaching it JSON syntax? You ask GPT to research a topic. It has to understand your intent, *and* carefully output perfectly formatted JSON. Two completely different skills—reasoning and formatting—forced into one output channel. Like solving calculus while writing calligraphy. Both tasks suffer.
+
+AgentMatrix separates these two concerns. The large model thinks. The small model handles the format. That's it.
+
+---
+
+## Architecture
+
+After the latest refactoring, AgentMatrix follows a clean three-layer architecture:
+
+```
+┌─────────────────────────────────────────────┐
+│  App Layer     Desktop App / CLI / Server   │
+├─────────────────────────────────────────────┤
+│  Shell Layer   AgentShell Protocol           │
+│                (interface between layers)    │
+├─────────────────────────────────────────────┤
+│  Core Layer    MicroAgent Engine             │
+│                (pure execution, no I/O)      │
+└─────────────────────────────────────────────┘
+```
+
+- **Core Layer** — `MicroAgent` is the execution engine. It knows nothing about desktop apps, CLI, or file systems. Pure reasoning loop: think → detect actions → execute → repeat.
+- **Shell Layer** — `AgentShell` is the protocol that connects Core to the outside world. Each app form (Desktop, CLI, Server) implements this interface, providing LLM clients, prompt templates, checkpoint logic, compression strategy, and session storage.
+- **App Layer** — Specific applications that wire everything together: the Desktop App, CLI tools, or a FastAPI server.
+
+This separation means the same core agent behavior runs everywhere—desktop, terminal, or cloud—without changing a line of Core code.
+
+---
+
+## What Agents Can Do
+
+### Think Freely
+
+The agent's "Brain" (large model) reasons entirely in natural language. No JSON output required, no format constraints. A separate "Cerebellum" (smaller model) translates intent into executable parameters. If the intent is ambiguous, the Cerebellum asks the Brain for clarification. Two models, each doing what they're best at.
+
+### Collaborate Like Email
+
+Agents don't call each other's APIs. They send emails. Natural language emails.
+
+You can read what agents are saying to each other, trace conversation threads, and understand *why* an agent did something. It doesn't just return a status code—it explains its reasoning. Debugging multi-agent systems feels natural for the first time.
+
+### Pause, Resume, Stop — Anytime
+
+Any running agent can be paused, resumed, or stopped. When paused, it halts at a safe checkpoint, saves its state, and can be resumed later. Stopping the current task doesn't affect the agent's ability to receive new emails.
+
+### Run Extremely Long Jobs Without Blowing Up Context
+
+When conversation history grows too large, the system automatically compresses it into "Working Notes"—a dynamic state snapshot generated by the LLM. This isn't a fixed template; the LLM analyzes the conversation type (research, knowledge, creative writing) and generates the optimal structure for that context. Tasks can run for hours or days; the context window never overflows.
+
+### Ask You Questions Mid-Execution
+
+Agents can pause mid-task and ask you a question, then wait for your answer before continuing. The desktop app shows a dialog. You can also reply by email. Dual notification channels—desktop popup plus email—so you never miss it.
+
+### Isolated Workspaces Per Task
+
+Every task gets its own private working directory. Files created in Task A don't interfere with Task B. Workspaces switch automatically when the agent moves between tasks.
+
+### Run in Isolated Containers
+
+Each agent runs in its own Docker container. File operations execute inside the container. Agents can't interfere with each other. Containers wake and hibernate on demand—dormant when idle, automatically activated when new mail arrives.
+
+### Survive Restarts
+
+Conversation history is automatically persisted via `SessionStore`. After a shutdown and restart, agents resume from where they left off. Tasks in progress are not lost.
+
+### Recover from LLM Outages
+
+If the LLM service goes down during execution, the agent enters a wait mode, periodically checking for recovery. When the service comes back, execution continues automatically. No progress is lost.
+
+---
+
+## System Management: In Natural Language
+
+Because LLMs naturally read YAML/JSON, system configuration can be managed entirely through natural language.
+
+### SystemAdmin Agent
+
+No need to edit config files manually. Just tell SystemAdmin what you want:
+
+- "Add a new LLM model using GPT-4o"
+- "Turn off the email proxy"
+- "Show me the current system configuration"
+
+SystemAdmin reads the config, validates the format, tests connections, backs up the old version, and writes the new one. Natural language feedback at every step.
+
+### AgentAdmin Agent
+
+Manage other agents' lifecycles in natural language:
+
+- "Create an agent called Researcher with web_search and memory skills"
+- "Clone Writer as Editor"
+- "Stop Researcher's current task"
+- "Delete Editor"
+
+Creation validates that skills exist and models are reachable. Edits are auto-backed up. Rollback is supported—view and restore any historical config version.
+
+---
+
+## Skill System
+
+### Built-in Skills
+
+| Skill | Capability |
+|-------|------------|
+| base | Date/time utilities |
+| file | File read/write, search, command execution |
+| shell | Shell command execution |
+| browser | Browser automation |
+| web_search | Web search |
+| email | Send emails to other agents (with attachments) |
+| memory | Knowledge and memory management |
+| vision | Image analysis |
+| markdown | Markdown processing |
+| scheduler | Scheduled tasks (with recurring support) |
+| system_admin | System configuration management |
+| agent_admin | Agent lifecycle management |
+
+### Extend with Code
+
+Write custom Python skills for domain-specific capabilities. Skills can declare dependencies on each other—resolved automatically.
+
+### Extend with Markdown (Recommended)
+
+No code required. Place a `skill.md` file in the workspace's `SKILLS/` directory, describing procedures and workflows in Markdown. The agent reads it as procedural knowledge. Define SOPs, workflows, domain expertise—plain text is enough.
+
+---
+
+## Components
+
+### 1. Core Framework (`src/agentmatrix/`)
+
+The Python package `agentmatrix-core`. Install it and build your own agent application.
+
+```bash
+pip install agentmatrix-core
+```
+
+Key modules:
+- `core/micro_agent.py` — The execution engine
+- `core/agent_shell.py` — Shell protocol (implement this for your app)
+- `core/cerebellum.py` — Intent-to-action parameter negotiation
+- `core/action.py` — Action registry and execution
+- `core/session_store.py` — Session persistence interface
+- `core/signals.py` — Event-driven communication
+- `skills/` — Built-in skills (Python mixins)
+
+### 2. Desktop App (`agentmatrix-desktop/`)
+
+Native desktop application built on Tauri (Rust) + Vue 3.
+
+- **Matrix-themed init wizard** — Full-screen character rain animation, typewriter reveal, step-by-step configuration
+- **Real-time status** — Agent status pushed via WebSocket. No refresh, no polling
+- **Email-style interaction** — Write to agents like writing to a colleague. Drag-and-drop attachments
+- **Prompt preview** — View any agent's complete System Prompt
+- **Settings GUI** — Manage LLM config and email proxy without touching config files
+- **Bilingual** — Full Chinese and English interface
+
+### 3. CLI Tutorial (`tutorial/cli-agent/`)
+
+A minimal working example that shows how to build a terminal agent using the Core framework. ~200 lines of code, implements `AgentShell`, and wires up `MicroAgent` with three basic skills.
+
+Start here if you want to understand the architecture or build your own app.
+
+---
+
+## Quick Start
+
+### Try the CLI Tutorial
+
+```bash
+cd tutorial/cli-agent
+
+# Set your API key
+export OPENAI_API_KEY=sk-xxx
+
+# Run with a model
+python main.py -m openai:gpt-4o
+```
+
+This gives you a fully functional terminal agent with file, shell, and base skills. Supports Textual TUI (if installed) or falls back to simple mode.
+
+### Desktop App
+
+```bash
+cd agentmatrix-desktop
+npm install
+npm run tauri:dev
+```
+
+The init wizard launches on first run.
+
+### Use Core as a Library
+
+```bash
+pip install agentmatrix-core
+```
+
+Then implement `AgentShell` and create your own agent application. See `tutorial/cli-agent/` for a complete working example.
+
+---
+
+## Email Proxy: Talk to Agents via Real Email
+
+Configure the email proxy and interact with agents using Gmail, Outlook, QQ Mail, or any email client:
+
+- Send an email with `@AgentName` in the subject → the agent receives and processes it
+- Agent replies are forwarded to your inbox, maintaining the email thread
+- When an agent asks you a question, just reply to the email
+- Attachments transfer automatically in both directions
+
+---
+
+## Project Structure
+
+```
+agentmatrix/
+├── src/agentmatrix/              # Core framework (pip install agentmatrix-core)
+│   ├── core/                     # MicroAgent, AgentShell, Cerebellum, Actions
+│   ├── skills/                   # Built-in skills (Python mixins)
+│   ├── agents/                   # BaseAgent
+│   ├── backends/                 # LLM backend integrations
+│   ├── profiles/                 # Agent profiles and configurations
+│   └── services/                 # ConfigService, etc.
+├── agentmatrix-desktop/          # Desktop app (Tauri + Vue 3)
+│   ├── src/                      # Vue 3 frontend
+│   └── src-tauri/                # Rust backend
+├── tutorial/cli-agent/           # CLI tutorial and demo
+│   ├── main.py                   # Entry point + TUI
+│   ├── cli_shell.py              # AgentShell implementation
+│   ├── cli_config.py             # Configuration
+│   └── skills/                   # Basic skills (file, shell, base)
+├── docs/                         # Documentation
+├── examples/                     # Examples
+└── server.py                     # FastAPI server
+```
+
+---
+
+## Documentation
+
+**Core Framework** (`docs/core/`)
+- [Brain, Cerebellum & Actions](docs/core/01-大脑小脑与动作.md)
+- [Event-Driven Execution Loop](docs/core/02-事件驱动的执行循环.md)
+- [System Prompt Structure](docs/core/03-System-Prompt的构成.md)
+- [Session Auto-Compression](docs/core/04-会话自动压缩机制.md)
+- [Python Skill System](docs/core/05-Python-Skill机制.md)
+- [Nested MicroAgent Pattern](docs/core/06-无限嵌套的MicroAgent模式.md)
+
+**Desktop App** (`docs/desktop/`)
+- [Architecture Overview](docs/desktop/architecture/01-整体架构概览.md)
+- [Runtime & PostOffice](docs/desktop/architecture/02-运行时与邮局.md)
+- [Config Service & Admin Skills](docs/desktop/services/Config-Service与管理技能.md)
+- [Collab Mode](docs/desktop/architecture/07-Collab模式.md)
+
+**Tutorial**
+- [CLI Agent Tutorial](tutorial/cli-agent/README.md)
+
+**Full index**: [docs/README.md](docs/README.md)
+
+---
+
+## License
+
+Apache License 2.0 — see [LICENSE](LICENSE)
+
+---
+
+**Repository**: https://github.com/webdkt/agentmatrix

agentmatrix_core-0.7.0.0/pyproject.toml

@@ -0,0 +1,60 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agentmatrix-core"
+version = "0.7.0.0"
+description = "Core execution engine for building AI agent applications — MicroAgent, AgentShell protocol, Cerebellum, and skill system"
+readme = "readme.md"
+requires-python = ">=3.12"
+license = {text = "Apache-2.0"}
+authors = [
+    {name = "Agent-Matrix Contributors"}
+]
+keywords = ["agents", "ai", "llm", "framework", "multi-agent"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+dependencies = [
+    "pyyaml>=6.0",
+    "python-dotenv>=1.0.0",
+    "requests>=2.31.0",
+    "aiohttp>=3.8.0",
+    "Jinja2>=3.1.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "black>=23.0",
+    "flake8>=6.0",
+    "mypy>=1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/webdkt/agentmatrix"
+Documentation = "https://github.com/webdkt/agentmatrix/docs/core"
+Repository = "https://github.com/webdkt/agentmatrix"
+Issues = "https://github.com/webdkt/agentmatrix/issues"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+# agentmatrix.core — includes core.backends, core.skills, core.utils as sub-packages
+[tool.setuptools.packages]
+find = {where = ["src"], include = ["agentmatrix.core*"]}
+
+[tool.setuptools.package-data]
+"agentmatrix.core" = ["*.yaml", "*.yml", "*.md", "*.txt"]
+
+[tool.setuptools.exclude-package-data]
+"*" = ["*.db", ".env", "*.log"]