intentkit 0.7.5.dev9__py3-none-any.whl → 0.7.5.dev11__py3-none-any.whl

intentkit/__init__.py

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

intentkit/core/agent.py

@@ -2,7 +2,7 @@ import logging
 import time
 from datetime import datetime, timedelta, timezone
 from decimal import Decimal
-from typing import Any, Dict, List, Optional
+from typing import Any, Dict, List, Optional, Tuple
 
 from sqlalchemy import func, select, text, update
 
@@ -193,53 +193,35 @@ def send_agent_notification(agent: Agent, agent_data: AgentData, message: str) -
     )
 
 
-async def deploy_agent(
+async def override_agent(
     agent_id: str, agent: AgentUpdate, owner: Optional[str] = None
-) -> Agent:
-    """Override an existing agent.
+) -> Tuple[Agent, AgentData]:
+    """Override an existing agent with new configuration.
 
-    Use input to override agent configuration. If some fields are not provided, they will be reset to default values.
+    This function updates an existing agent with the provided configuration.
+    If some fields are not provided, they will be reset to default values.
 
     Args:
-        agent_id: ID of the agent to update
-        agent: Agent update configuration
-        owner: Optional owner for the agent
+        agent_id: ID of the agent to override
+        agent: Agent update configuration containing the new settings
+        owner: Optional owner for permission validation
 
     Returns:
         tuple[Agent, AgentData]: Updated agent configuration and processed agent data
 
     Raises:
-        HTTPException:
-            - 400: Invalid agent ID format
+        IntentKitAPIError:
             - 404: Agent not found
             - 403: Permission denied (if owner mismatch)
-            - 500: Database error
+            - 400: Invalid configuration or wallet provider change
     """
     existing_agent = await Agent.get(agent_id)
-
     if not existing_agent:
-        new_agent = AgentCreate.model_validate(agent)
-        new_agent.id = agent_id
-        if owner:
-            new_agent.owner = owner
-        else:
-            new_agent.owner = "system"
-        # Check for existing agent by upstream_id, forward compatibility, raise error after 3.0
-        existing = await new_agent.get_by_upstream_id()
-        if existing:
-            raise IntentKitAPIError(
-                status_code=400,
-                key="BadRequest",
-                message="Agent with this upstream ID already exists",
-            )
-
-        # Create new agent
-        latest_agent = await new_agent.create()
-        agent_data = await process_agent_wallet(latest_agent)
-        send_agent_notification(latest_agent, agent_data, "Agent Deployed")
-
-        return latest_agent, agent_data
-
+        raise IntentKitAPIError(
+            status_code=404,
+            key="AgentNotFound",
+            message=f"Agent with ID '{agent_id}' not found",
+        )
     if owner and owner != existing_agent.owner:
         raise IntentKitAPIError(403, "Forbidden", "forbidden")
 
@@ -253,6 +235,79 @@ async def deploy_agent(
     return latest_agent, agent_data
 
 
+async def create_agent(agent: AgentCreate) -> Tuple[Agent, AgentData]:
+    """Create a new agent with the provided configuration.
+
+    This function creates a new agent instance with the given configuration,
+    initializes its wallet, and sends a notification about the creation.
+
+    Args:
+        agent: Agent creation configuration containing all necessary settings
+
+    Returns:
+        tuple[Agent, AgentData]: Created agent configuration and processed agent data
+
+    Raises:
+        IntentKitAPIError:
+            - 400: Agent with upstream ID already exists or invalid configuration
+            - 500: Database error or wallet initialization failure
+    """
+    if not agent.owner:
+        agent.owner = "system"
+    # Check for existing agent by upstream_id, forward compatibility, raise error after 3.0
+    existing = await agent.get_by_upstream_id()
+    if existing:
+        raise IntentKitAPIError(
+            status_code=400,
+            key="BadRequest",
+            message="Agent with this upstream ID already exists",
+        )
+
+    # Create new agent
+    latest_agent = await agent.create()
+    agent_data = await process_agent_wallet(latest_agent)
+    send_agent_notification(latest_agent, agent_data, "Agent Deployed")
+
+    return latest_agent, agent_data
+
+
+async def deploy_agent(
+    agent_id: str, agent: AgentUpdate, owner: Optional[str] = None
+) -> Tuple[Agent, AgentData]:
+    """Deploy an agent by first attempting to override, then creating if not found.
+
+    This function first tries to override an existing agent. If the agent is not found
+    (404 error), it will create a new agent instead.
+
+    Args:
+        agent_id: ID of the agent to deploy
+        agent: Agent configuration data
+        owner: Optional owner for the agent
+
+    Returns:
+        tuple[Agent, AgentData]: Deployed agent configuration and processed agent data
+
+    Raises:
+        IntentKitAPIError:
+            - 400: Invalid agent configuration or upstream ID conflict
+            - 403: Permission denied (if owner mismatch)
+            - 500: Database error
+    """
+    try:
+        # First try to override the existing agent
+        return await override_agent(agent_id, agent, owner)
+    except IntentKitAPIError as e:
+        # If agent not found (404), create a new one
+        if e.status_code == 404:
+            new_agent = AgentCreate.model_validate(agent)
+            new_agent.id = agent_id
+            new_agent.owner = owner
+            return await create_agent(new_agent)
+        else:
+            # Re-raise other errors
+            raise
+
+
 async def agent_action_cost(agent_id: str) -> Dict[str, Decimal]:
     """
     Calculate various action cost metrics for an agent based on past three days of credit events.

intentkit/core/engine.py

@@ -17,7 +17,7 @@ import textwrap
 import time
 import traceback
 from datetime import datetime
-from typing import Optional
+from typing import Optional, Tuple
 
 import sqlalchemy
 from epyxid import XID
@@ -211,7 +211,7 @@ async def initialize_agent(aid, is_private=False):
 
 async def agent_executor(
     agent_id: str, is_private: bool
-) -> (CompiledStateGraph, float):
+) -> Tuple[CompiledStateGraph, float]:
     start = time.perf_counter()
     agent = await Agent.get(agent_id)
     if not agent:

intentkit/models/agent.py

@@ -34,6 +34,7 @@ from sqlalchemy import (
     select,
 )
 from sqlalchemy.dialects.postgresql import JSON, JSONB
+from sqlalchemy.exc import IntegrityError
 from sqlalchemy.ext.asyncio import AsyncSession
 
 logger = logging.getLogger(__name__)
@@ -960,12 +961,20 @@ class AgentCreate(AgentUpdate):
             self.validate_autonomous_schedule()
 
         async with get_session() as db:
-            db_agent = AgentTable(**self.model_dump())
-            db_agent.version = self.hash()
-            db.add(db_agent)
-            await db.commit()
-            await db.refresh(db_agent)
-            return Agent.model_validate(db_agent)
+            try:
+                db_agent = AgentTable(**self.model_dump())
+                db_agent.version = self.hash()
+                db.add(db_agent)
+                await db.commit()
+                await db.refresh(db_agent)
+                return Agent.model_validate(db_agent)
+            except IntegrityError:
+                await db.rollback()
+                raise IntentKitAPIError(
+                    status_code=400,
+                    key="AgentExists",
+                    message=f"Agent with ID '{self.id}' already exists",
+                )
 
 
 class AgentPublicInfo(BaseModel):
@@ -1509,16 +1518,16 @@ class AgentResponse(Agent):
     )
 
     # Override privacy fields to exclude them from JSON schema
-    purpose: Annotated[Optional[str], SkipJsonSchema] = None
-    personality: Annotated[Optional[str], SkipJsonSchema] = None
-    principles: Annotated[Optional[str], SkipJsonSchema] = None
-    prompt: Annotated[Optional[str], SkipJsonSchema] = None
-    prompt_append: Annotated[Optional[str], SkipJsonSchema] = None
-    temperature: Annotated[Optional[float], SkipJsonSchema] = None
-    frequency_penalty: Annotated[Optional[float], SkipJsonSchema] = None
-    telegram_entrypoint_prompt: Annotated[Optional[str], SkipJsonSchema] = None
-    telegram_config: Annotated[Optional[dict], SkipJsonSchema] = None
-    xmtp_entrypoint_prompt: Annotated[Optional[str], SkipJsonSchema] = None
+    purpose: SkipJsonSchema[Optional[str]] = None
+    personality: SkipJsonSchema[Optional[str]] = None
+    principles: SkipJsonSchema[Optional[str]] = None
+    prompt: SkipJsonSchema[Optional[str]] = None
+    prompt_append: SkipJsonSchema[Optional[str]] = None
+    temperature: SkipJsonSchema[Optional[float]] = None
+    frequency_penalty: SkipJsonSchema[Optional[float]] = None
+    telegram_entrypoint_prompt: SkipJsonSchema[Optional[str]] = None
+    telegram_config: SkipJsonSchema[Optional[dict]] = None
+    xmtp_entrypoint_prompt: SkipJsonSchema[Optional[str]] = None
 
     # Additional fields specific to AgentResponse
     cdp_wallet_address: Annotated[

{intentkit-0.7.5.dev9.dist-info → intentkit-0.7.5.dev11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 0.7.5.dev9
+Version: 0.7.5.dev11
 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.dev9.dist-info → intentkit-0.7.5.dev11.dist-info}/RECORD

@@ -1,4 +1,4 @@
-intentkit/__init__.py,sha256=46rAmnU-MtPUs_PFUOeb2d-ZfnXhp7RJIABBbN6sLgE,383
+intentkit/__init__.py,sha256=EYPVd8Rl-a6Z7xAISRwBQt7ZOsItVNtwbK-ykpuZSZM,384
 intentkit/abstracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 intentkit/abstracts/agent.py,sha256=108gb5W8Q1Sy4G55F2_ZFv2-_CnY76qrBtpIr0Oxxqk,1489
 intentkit/abstracts/api.py,sha256=ZUc24vaQvQVbbjznx7bV0lbbQxdQPfEV8ZxM2R6wZWo,166
@@ -13,15 +13,15 @@ intentkit/clients/web3.py,sha256=A-w4vBPXHpDh8svsEFj_LkmvRgoDTZw4E-84S-UC9ws,102
 intentkit/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 intentkit/config/config.py,sha256=xDbm5KSXt4rZh2Nak0bmrYv5Rf__mJz8aJ9PHzar-Lk,8941
 intentkit/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-intentkit/core/agent.py,sha256=BMCcBdxbewSJFk3VfJwEWbQks5k0Fg7LsnqRTsCEExY,30006
+intentkit/core/agent.py,sha256=d7P116dG4rmBu0zUF_WuHhcUgUOnaOhhYVzgKymOKZI,32047
 intentkit/core/api.py,sha256=WfoaHNquujYJIpNPuTR1dSaaxog0S3X2W4lG9Ehmkm4,3284
 intentkit/core/chat.py,sha256=YN20CnDazWLjiOZFOHgV6uHmA2DKkvPCsD5Q5sfNcZg,1685
 intentkit/core/client.py,sha256=J5K7f08-ucszBKAbn9K3QNOFKIC__7amTbKYii1jFkI,3056
 intentkit/core/credit.py,sha256=b4f4T6G6eeBTMe0L_r8awWtXgUnqiog4IUaymDPYym0,75587
-intentkit/core/engine.py,sha256=mnsaQqRz1NBgg5Tc0vynDCLwn4G_fbpvCbuVv-7Q15g,36165
+intentkit/core/engine.py,sha256=DoGqfhNK35sFeqMlFLyKR_NUDf1YXf4yihSfw7kufmU,36177
 intentkit/core/node.py,sha256=7h9zgDSd928bzUi3m3EZnKkhbwqlbRAQUr_uz7gKB5Y,8880
 intentkit/core/prompt.py,sha256=ssiyKHDNIjQOLU0KwUlIFX3jy51TqgeKOxrwnW4HBkw,15875
-intentkit/models/agent.py,sha256=PgNNa9QqmqAEOqvJoIZxGWE-JrgFAe3VEdD0EUgaZSM,67182
+intentkit/models/agent.py,sha256=JGQcDvqQFaIbCKqGTHNFkBLFAFCHpeJU4WRlDGG6830,67434
 intentkit/models/agent_data.py,sha256=5zq3EPKnygT2P1OHc2IfEmL8hXkjeBND6sJ0JJsvQJg,28370
 intentkit/models/agent_public.json,sha256=0X8Bd2WOobDJLsok8avWNzmzu4uvKSGEyy6Myn53eT4,2802
 intentkit/models/agent_schema.json,sha256=hFGUE57JIiN8V4olgLf2LBXPejA2QLiQoFc6riM1UFo,17139
@@ -418,7 +418,7 @@ intentkit/utils/random.py,sha256=DymMxu9g0kuQLgJUqalvgksnIeLdS-v0aRk5nQU0mLI,452
 intentkit/utils/s3.py,sha256=9trQNkKQ5VgxWsewVsV8Y0q_pXzGRvsCYP8xauyUYkg,8549
 intentkit/utils/slack_alert.py,sha256=s7UpRgyzLW7Pbmt8cKzTJgMA9bm4EP-1rQ5KXayHu6E,2264
 intentkit/utils/tx.py,sha256=2yLLGuhvfBEY5n_GJ8wmIWLCzn0FsYKv5kRNzw_sLUI,1454
-intentkit-0.7.5.dev9.dist-info/METADATA,sha256=98yN0Ivapq5xqDvUIkUdtkTqQLMGjX3NqyBtL6RNBJs,6409
-intentkit-0.7.5.dev9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-intentkit-0.7.5.dev9.dist-info/licenses/LICENSE,sha256=Bln6DhK-LtcO4aXy-PBcdZv2f24MlJFm_qn222biJtE,1071
-intentkit-0.7.5.dev9.dist-info/RECORD,,
+intentkit-0.7.5.dev11.dist-info/METADATA,sha256=BU2Ep_Nz6XTx27neRFSFT8k48caRCA2qJI4ryttgJcY,6410
+intentkit-0.7.5.dev11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+intentkit-0.7.5.dev11.dist-info/licenses/LICENSE,sha256=Bln6DhK-LtcO4aXy-PBcdZv2f24MlJFm_qn222biJtE,1071
+intentkit-0.7.5.dev11.dist-info/RECORD,,