composer-agent 0.1.0__tar.gz

composer_agent-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+# Python-generated files
+__pycache__/
+.ipynb_checkpoints/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+
+# Virtual environments
+.venv
+
+# Django
+db.sqlite3
+
+# Environment variables
+.env

composer_agent-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MM21B038
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

composer_agent-0.1.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: composer-agent
+Version: 0.1.0
+Summary: Thread-based agents with typed streaming, tool-hide rules, branch compression, and optional Django persistence
+Project-URL: Homepage, https://github.com/MM21B038/composer
+Project-URL: Documentation, https://github.com/MM21B038/composer/blob/main/docs/chat_persistence.md
+Project-URL: Repository, https://github.com/MM21B038/composer
+Project-URL: Issues, https://github.com/MM21B038/composer/issues
+Author-email: MM21B038 <mg2464109@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,langchain,llm,mcp,streaming
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Django
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.12
+Requires-Dist: deepagents>=0.6.3
+Requires-Dist: langchain-core>=1.4.0
+Requires-Dist: langchain-mcp-adapters>=0.2.2
+Requires-Dist: langchain-openai>=1.2.1
+Requires-Dist: langchain-openrouter>=0.2.3
+Requires-Dist: langchain>=1.3.1
+Requires-Dist: langgraph>=1.2.0
+Requires-Dist: numpy>=2.0.0
+Requires-Dist: pillow>=11.0.0
+Requires-Dist: tiktoken>=0.13.0
+Provides-Extra: all
+Requires-Dist: django>=5.1; extra == 'all'
+Requires-Dist: ipykernel>=7.2.0; extra == 'all'
+Requires-Dist: jupyter>=1.1.1; extra == 'all'
+Requires-Dist: pytest-django>=4.9; extra == 'all'
+Requires-Dist: pytest>=8.0; extra == 'all'
+Requires-Dist: python-dotenv>=1.0.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: django>=5.1; extra == 'dev'
+Requires-Dist: ipykernel>=7.2.0; extra == 'dev'
+Requires-Dist: jupyter>=1.1.1; extra == 'dev'
+Requires-Dist: pytest-django>=4.9; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: python-dotenv>=1.0.0; extra == 'dev'
+Requires-Dist: twine>=6.0; extra == 'dev'
+Provides-Extra: django
+Requires-Dist: django>=5.1; extra == 'django'
+Description-Content-Type: text/markdown
+
+# Composer
+
+Thread-based agents with typed streaming, tool-hide rules, branch compression, and optional Django persistence.
+
+## Install
+
+```bash
+pip install composer-agent
+```
+
+With chat persistence (Django + SQLite):
+
+```bash
+pip install composer-agent[django]
+composer-migrate
+```
+
+The default database path is `~/.composer/db.sqlite3`. Override with `COMPOSER_DB_PATH`.
+
+## Quick start
+
+```python
+from composer import Agent, HumanMessage, SystemMessage, Thread
+
+agent = Agent(model="...", base_url="...", api_key="...")
+thread = Thread()
+SystemMessage("You are a helpful assistant.") | thread
+thread.append(HumanMessage("Hello"))
+reply = thread.invoke(agent)
+print(reply.content)
+```
+
+## Chat persistence
+
+See [docs/chat_persistence.md](docs/chat_persistence.md) for the full guide on `ChatProject` and `ChatSession` — create/list/delete projects and sessions, incognito mode, branch graphs, and resuming conversations.
+
+```python
+from composer import ChatProject, HumanMessage, SystemMessage
+
+project = ChatProject.create("my-project")
+session = project.new_session(name="main")
+```
+
+## Development
+
+```bash
+uv sync --group dev
+pytest
+python manage.py migrate   # uses ./db.sqlite3 in the repo checkout
+```
+
+## Publish
+
+```bash
+uv sync --group dev
+python -m build
+twine upload --repository testpypi dist/*   # test first
+twine upload dist/*                         # production PyPI
+```

composer_agent-0.1.0/README.md

@@ -0,0 +1,59 @@
+# Composer
+
+Thread-based agents with typed streaming, tool-hide rules, branch compression, and optional Django persistence.
+
+## Install
+
+```bash
+pip install composer-agent
+```
+
+With chat persistence (Django + SQLite):
+
+```bash
+pip install composer-agent[django]
+composer-migrate
+```
+
+The default database path is `~/.composer/db.sqlite3`. Override with `COMPOSER_DB_PATH`.
+
+## Quick start
+
+```python
+from composer import Agent, HumanMessage, SystemMessage, Thread
+
+agent = Agent(model="...", base_url="...", api_key="...")
+thread = Thread()
+SystemMessage("You are a helpful assistant.") | thread
+thread.append(HumanMessage("Hello"))
+reply = thread.invoke(agent)
+print(reply.content)
+```
+
+## Chat persistence
+
+See [docs/chat_persistence.md](docs/chat_persistence.md) for the full guide on `ChatProject` and `ChatSession` — create/list/delete projects and sessions, incognito mode, branch graphs, and resuming conversations.
+
+```python
+from composer import ChatProject, HumanMessage, SystemMessage
+
+project = ChatProject.create("my-project")
+session = project.new_session(name="main")
+```
+
+## Development
+
+```bash
+uv sync --group dev
+pytest
+python manage.py migrate   # uses ./db.sqlite3 in the repo checkout
+```
+
+## Publish
+
+```bash
+uv sync --group dev
+python -m build
+twine upload --repository testpypi dist/*   # test first
+twine upload dist/*                         # production PyPI
+```

composer_agent-0.1.0/chat/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class ChatConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "chat"

composer_agent-0.1.0/chat/migrations/0001_initial.py

@@ -0,0 +1,83 @@
+# Generated by Django 6.0.6 on 2026-06-07 17:56
+
+import django.db.models.deletion
+import uuid
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='ChatSession',
+            fields=[
+                ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
+                ('name', models.CharField(blank=True, default='', max_length=255)),
+                ('config', models.JSONField(default=dict)),
+                ('active_branch_id', models.UUIDField()),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+            ],
+            options={
+                'ordering': ['-updated_at'],
+            },
+        ),
+        migrations.CreateModel(
+            name='Project',
+            fields=[
+                ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
+                ('name', models.CharField(max_length=255, unique=True)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+            ],
+            options={
+                'ordering': ['name'],
+            },
+        ),
+        migrations.CreateModel(
+            name='BranchNodeRecord',
+            fields=[
+                ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
+                ('compressed_payload', models.JSONField(blank=True, null=True)),
+                ('compressed_through', models.PositiveIntegerField()),
+                ('visible_end', models.PositiveIntegerField(blank=True, null=True)),
+                ('child_order', models.JSONField(default=list)),
+                ('parent', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='children_nodes', to='chat.branchnoderecord')),
+                ('session', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='branch_nodes', to='chat.chatsession')),
+            ],
+            options={
+                'ordering': ['compressed_through'],
+            },
+        ),
+        migrations.AddField(
+            model_name='chatsession',
+            name='project',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='sessions', to='chat.project'),
+        ),
+        migrations.CreateModel(
+            name='StoredMessage',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('position', models.PositiveIntegerField()),
+                ('message_type', models.CharField(max_length=32)),
+                ('payload', models.JSONField()),
+                ('session', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='messages', to='chat.chatsession')),
+            ],
+            options={
+                'ordering': ['position'],
+            },
+        ),
+        migrations.AddConstraint(
+            model_name='chatsession',
+            constraint=models.UniqueConstraint(condition=models.Q(('name', ''), _negated=True), fields=('project', 'name'), name='uniq_named_session_per_project'),
+        ),
+        migrations.AddConstraint(
+            model_name='storedmessage',
+            constraint=models.UniqueConstraint(fields=('session', 'position'), name='uniq_message_position_per_session'),
+        ),
+    ]

composer_agent-0.1.0/chat/models.py

@@ -0,0 +1,88 @@
+import uuid
+
+from django.db import models
+from django.db.models import Q
+
+
+class Project(models.Model):
+    id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
+    name = models.CharField(max_length=255, unique=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        ordering = ["name"]
+
+    def __str__(self) -> str:
+        return self.name
+
+
+class ChatSession(models.Model):
+    id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
+    project = models.ForeignKey(
+        Project,
+        on_delete=models.CASCADE,
+        related_name="sessions",
+    )
+    name = models.CharField(max_length=255, blank=True, default="")
+    config = models.JSONField(default=dict)
+    active_branch_id = models.UUIDField()
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        ordering = ["-updated_at"]
+        constraints = [
+            models.UniqueConstraint(
+                fields=["project", "name"],
+                condition=~Q(name=""),
+                name="uniq_named_session_per_project",
+            ),
+        ]
+
+    def __str__(self) -> str:
+        label = self.name or str(self.id)
+        return f"{self.project.name}:{label}"
+
+
+class StoredMessage(models.Model):
+    session = models.ForeignKey(
+        ChatSession,
+        on_delete=models.CASCADE,
+        related_name="messages",
+    )
+    position = models.PositiveIntegerField()
+    message_type = models.CharField(max_length=32)
+    payload = models.JSONField()
+
+    class Meta:
+        ordering = ["position"]
+        constraints = [
+            models.UniqueConstraint(
+                fields=["session", "position"],
+                name="uniq_message_position_per_session",
+            ),
+        ]
+
+
+class BranchNodeRecord(models.Model):
+    id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
+    session = models.ForeignKey(
+        ChatSession,
+        on_delete=models.CASCADE,
+        related_name="branch_nodes",
+    )
+    parent = models.ForeignKey(
+        "self",
+        on_delete=models.CASCADE,
+        null=True,
+        blank=True,
+        related_name="children_nodes",
+    )
+    compressed_payload = models.JSONField(null=True, blank=True)
+    compressed_through = models.PositiveIntegerField()
+    visible_end = models.PositiveIntegerField(null=True, blank=True)
+    child_order = models.JSONField(default=list)
+
+    class Meta:
+        ordering = ["compressed_through"]

composer_agent-0.1.0/composer/__init__.py

@@ -0,0 +1,97 @@
+"""Composer — thread-based agents with typed streaming."""
+
+__version__ = "0.1.0"
+
+from .agent import (
+    Agent,
+    MCPClient,
+    MCPPromptInfo,
+    MCPResourceInfo,
+    StreamEvent,
+    StreamEventKind,
+    StreamEventProcessor,
+    ThinkingEvent,
+    AssistantEvent,
+    ToolCallEvent,
+    ToolResultEvent,
+    ToolCall,
+    ToolResult,
+    combine_tools,
+    extract_thinking,
+    extract_assistant_text,
+)
+from .tools import run_tool_call
+from .vector import Vector
+from .image import ImageAttach
+from .thread import (
+    Thread,
+    HumanMessage,
+    ImageMessage,
+    AIMessage,
+    SystemMessage,
+    ToolMessage,
+    CompressedMessage,
+    Message,
+    EncoderType,
+    TokenCalculator,
+)
+from .tool_hide import (
+    ToolResultHideRule,
+    HideMode,
+    get_original_content,
+    is_hidden_for_model,
+    message_matches_rule,
+    resolve_full_tool_name,
+    restore_hidden_tool_messages,
+)
+
+__all__ = [
+    "Agent",
+    "Vector",
+    "MCPClient",
+    "MCPPromptInfo",
+    "MCPResourceInfo",
+    "Thread",
+    "HumanMessage",
+    "ImageMessage",
+    "ImageAttach",
+    "AIMessage",
+    "SystemMessage",
+    "ToolMessage",
+    "CompressedMessage",
+    "Message",
+    "EncoderType",
+    "TokenCalculator",
+    "HideMode",
+    "ToolResultHideRule",
+    "get_original_content",
+    "is_hidden_for_model",
+    "message_matches_rule",
+    "resolve_full_tool_name",
+    "restore_hidden_tool_messages",
+    "ThinkingEvent",
+    "AssistantEvent",
+    "ToolCallEvent",
+    "ToolResultEvent",
+    "StreamEvent",
+    "StreamEventKind",
+    "StreamEventProcessor",
+    "ToolCall",
+    "ToolResult",
+    "combine_tools",
+    "run_tool_call",
+    "extract_thinking",
+    "extract_assistant_text",
+    "ChatProject",
+    "ChatSession",
+]
+
+_LAZY_IMPORTS = {"ChatProject", "ChatSession"}
+
+
+def __getattr__(name: str):
+    if name in _LAZY_IMPORTS:
+        from .persistence import ChatProject, ChatSession
+
+        return {"ChatProject": ChatProject, "ChatSession": ChatSession}[name]
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")