intentkit 0.7.5.dev4__tar.gz → 0.7.5.dev5__tar.gz

{intentkit-0.7.5.dev4 → intentkit-0.7.5.dev5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 0.7.5.dev4
+Version: 0.7.5.dev5
 Summary: Intent-based AI Agent Platform - Core Package
 Project-URL: Homepage, https://github.com/crestalnetwork/intentkit
 Project-URL: Repository, https://github.com/crestalnetwork/intentkit

{intentkit-0.7.5.dev4 → intentkit-0.7.5.dev5}/__init__.py

@@ -3,7 +3,7 @@
 A powerful platform for building AI agents with blockchain and cryptocurrency capabilities.
 """
 
-__version__ = "0.7.5-dev4"
+__version__ = "0.7.5-dev5"
 __author__ = "hyacinthus"
 __email__ = "hyacinthus@gmail.com"
 

{intentkit-0.7.5.dev4 → intentkit-0.7.5.dev5}/core/agent.py

@@ -286,7 +286,7 @@ async def deploy_agent(
         return agent_response
 
     if owner and owner != existing_agent.owner:
-        raise IntentKitAPIError(403, "forbidden", "forbidden")
+        raise IntentKitAPIError(403, "Forbidden", "forbidden")
 
     # Update agent
     latest_agent = await agent.override(agent_id)

{intentkit-0.7.5.dev4 → intentkit-0.7.5.dev5}/core/chat.py

@@ -46,4 +46,6 @@ async def clear_thread_memory(agent_id: str, chat_id: str) -> bool:
         logger.error(
             f"Failed to clear thread memory for agent_id: {agent_id}, chat_id: {chat_id}. Error: {str(e)}"
         )
-        raise IntentKitAPIError(500, "ServerError", "Failed to clear thread memory")
+        raise IntentKitAPIError(
+            status_code=500, key="ServerError", message="Failed to clear thread memory"
+        )

{intentkit-0.7.5.dev4 → intentkit-0.7.5.dev5}/core/credit.py

@@ -4,7 +4,6 @@ from decimal import ROUND_HALF_UP, Decimal
 from typing import List, Optional, Tuple
 
 from epyxid import XID
-from fastapi import HTTPException
 from pydantic import BaseModel
 from sqlalchemy import desc, select
 from sqlalchemy.ext.asyncio import AsyncSession
@@ -39,6 +38,7 @@ from intentkit.models.credit import (
 )
 from intentkit.models.db import get_session
 from intentkit.models.skill import Skill
+from intentkit.utils.error import IntentKitAPIError
 from intentkit.utils.slack_alert import send_slack_message
 
 logger = logging.getLogger(__name__)
@@ -72,7 +72,9 @@ async def update_credit_event_note(
     event = result.scalar_one_or_none()
 
     if not event:
-        raise HTTPException(status_code=404, detail="Credit event not found")
+        raise IntentKitAPIError(
+            status_code=404, key="CreditEventNotFound", message="Credit event not found"
+        )
 
     # Update the note
     event.note = note
@@ -244,10 +246,14 @@ async def withdraw(
     # Get agent to retrieve user_id from agent.owner
     agent = await Agent.get(agent_id)
     if not agent:
-        raise HTTPException(status_code=404, detail="Agent not found")
+        raise IntentKitAPIError(
+            status_code=404, key="AgentNotFound", message="Agent not found"
+        )
 
     if not agent.owner:
-        raise HTTPException(status_code=400, detail="Agent has no owner")
+        raise IntentKitAPIError(
+            status_code=400, key="AgentNoOwner", message="Agent has no owner"
+        )
 
     # Get agent wallet address
     agent_data = await AgentData.get(agent.id)
@@ -264,9 +270,10 @@ async def withdraw(
 
     # Check if agent has sufficient permanent credits
     if agent_account.credits < amount:
-        raise HTTPException(
+        raise IntentKitAPIError(
             status_code=400,
-            detail=f"Insufficient balance. Available: {agent_account.credits}, Required: {amount}",
+            key="InsufficientBalance",
+            message=f"Insufficient balance. Available: {agent_account.credits}, Required: {amount}",
         )
 
     # 1. Create credit event record first to get event_id
@@ -916,9 +923,10 @@ async def fetch_credit_event_by_upstream_tx_id(
 
     # Raise 404 if not found
     if not result:
-        raise HTTPException(
+        raise IntentKitAPIError(
             status_code=404,
-            detail=f"Credit event with upstream_tx_id '{upstream_tx_id}' not found",
+            key="CreditEventNotFound",
+            message=f"Credit event with upstream_tx_id '{upstream_tx_id}' not found",
         )
 
     # Convert to Pydantic model and return
@@ -940,7 +948,7 @@ async def fetch_credit_event_by_id(
         The credit event if found.
 
     Raises:
-        HTTPException: If the credit event is not found.
+        IntentKitAPIError: If the credit event is not found.
     """
     # Build the query to find the event by ID
     stmt = select(CreditEventTable).where(CreditEventTable.id == event_id)
@@ -950,9 +958,10 @@ async def fetch_credit_event_by_id(
 
     # Raise 404 if not found
     if not result:
-        raise HTTPException(
+        raise IntentKitAPIError(
             status_code=404,
-            detail=f"Credit event with ID '{event_id}' not found",
+            key="CreditEventNotFound",
+            message=f"Credit event with ID '{event_id}' not found",
         )
 
     # Convert to Pydantic model and return

{intentkit-0.7.5.dev4 → intentkit-0.7.5.dev5}/core/engine.py

@@ -21,7 +21,6 @@ from typing import Optional
 
 import sqlalchemy
 from epyxid import XID
-from fastapi import HTTPException
 from langchain_core.messages import (
     BaseMessage,
     HumanMessage,
@@ -194,7 +193,9 @@ async def initialize_agent(aid, is_private=False):
     # get the agent from the database
     agent: Optional[Agent] = await Agent.get(aid)
     if not agent:
-        raise HTTPException(status_code=404, detail="Agent not found")
+        raise IntentKitAPIError(
+            status_code=404, key="AgentNotFound", message="Agent not found"
+        )
 
     # Create the agent using the new create_agent function
     executor = await create_agent(agent, is_private)
@@ -214,7 +215,9 @@ async def agent_executor(
     start = time.perf_counter()
     agent = await Agent.get(agent_id)
     if not agent:
-        raise HTTPException(status_code=404, detail="Agent not found")
+        raise IntentKitAPIError(
+            status_code=404, key="AgentNotFound", message="Agent not found"
+        )
     agents = _private_agents if is_private else _agents
     agents_updated = _private_agents_updated if is_private else _agents_updated
 
@@ -830,9 +833,10 @@ async def clean_agent_memory(
     # get the agent from the database
     try:
         if not clean_skill and not clean_agent:
-            raise HTTPException(
+            raise IntentKitAPIError(
                 status_code=400,
-                detail="at least one of skills data or agent memory should be true.",
+                key="InvalidCleanupParameters",
+                message="at least one of skills data or agent memory should be true",
             )
 
         if clean_skill:
@@ -879,7 +883,7 @@ async def clean_agent_memory(
     except SQLAlchemyError as e:
         # Handle other SQLAlchemy-related errors
         logger.error(e)
-        raise HTTPException(status_code=500, detail=str(e))
+        raise IntentKitAPIError(status_code=500, key="DatabaseError", message=str(e))
     except Exception as e:
         logger.error("failed to cleanup the agent memory: " + str(e))
         raise e

{intentkit-0.7.5.dev4 → intentkit-0.7.5.dev5}/models/agent.py

@@ -12,13 +12,13 @@ import jsonref
 import yaml
 from cron_validator import CronValidator
 from epyxid import XID
-from fastapi import HTTPException
 from intentkit.models.agent_data import AgentData
 from intentkit.models.base import Base
 from intentkit.models.credit import CreditAccount
 from intentkit.models.db import get_session
 from intentkit.models.llm import LLMModelInfo, LLMModelInfoTable, LLMProvider
 from intentkit.models.skill import SkillTable
+from intentkit.utils.error import IntentKitAPIError
 from pydantic import BaseModel, ConfigDict, field_validator
 from pydantic import Field as PydanticField
 from pydantic.json_schema import SkipJsonSchema
@@ -791,20 +791,25 @@ class AgentUpdate(AgentUserInput):
         for autonomous_config in self.autonomous:
             # Check that exactly one scheduling method is provided
             if not autonomous_config.minutes and not autonomous_config.cron:
-                raise HTTPException(
-                    status_code=400, detail="either minutes or cron must have a value"
+                raise IntentKitAPIError(
+                    status_code=400,
+                    key="InvalidAutonomousConfig",
+                    message="either minutes or cron must have a value",
                 )
 
             if autonomous_config.minutes and autonomous_config.cron:
-                raise HTTPException(
-                    status_code=400, detail="only one of minutes or cron can be set"
+                raise IntentKitAPIError(
+                    status_code=400,
+                    key="InvalidAutonomousConfig",
+                    message="only one of minutes or cron can be set",
                 )
 
             # Validate minimum interval of 5 minutes
             if autonomous_config.minutes and autonomous_config.minutes < 5:
-                raise HTTPException(
+                raise IntentKitAPIError(
                     status_code=400,
-                    detail="The shortest execution interval is 5 minutes",
+                    key="InvalidAutonomousInterval",
+                    message="The shortest execution interval is 5 minutes",
                 )
 
             # Validate cron expression to ensure interval is at least 5 minutes
@@ -814,15 +819,18 @@ class AgentUpdate(AgentUserInput):
                 try:
                     CronValidator.parse(autonomous_config.cron)
                 except ValueError:
-                    raise HTTPException(
+                    raise IntentKitAPIError(
                         status_code=400,
-                        detail=f"Invalid cron expression format: {autonomous_config.cron}",
+                        key="InvalidCronExpression",
+                        message=f"Invalid cron expression format: {autonomous_config.cron}",
                     )
 
                 parts = autonomous_config.cron.split()
                 if len(parts) < 5:
-                    raise HTTPException(
-                        status_code=400, detail="Invalid cron expression format"
+                    raise IntentKitAPIError(
+                        status_code=400,
+                        key="InvalidCronExpression",
+                        message="Invalid cron expression format",
                     )
 
                 minute, hour, day_of_month, month, day_of_week = parts[:5]
@@ -830,25 +838,28 @@ class AgentUpdate(AgentUserInput):
                 # Check if minutes or hours have too frequent intervals
                 if "*" in minute and "*" in hour:
                     # If both minute and hour are wildcards, it would run every minute
-                    raise HTTPException(
+                    raise IntentKitAPIError(
                         status_code=400,
-                        detail="The shortest execution interval is 5 minutes",
+                        key="InvalidAutonomousInterval",
+                        message="The shortest execution interval is 5 minutes",
                     )
 
                 if "/" in minute:
                     # Check step value in minute field (e.g., */15)
                     step = int(minute.split("/")[1])
                     if step < 5 and hour == "*":
-                        raise HTTPException(
+                        raise IntentKitAPIError(
                             status_code=400,
-                            detail="The shortest execution interval is 5 minutes",
+                            key="InvalidAutonomousInterval",
+                            message="The shortest execution interval is 5 minutes",
                         )
 
                 # Check for comma-separated values or ranges that might result in multiple executions per hour
                 if ("," in minute or "-" in minute) and hour == "*":
-                    raise HTTPException(
+                    raise IntentKitAPIError(
                         status_code=400,
-                        detail="The shortest execution interval is 5 minutes",
+                        key="InvalidAutonomousInterval",
+                        message="The shortest execution interval is 5 minutes",
                     )
 
     # deprecated, use override instead
@@ -860,7 +871,11 @@ class AgentUpdate(AgentUserInput):
         async with get_session() as db:
             db_agent = await db.get(AgentTable, id)
             if not db_agent:
-                raise HTTPException(status_code=404, detail="Agent not found")
+                raise IntentKitAPIError(
+                    status_code=404,
+                    key="AgentNotFound",
+                    message="Agent not found",
+                )
             # update
             for key, value in self.model_dump(exclude_unset=True).items():
                 setattr(db_agent, key, value)
@@ -876,7 +891,11 @@ class AgentUpdate(AgentUserInput):
         async with get_session() as db:
             db_agent = await db.get(AgentTable, id)
             if not db_agent:
-                raise HTTPException(status_code=404, detail="Agent not found")
+                raise IntentKitAPIError(
+                    status_code=404,
+                    key="AgentNotFound",
+                    message="Agent not found",
+                )
             # update
             for key, value in self.model_dump().items():
                 setattr(db_agent, key, value)
@@ -917,9 +936,10 @@ class AgentCreate(AgentUpdate):
                 select(AgentTable).where(AgentTable.upstream_id == self.upstream_id)
             )
             if existing:
-                raise HTTPException(
+                raise IntentKitAPIError(
                     status_code=400,
-                    detail="Upstream id already in use",
+                    key="UpstreamIdConflict",
+                    message="Upstream id already in use",
                 )
 
     async def get_by_upstream_id(self) -> Optional["Agent"]:

{intentkit-0.7.5.dev4 → intentkit-0.7.5.dev5}/models/agent_data.py

@@ -3,9 +3,9 @@ from datetime import datetime, timezone
 from decimal import Decimal
 from typing import Annotated, Any, Dict, Optional
 
-from fastapi import HTTPException
 from intentkit.models.base import Base
 from intentkit.models.db import get_session
+from intentkit.utils.error import IntentKitAPIError
 from pydantic import BaseModel, ConfigDict
 from pydantic import Field as PydanticField
 from sqlalchemy import (
@@ -754,7 +754,11 @@ class AgentQuota(BaseModel):
                 await session.execute(stmt)
         except Exception as e:
             logger.error(f"Error adding free income: {str(e)}")
-            raise HTTPException(status_code=500, detail=f"Database error: {str(e)}")
+            raise IntentKitAPIError(
+                status_code=500,
+                key="DatabaseError",
+                message=f"Database error: {str(e)}",
+            )
 
     async def add_message(self) -> None:
         """Add a message to the agent's message count."""

{intentkit-0.7.5.dev4 → intentkit-0.7.5.dev5}/models/credit.py

@@ -9,6 +9,7 @@ from fastapi import HTTPException
 from intentkit.models.app_setting import AppSetting
 from intentkit.models.base import Base
 from intentkit.models.db import get_session
+from intentkit.utils.error import IntentKitAPIError
 from pydantic import BaseModel, ConfigDict, Field, field_validator
 from sqlalchemy import (
     ARRAY,
@@ -347,7 +348,11 @@ class CreditAccount(BaseModel):
         )
         result = await session.scalar(stmt)
         if not result:
-            raise HTTPException(status_code=404, detail="Credit account not found")
+            raise IntentKitAPIError(
+                status_code=404,
+                key="CreditAccountNotFound",
+                message="Credit account not found",
+            )
         return cls.model_validate(result)
 
     @classmethod
@@ -451,7 +456,11 @@ class CreditAccount(BaseModel):
         )
         res = await session.scalar(stmt)
         if not res:
-            raise HTTPException(status_code=500, detail="Failed to expense credits")
+            raise IntentKitAPIError(
+                status_code=500,
+                key="CreditExpenseFailed",
+                message="Failed to expense credits",
+            )
         return cls.model_validate(res)
 
     @classmethod
@@ -548,7 +557,11 @@ class CreditAccount(BaseModel):
         )
         res = await session.scalar(stmt)
         if not res:
-            raise HTTPException(status_code=500, detail="Failed to expense credits")
+            raise IntentKitAPIError(
+                status_code=500,
+                key="CreditExpenseFailed",
+                message="Failed to expense credits",
+            )
         return cls.model_validate(res), details
 
     def has_sufficient_credits(self, amount: Decimal) -> bool:

{intentkit-0.7.5.dev4 → intentkit-0.7.5.dev5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "intentkit"
-version = "0.7.5-dev4"
+version = "0.7.5-dev5"
 description = "Intent-based AI Agent Platform - Core Package"
 authors = [{ name = "hyacinthus", email = "hyacinthus@gmail.com" }]
 requires-python = ">=3.12"

{intentkit-0.7.5.dev4 → intentkit-0.7.5.dev5}/utils/error.py

@@ -23,6 +23,9 @@ class RateLimitExceeded(Exception):
 
 
 class IntentKitAPIError(Exception):
+    """All 3 parameters: status_code, key and message is required.
+    The key is PascalCase string, to allow the frontend to test errors."""
+
     def __init__(self, status_code: int, key: str, message: str):
         self.key = key
         self.message = message