Merge pull request #925 from crestalnetwork/hyacinthus

feat: add new models and frontend improvements

Author: hyacinthus

CHANGELOG.md

@@ -1,3 +1,41 @@
+## v0.8.34 - 2025-11-28
+
+### Features
+- Add LangGraph 2.0 checkpoints table migration
+- Add dev and prod docker image tags for releases
+- Keep short memory only 90 days
+- Add daily scheduled task to clean up old LangGraph checkpoints, writes, and blobs
+- Team model support
+- Add draft functionality and manager module
+- Third party S3 support
+- Autonomous use internal service to chat
+- Agent testing capabilities
+- Move checker to core
+
+### Fixes
+- Reorder checkpoint migration steps to drop columns after pk update
+- Cache checkpointer
+- Improve checkpointer clean
+- Clean old generator model
+- Cache by agent deploy
+- Change node to middleware
+- Fix astream bug
+- Add basedpyright to llm.md
+
+### Refactoring
+- Migrate checkpointer to shallow saver implementation
+- Migrate langchain agent middleware
+- Move s3 to clients
+
+### Chores
+- Remove EKS deployment steps from CI workflow
+- Disable kubectl deployments in build workflow
+- Disable autonomous, telegram, and checker deployments in testnet-dev
+- Remove x402 server
+- Upgrade dependencies (uv sync --upgrade)
+
+**Full Changelog**: https://github.com/crestalnetwork/intentkit/compare/v0.8.33...v0.8.34
+
 ## v0.8.33 - 2025-11-14
 
 ### Bug Fixes

LLM.md

@@ -31,6 +31,10 @@ IntentKit is an autonomous agent framework that enables creation and management
    - API server testing in `tests/api/`
    - Skill integration testing in `tests/skills/`
 
+5. **Frontend** (`frontend/`)
+   - The frontend/ folder contains the Next.js application for managing agents.
+   - See `intentkit/frontend/AGENTS.md` for detailed architecture and development guidelines.
+
 ## Technology Stack
 - Package manager: uv
 - Virtual environment: .venv, please use `source .venv/bin/activate` at least once to active virtual environment before running any command.
@@ -39,7 +43,7 @@ IntentKit is an autonomous agent framework that enables creation and management
 - API framework: fastapi, Doc in https://fastapi.tiangolo.com/
 - DB ORM: SQLAlchemy 2.0, please check the 2.0 api for use, do not use the legacy way. Doc in https://docs.sqlalchemy.org/en/20/
 - Model: Pydantic V2, Also be careful not to use the obsolete V1 interface. Doc in https://docs.pydantic.dev/latest/
-- Testing Framework: pytest
+- Testing Framework: pytest, run `pytest` after your final edit.
 
 ## Rules
 

README.md

@@ -88,7 +88,6 @@ The project is divided into the core package and the application:
   - [checker.py](app/checker.py): Health and credit checking logic
   - [readonly.py](app/readonly.py): Readonly entrypoint
   - [scheduler.py](app/scheduler.py): Background task scheduler
-  - [singleton.py](app/singleton.py): Singleton agent manager
   - [telegram.py](app/telegram.py): Telegram integration
   - [twitter.py](app/twitter.py): Twitter integration
 

app/admin/__init__.py

@@ -1,19 +1,16 @@
-from app.admin.api import admin_router, admin_router_readonly
-from app.admin.credit import credit_router, credit_router_readonly
+from app.admin.api import admin_router
+from app.admin.credit import credit_router
 from app.admin.health import health_router
-from app.admin.metadata import metadata_router_readonly
-from app.admin.schema import schema_router_readonly
-from app.admin.user import user_router, user_router_readonly
+from app.admin.metadata import metadata_router
+from app.admin.schema import schema_router
+from app.admin.user import user_router
 
 __all__ = [
     "admin_router",
-    "admin_router_readonly",
     "health_router",
-    "schema_router_readonly",
+    "schema_router",
     "credit_router",
-    "credit_router_readonly",
-    "metadata_router_readonly",
+    "metadata_router",
     "user_router",
-    "user_router_readonly",
     "agent_generator_router",
 ]

app/admin/api.py

@@ -43,13 +43,12 @@
 
 from app.auth import verify_admin_jwt
 
-admin_router_readonly = APIRouter()
 admin_router = APIRouter()
 
 logger = logging.getLogger(__name__)
 
 
-@admin_router_readonly.post(
+@admin_router.post(
     "/agent/validate",
     tags=["Agent"],
     status_code=204,
@@ -98,7 +97,7 @@ async def validate_agent_create(
     return Response(status_code=204)
 
 
-@admin_router_readonly.post(
+@admin_router.post(
     "/agents/{agent_id}/validate",
     tags=["Agent"],
     status_code=204,
@@ -331,7 +330,7 @@ async def override_agent_endpoint(
     )
 
 
-@admin_router_readonly.get(
+@admin_router.get(
     "/agents",
     tags=["Agent"],
     dependencies=[Depends(verify_admin_jwt)],
@@ -365,7 +364,7 @@ async def get_agents(db: AsyncSession = Depends(get_db)) -> list[AgentResponse]:
     ]
 
 
-@admin_router_readonly.get(
+@admin_router.get(
     "/agents/{agent_id}",
     tags=["Agent"],
     dependencies=[Depends(verify_admin_jwt)],
@@ -498,7 +497,7 @@ async def clean_memory(
         )
 
 
-@admin_router_readonly.get(
+@admin_router.get(
     "/agents/{agent_id}/export",
     tags=["Agent"],
     operation_id="export_agent",

app/admin/credit.py

@@ -43,7 +43,6 @@
 logger = logging.getLogger(__name__)
 
 credit_router = APIRouter(prefix="/credit", tags=["Credit"])
-credit_router_readonly = APIRouter(prefix="/credit", tags=["Credit"])
 
 
 # ===== Models =====
@@ -362,7 +361,7 @@ async def get_agent_statistics(
     return await agent_statistics.get_agent_statistics(agent_id, session=db)
 
 
-@credit_router_readonly.get(
+@credit_router.get(
     "/users/{user_id}/events",
     response_model=CreditEventsResponse,
     operation_id="list_user_events",
@@ -437,7 +436,7 @@ async def update_event_note(
     )
 
 
-@credit_router_readonly.get(
+@credit_router.get(
     "/event/users/{user_id}/expense",
     response_model=CreditEventsResponse,
     operation_id="list_user_expense_events",
@@ -478,7 +477,7 @@ async def list_user_expense_events(
     )
 
 
-@credit_router_readonly.get(
+@credit_router.get(
     "/transactions",
     response_model=CreditTransactionsResponse,
     operation_id="list_transactions",
@@ -602,7 +601,7 @@ async def list_transactions(
     )
 
 
-@credit_router_readonly.get(
+@credit_router.get(
     "/event/users/{user_id}/income",
     response_model=CreditEventsResponse,
     operation_id="list_user_income_events",
@@ -646,7 +645,7 @@ async def list_user_income_events(
     )
 
 
-@credit_router_readonly.get(
+@credit_router.get(
     "/event/agents/{agent_id}/income",
     response_model=CreditEventsResponse,
     operation_id="list_agent_income_events",
@@ -686,7 +685,7 @@ async def list_agent_income_events(
     )
 
 
-@credit_router_readonly.get(
+@credit_router.get(
     "/event",
     response_model=CreditEvent,
     operation_id="fetch_credit_event_by_upstream_tx_id",
@@ -712,7 +711,7 @@ async def fetch_credit_event(
     return await fetch_credit_event_by_upstream_tx_id(db, upstream_tx_id)
 
 
-@credit_router_readonly.get(
+@credit_router.get(
     "/events/{event_id}",
     response_model=CreditEvent,
     operation_id="fetch_credit_event_by_id",
@@ -774,7 +773,7 @@ async def fetch_credit_event_by_id_endpoint(
     return event
 
 
-@credit_router_readonly.get(
+@credit_router.get(
     "/events",
     operation_id="list_credit_events",
     summary="List Credit Events",

app/admin/metadata.py

@@ -8,7 +8,7 @@
 from intentkit.models.skill import Skill
 
 # Create a readonly router for metadata endpoints
-metadata_router_readonly = APIRouter(tags=["Metadata"])
+metadata_router = APIRouter(tags=["Metadata"])
 
 
 class LLMModelInfoWithProviderName(LLMModelInfo):
@@ -17,7 +17,7 @@ class LLMModelInfoWithProviderName(LLMModelInfo):
     provider_name: str
 
 
-@metadata_router_readonly.get(
+@metadata_router.get(
     "/metadata/skills",
     response_model=list[Skill],
     summary="Get all skills",
@@ -37,7 +37,7 @@ async def get_skills(db: AsyncSession = Depends(get_db)):
         raise
 
 
-@metadata_router_readonly.get(
+@metadata_router.get(
     "/metadata/llms",
     response_model=list[LLMModelInfoWithProviderName],
     summary="Get all LLM models",

app/admin/schema.py

@@ -14,15 +14,13 @@
 logger = logging.getLogger(__name__)
 
 # Create readonly router
-schema_router_readonly = APIRouter()
+schema_router = APIRouter()
 
 # Get the project root directory
 PROJECT_ROOT = Path(__file__).parent.parent.parent
 
 
-@schema_router_readonly.get(
-    "/schema/agent", tags=["Schema"], operation_id="get_agent_schema"
-)
+@schema_router.get("/schema/agent", tags=["Schema"], operation_id="get_agent_schema")
 async def get_agent_schema(db: AsyncSession = Depends(get_db)) -> JSONResponse:
     """Get the JSON schema for Agent model with all $ref references resolved.
 
@@ -41,7 +39,7 @@ async def get_agent_schema(db: AsyncSession = Depends(get_db)) -> JSONResponse:
     )
 
 
-@schema_router_readonly.get(
+@schema_router.get(
     "/skills/{skill}/schema.json",
     tags=["Schema"],
     operation_id="get_skill_schema",
@@ -81,7 +79,7 @@ async def get_skill_schema(
     return JSONResponse(content=schema, media_type="application/json")
 
 
-@schema_router_readonly.get(
+@schema_router.get(
     "/skills/{skill}/{icon_name}.{ext}",
     tags=["Schema"],
     operation_id="get_skill_icon",

app/admin/user.py

@@ -11,10 +11,9 @@
 logger = logging.getLogger(__name__)
 
 user_router = APIRouter(prefix="/users", tags=["User"])
-user_router_readonly = APIRouter(prefix="/users", tags=["User"])
 
 
-@user_router_readonly.get(
+@user_router.get(
     "/{user_id}",
     response_model=User,
     operation_id="get_user",

app/api.py

@@ -31,21 +31,17 @@
 
 from app.admin import (
     admin_router,
-    admin_router_readonly,
     credit_router,
-    credit_router_readonly,
     health_router,
-    metadata_router_readonly,
-    schema_router_readonly,
+    metadata_router,
+    schema_router,
     user_router,
-    user_router_readonly,
 )
-from app.entrypoints.agent_api import router_ro as agent_api_ro
-from app.entrypoints.agent_api import router_rw as agent_api_rw
+from app.entrypoints.agent_api import agent_api_router
 from app.entrypoints.openai_compatible import openai_router
-from app.entrypoints.web import chat_router, chat_router_readonly
-from app.services.twitter.oauth2 import router as twitter_oauth2_router
-from app.services.twitter.oauth2_callback import router as twitter_callback_router
+from app.entrypoints.web import chat_router
+from app.services.twitter.oauth2 import twitter_oauth2_router
+from app.services.twitter.oauth2_callback import twitter_callback_router
 
 logger = logging.getLogger(__name__)
 
@@ -120,8 +116,7 @@ def _load_agent_api_docs() -> str:
 )
 
 # Add routers to the Agent API sub-application
-agent_app.include_router(agent_api_rw)
-agent_app.include_router(agent_api_ro)
+agent_app.include_router(agent_api_router)
 agent_app.include_router(openai_router)
 
 
@@ -190,15 +185,11 @@ async def lifespan(app: FastAPI):
 app.mount("/v1", agent_app)
 
 app.include_router(chat_router)
-app.include_router(chat_router_readonly)
 app.include_router(admin_router)
-app.include_router(admin_router_readonly)
-app.include_router(metadata_router_readonly)
+app.include_router(metadata_router)
 app.include_router(credit_router)
-app.include_router(credit_router_readonly)
-app.include_router(schema_router_readonly)
+app.include_router(schema_router)
 app.include_router(user_router)
-app.include_router(user_router_readonly)
 app.include_router(core_router)
 app.include_router(twitter_callback_router)
 app.include_router(twitter_oauth2_router)