intentkit 0.6.6__py3-none-any.whl → 0.6.7__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.6.6"
+__version__ = "0.6.7"
 __author__ = "hyacinthus"
 __email__ = "hyacinthus@gmail.com"
 

intentkit/abstracts/skill.py

@@ -1,7 +1,7 @@
 from abc import ABC, abstractmethod
-from typing import Any, Dict, Optional
+from typing import Any, Dict, List, Optional
 
-from intentkit.models.agent import Agent
+from intentkit.models.agent import Agent, AgentAutonomous
 from intentkit.models.agent_data import AgentData, AgentQuota
 
 
@@ -139,3 +139,60 @@ class SkillStoreABC(ABC):
             data: JSON data to store
         """
         pass
+
+    @staticmethod
+    @abstractmethod
+    async def list_autonomous_tasks(agent_id: str) -> List[AgentAutonomous]:
+        """List all autonomous tasks for an agent.
+
+        Args:
+            agent_id: ID of the agent
+
+        Returns:
+            List[AgentAutonomous]: List of autonomous task configurations
+        """
+        pass
+
+    @staticmethod
+    @abstractmethod
+    async def add_autonomous_task(
+        agent_id: str, task: AgentAutonomous
+    ) -> AgentAutonomous:
+        """Add a new autonomous task to an agent.
+
+        Args:
+            agent_id: ID of the agent
+            task: Autonomous task configuration
+
+        Returns:
+            AgentAutonomous: The created task
+        """
+        pass
+
+    @staticmethod
+    @abstractmethod
+    async def delete_autonomous_task(agent_id: str, task_id: str) -> None:
+        """Delete an autonomous task from an agent.
+
+        Args:
+            agent_id: ID of the agent
+            task_id: ID of the task to delete
+        """
+        pass
+
+    @staticmethod
+    @abstractmethod
+    async def update_autonomous_task(
+        agent_id: str, task_id: str, task_updates: dict
+    ) -> AgentAutonomous:
+        """Update an autonomous task for an agent.
+
+        Args:
+            agent_id: ID of the agent
+            task_id: ID of the task to update
+            task_updates: Dictionary containing fields to update
+
+        Returns:
+            AgentAutonomous: The updated task
+        """
+        pass

intentkit/core/agent.py

@@ -2,11 +2,12 @@ import logging
 import time
 from datetime import datetime, timedelta, timezone
 from decimal import Decimal
-from typing import Dict
+from typing import Dict, List
 
-from sqlalchemy import func, select, text
+from sqlalchemy import func, select, text, update
 
-from intentkit.models.agent import Agent
+from intentkit.models.agent import Agent, AgentAutonomous, AgentTable
+from intentkit.models.agent_data import AgentQuotaTable
 from intentkit.models.credit import CreditEventTable, EventType, UpstreamType
 from intentkit.models.db import get_session
 from intentkit.utils.error import IntentKitAPIError
@@ -189,3 +190,275 @@ async def agent_action_cost(agent_id: str) -> Dict[str, Decimal]:
         )
 
         return result
+
+
+async def update_agent_action_cost():
+    """
+    Update action costs for all agents.
+
+    This function processes agents in batches of 100 to avoid memory issues.
+    For each agent, it calculates various action cost metrics:
+    - avg_action_cost: average cost per action
+    - min_action_cost: minimum cost per action
+    - max_action_cost: maximum cost per action
+    - low_action_cost: average cost of the lowest 20% of actions
+    - medium_action_cost: average cost of the middle 60% of actions
+    - high_action_cost: average cost of the highest 20% of actions
+
+    It then updates the corresponding record in the agent_quotas table.
+    """
+    logger.info("Starting update of agent average action costs")
+    start_time = time.time()
+    batch_size = 100
+    last_id = None
+    total_updated = 0
+
+    while True:
+        # Get a batch of agent IDs ordered by ID
+        async with get_session() as session:
+            query = select(AgentTable.id).order_by(AgentTable.id)
+
+            # Apply pagination if we have a last_id from previous batch
+            if last_id:
+                query = query.where(AgentTable.id > last_id)
+
+            query = query.limit(batch_size)
+            result = await session.execute(query)
+            agent_ids = [row[0] for row in result]
+
+            # If no more agents, we're done
+            if not agent_ids:
+                break
+
+            # Update last_id for next batch
+            last_id = agent_ids[-1]
+
+        # Process this batch of agents
+        logger.info(
+            f"Processing batch of {len(agent_ids)} agents starting with ID {agent_ids[0]}"
+        )
+        batch_start_time = time.time()
+
+        for agent_id in agent_ids:
+            try:
+                # Calculate action costs for this agent
+                costs = await agent_action_cost(agent_id)
+
+                # Update the agent's quota record
+                async with get_session() as session:
+                    update_stmt = (
+                        update(AgentQuotaTable)
+                        .where(AgentQuotaTable.id == agent_id)
+                        .values(
+                            avg_action_cost=costs["avg_action_cost"],
+                            min_action_cost=costs["min_action_cost"],
+                            max_action_cost=costs["max_action_cost"],
+                            low_action_cost=costs["low_action_cost"],
+                            medium_action_cost=costs["medium_action_cost"],
+                            high_action_cost=costs["high_action_cost"],
+                        )
+                    )
+                    await session.execute(update_stmt)
+                    await session.commit()
+
+                total_updated += 1
+            except Exception as e:
+                logger.error(
+                    f"Error updating action costs for agent {agent_id}: {str(e)}"
+                )
+
+        batch_time = time.time() - batch_start_time
+        logger.info(f"Completed batch in {batch_time:.3f}s")
+
+    total_time = time.time() - start_time
+    logger.info(
+        f"Finished updating action costs for {total_updated} agents in {total_time:.3f}s"
+    )
+
+
+async def list_autonomous_tasks(agent_id: str) -> List[AgentAutonomous]:
+    """
+    List all autonomous tasks for an agent.
+
+    Args:
+        agent_id: ID of the agent
+
+    Returns:
+        List[AgentAutonomous]: List of autonomous task configurations
+
+    Raises:
+        IntentKitAPIError: If agent is not found
+    """
+    agent = await Agent.get(agent_id)
+    if not agent:
+        raise IntentKitAPIError(
+            400, "AgentNotFound", f"Agent with ID {agent_id} does not exist."
+        )
+
+    if not agent.autonomous:
+        return []
+
+    return agent.autonomous
+
+
+async def add_autonomous_task(agent_id: str, task: AgentAutonomous) -> AgentAutonomous:
+    """
+    Add a new autonomous task to an agent.
+
+    Args:
+        agent_id: ID of the agent
+        task: Autonomous task configuration (id will be generated if not provided)
+
+    Returns:
+        AgentAutonomous: The created task with generated ID
+
+    Raises:
+        IntentKitAPIError: If agent is not found
+    """
+    agent = await Agent.get(agent_id)
+    if not agent:
+        raise IntentKitAPIError(
+            400, "AgentNotFound", f"Agent with ID {agent_id} does not exist."
+        )
+
+    # Get current autonomous tasks
+    current_tasks = agent.autonomous or []
+    if not isinstance(current_tasks, list):
+        current_tasks = []
+
+    # Add the new task
+    current_tasks.append(task)
+
+    # Convert all AgentAutonomous objects to dictionaries for JSON serialization
+    serializable_tasks = [task_item.model_dump() for task_item in current_tasks]
+
+    # Update the agent in the database
+    async with get_session() as session:
+        update_stmt = (
+            update(AgentTable)
+            .where(AgentTable.id == agent_id)
+            .values(autonomous=serializable_tasks)
+        )
+        await session.execute(update_stmt)
+        await session.commit()
+
+    logger.info(f"Added autonomous task {task.id} to agent {agent_id}")
+    return task
+
+
+async def delete_autonomous_task(agent_id: str, task_id: str) -> None:
+    """
+    Delete an autonomous task from an agent.
+
+    Args:
+        agent_id: ID of the agent
+        task_id: ID of the task to delete
+
+    Raises:
+        IntentKitAPIError: If agent is not found or task is not found
+    """
+    agent = await Agent.get(agent_id)
+    if not agent:
+        raise IntentKitAPIError(
+            400, "AgentNotFound", f"Agent with ID {agent_id} does not exist."
+        )
+
+    # Get current autonomous tasks
+    current_tasks = agent.autonomous or []
+    if not isinstance(current_tasks, list):
+        current_tasks = []
+
+    # Find and remove the task
+    task_found = False
+    updated_tasks = []
+    for task_data in current_tasks:
+        if task_data.id == task_id:
+            task_found = True
+            continue
+        updated_tasks.append(task_data)
+
+    if not task_found:
+        raise IntentKitAPIError(
+            404, "TaskNotFound", f"Autonomous task with ID {task_id} not found."
+        )
+
+    # Convert remaining AgentAutonomous objects to dictionaries for JSON serialization
+    serializable_tasks = [task_item.model_dump() for task_item in updated_tasks]
+
+    # Update the agent in the database
+    async with get_session() as session:
+        update_stmt = (
+            update(AgentTable)
+            .where(AgentTable.id == agent_id)
+            .values(autonomous=serializable_tasks)
+        )
+        await session.execute(update_stmt)
+        await session.commit()
+
+    logger.info(f"Deleted autonomous task {task_id} from agent {agent_id}")
+
+
+async def update_autonomous_task(
+    agent_id: str, task_id: str, task_updates: dict
+) -> AgentAutonomous:
+    """
+    Update an autonomous task for an agent.
+
+    Args:
+        agent_id: ID of the agent
+        task_id: ID of the task to update
+        task_updates: Dictionary containing fields to update
+
+    Returns:
+        AgentAutonomous: The updated task
+
+    Raises:
+        IntentKitAPIError: If agent is not found or task is not found
+    """
+    agent = await Agent.get(agent_id)
+    if not agent:
+        raise IntentKitAPIError(
+            400, "AgentNotFound", f"Agent with ID {agent_id} does not exist."
+        )
+
+    # Get current autonomous tasks
+    current_tasks: List[AgentAutonomous] = agent.autonomous or []
+
+    # Find and update the task
+    task_found = False
+    updated_tasks: List[AgentAutonomous] = []
+    updated_task = None
+
+    for task_data in current_tasks:
+        if task_data.id == task_id:
+            task_found = True
+            # Create a dictionary with current task data
+            task_dict = task_data.model_dump()
+            # Update with provided fields
+            task_dict.update(task_updates)
+            # Create new AgentAutonomous instance
+            updated_task = AgentAutonomous.model_validate(task_dict)
+            updated_tasks.append(updated_task)
+        else:
+            updated_tasks.append(task_data)
+
+    if not task_found:
+        raise IntentKitAPIError(
+            404, "TaskNotFound", f"Autonomous task with ID {task_id} not found."
+        )
+
+    # Convert all AgentAutonomous objects to dictionaries for JSON serialization
+    serializable_tasks = [task_item.model_dump() for task_item in updated_tasks]
+
+    # Update the agent in the database
+    async with get_session() as session:
+        update_stmt = (
+            update(AgentTable)
+            .where(AgentTable.id == agent_id)
+            .values(autonomous=serializable_tasks)
+        )
+        await session.execute(update_stmt)
+        await session.commit()
+
+    logger.info(f"Updated autonomous task {task_id} for agent {agent_id}")
+    return updated_task

intentkit/core/engine.py

@@ -221,6 +221,45 @@ async def create_agent(
             ):
                 entrypoint_prompt = agent.telegram_entrypoint_prompt
                 logger.debug("telegram entrypoint prompt added")
+            elif entrypoint == AuthorType.TRIGGER.value:
+                task_id = (
+                    config["configurable"]
+                    .get("chat_id", "")
+                    .removeprefix("autonomous-")
+                )
+                # Find the autonomous task by task_id
+                autonomous_task = None
+                if agent.autonomous:
+                    for task in agent.autonomous:
+                        if task.id == task_id:
+                            autonomous_task = task
+                            break
+
+                if autonomous_task:
+                    # Build detailed task info - always include task_id
+                    if autonomous_task.name:
+                        task_info = f"You are running an autonomous task '{autonomous_task.name}' (ID: {task_id})"
+                    else:
+                        task_info = (
+                            f"You are running an autonomous task (ID: {task_id})"
+                        )
+
+                    # Add description if available
+                    if autonomous_task.description:
+                        task_info += f": {autonomous_task.description}"
+
+                    # Add cycle info
+                    if autonomous_task.minutes:
+                        task_info += f". This task runs every {autonomous_task.minutes} minute(s)"
+                    elif autonomous_task.cron:
+                        task_info += (
+                            f". This task runs on schedule: {autonomous_task.cron}"
+                        )
+
+                    entrypoint_prompt = f"{task_info}. "
+                else:
+                    # Fallback if task not found
+                    entrypoint_prompt = f"You are running an autonomous task. The task id is {task_id}. "
             if entrypoint_prompt:
                 entrypoint_prompt = await explain_prompt(entrypoint_prompt)
                 final_system_prompt = f"{final_system_prompt}## Entrypoint rules\n\n{entrypoint_prompt}\n\n"
@@ -1012,15 +1051,3 @@ async def thread_stats(agent_id: str, chat_id: str) -> list[BaseMessage]:
         return snap.values["messages"]
     else:
         return []
-
-
-async def is_payment_required(input: ChatMessageCreate, agent: Agent) -> bool:
-    if not config.payment_enabled:
-        return False
-    payment_settings = await AppSetting.payment()
-    if payment_settings.agent_whitelist_enabled:
-        if agent.id not in payment_settings.agent_whitelist:
-            return False
-    if input.user_id and agent.owner:
-        return True
-    return False

intentkit/core/skill.py

@@ -1,8 +1,20 @@
-from typing import Any, Dict, Optional
+from typing import Any, Dict, List, Optional
 
 from intentkit.abstracts.skill import SkillStoreABC
 from intentkit.config.config import config
-from intentkit.models.agent import Agent
+from intentkit.core.agent import (
+    add_autonomous_task as _add_autonomous_task,
+)
+from intentkit.core.agent import (
+    delete_autonomous_task as _delete_autonomous_task,
+)
+from intentkit.core.agent import (
+    list_autonomous_tasks as _list_autonomous_tasks,
+)
+from intentkit.core.agent import (
+    update_autonomous_task as _update_autonomous_task,
+)
+from intentkit.models.agent import Agent, AgentAutonomous
 from intentkit.models.agent_data import AgentData, AgentQuota
 from intentkit.models.skill import (
     AgentSkillData,
@@ -131,5 +143,58 @@ class SkillStore(SkillStoreABC):
         )
         await skill_data.save()
 
+    @staticmethod
+    async def list_autonomous_tasks(agent_id: str) -> List[AgentAutonomous]:
+        """List all autonomous tasks for an agent.
+
+        Args:
+            agent_id: ID of the agent
+
+        Returns:
+            List[AgentAutonomous]: List of autonomous task configurations
+        """
+        return await _list_autonomous_tasks(agent_id)
+
+    @staticmethod
+    async def add_autonomous_task(
+        agent_id: str, task: AgentAutonomous
+    ) -> AgentAutonomous:
+        """Add a new autonomous task to an agent.
+
+        Args:
+            agent_id: ID of the agent
+            task: Autonomous task configuration
+
+        Returns:
+            AgentAutonomous: The created task
+        """
+        return await _add_autonomous_task(agent_id, task)
+
+    @staticmethod
+    async def delete_autonomous_task(agent_id: str, task_id: str) -> None:
+        """Delete an autonomous task from an agent.
+
+        Args:
+            agent_id: ID of the agent
+            task_id: ID of the task to delete
+        """
+        await _delete_autonomous_task(agent_id, task_id)
+
+    @staticmethod
+    async def update_autonomous_task(
+        agent_id: str, task_id: str, task_updates: dict
+    ) -> AgentAutonomous:
+        """Update an autonomous task for an agent.
+
+        Args:
+            agent_id: ID of the agent
+            task_id: ID of the task to update
+            task_updates: Dictionary containing fields to update
+
+        Returns:
+            AgentAutonomous: The updated task
+        """
+        return await _update_autonomous_task(agent_id, task_id, task_updates)
+
 
 skill_store = SkillStore()

intentkit/models/agent.py

@@ -1487,6 +1487,12 @@ class AgentResponse(BaseModel):
     cdp_wallet_address: Annotated[
         Optional[str], PydanticField(description="CDP wallet address for the agent")
     ]
+    evm_wallet_address: Annotated[
+        Optional[str], PydanticField(description="EVM wallet address for the agent")
+    ]
+    solana_wallet_address: Annotated[
+        Optional[str], PydanticField(description="Solana wallet address for the agent")
+    ]
     has_twitter_linked: Annotated[
         bool,
         PydanticField(description="Whether the agent has linked their Twitter account"),
@@ -1602,6 +1608,8 @@ class AgentResponse(BaseModel):
 
         # Process CDP wallet address
         cdp_wallet_address = agent_data.evm_wallet_address if agent_data else None
+        evm_wallet_address = agent_data.evm_wallet_address if agent_data else None
+        solana_wallet_address = agent_data.solana_wallet_address if agent_data else None
 
         # Process Twitter linked status
         has_twitter_linked = False
@@ -1647,6 +1655,8 @@ class AgentResponse(BaseModel):
         data.update(
             {
                 "cdp_wallet_address": cdp_wallet_address,
+                "evm_wallet_address": evm_wallet_address,
+                "solana_wallet_address": solana_wallet_address,
                 "has_twitter_linked": has_twitter_linked,
                 "linked_twitter_username": linked_twitter_username,
                 "linked_twitter_name": linked_twitter_name,

intentkit/models/agent_data.py

@@ -814,3 +814,33 @@ class AgentQuota(BaseModel):
                 # Update this instance
                 await db.refresh(quota_record)
                 self.model_validate(quota_record)
+
+    @staticmethod
+    async def reset_daily_quotas():
+        """Reset daily quotas for all agents at UTC 00:00.
+        Resets message_count_daily and twitter_count_daily to 0.
+        """
+        from sqlalchemy import update
+
+        async with get_session() as session:
+            stmt = update(AgentQuotaTable).values(
+                message_count_daily=0,
+                twitter_count_daily=0,
+                free_income_daily=0,
+            )
+            await session.execute(stmt)
+            await session.commit()
+
+    @staticmethod
+    async def reset_monthly_quotas():
+        """Reset monthly quotas for all agents at the start of each month.
+        Resets message_count_monthly and autonomous_count_monthly to 0.
+        """
+        from sqlalchemy import update
+
+        async with get_session() as session:
+            stmt = update(AgentQuotaTable).values(
+                message_count_monthly=0, autonomous_count_monthly=0
+            )
+            await session.execute(stmt)
+            await session.commit()

intentkit/models/app_setting.py

@@ -46,6 +46,8 @@ class PaymentSettings(BaseModel):
                 "credit_per_usdc": 1000,
                 "fee_platform_percentage": 100,
                 "fee_dev_percentage": 20,
+                "free_quota": 480,
+                "refill_amount": 20,
                 "agent_whitelist_enabled": False,
                 "agent_whitelist": [],
             }
@@ -68,6 +70,22 @@ class PaymentSettings(BaseModel):
             default=Decimal("20"), description="Developer fee percentage", ge=0, le=100
         ),
     ]
+    free_quota: Annotated[
+        Decimal,
+        Field(
+            default=Decimal("480"),
+            description="Daily free credit quota for new users",
+            ge=0,
+        ),
+    ]
+    refill_amount: Annotated[
+        Decimal,
+        Field(
+            default=Decimal("20"),
+            description="Hourly refill amount for free credits",
+            ge=0,
+        ),
+    ]
     agent_whitelist_enabled: Annotated[
         bool,
         Field(default=False, description="Whether agent whitelist is enabled"),
@@ -77,7 +95,13 @@ class PaymentSettings(BaseModel):
         Field(default_factory=list, description="List of whitelisted agent IDs"),
     ]
 
-    @field_validator("credit_per_usdc", "fee_platform_percentage", "fee_dev_percentage")
+    @field_validator(
+        "credit_per_usdc",
+        "fee_platform_percentage",
+        "fee_dev_percentage",
+        "free_quota",
+        "refill_amount",
+    )
     @classmethod
     def round_decimal(cls, v: Any) -> Decimal:
         """Round decimal values to 4 decimal places."""

intentkit/models/credit.py

@@ -6,6 +6,7 @@ from typing import Annotated, Any, Dict, List, Optional, Tuple
 
 from epyxid import XID
 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 pydantic import BaseModel, ConfigDict, Field, field_validator
@@ -437,8 +438,8 @@ class CreditAccount(BaseModel):
         session: AsyncSession,
         owner_type: OwnerType,
         owner_id: str,
-        free_quota: Decimal = Decimal("480.0"),
-        refill_amount: Decimal = Decimal("20.0"),
+        free_quota: Optional[Decimal] = None,
+        refill_amount: Optional[Decimal] = None,
     ) -> "CreditAccount":
         """Get an existing credit account or create a new one if it doesn't exist.
 
@@ -448,15 +449,24 @@ class CreditAccount(BaseModel):
             session: Async session to use for database queries
             owner_type: Type of the owner
             owner_id: ID of the owner
-            free_quota: Daily quota for a new account if created
+            free_quota: Daily quota for a new account if created (if None, reads from payment settings)
+            refill_amount: Hourly refill amount (if None, reads from payment settings)
 
         Returns:
             CreditAccount: The existing or newly created credit account
         """
+        # Get payment settings if values not provided
+        if free_quota is None or refill_amount is None:
+            payment_settings = await AppSetting.payment()
+            if free_quota is None:
+                free_quota = payment_settings.free_quota
+            if refill_amount is None:
+                refill_amount = payment_settings.refill_amount
+
         if owner_type != OwnerType.USER:
             # only users have daily quota
-            free_quota = 0.0
-            refill_amount = 0.0
+            free_quota = Decimal("0.0")
+            refill_amount = Decimal("0.0")
         # Create event_id at the beginning for consistency
         event_id = str(XID())
 

intentkit/skills/system/__init__.py

@@ -5,7 +5,11 @@ from typing import TypedDict
 
 from intentkit.abstracts.skill import SkillStoreABC
 from intentkit.skills.base import SkillConfig, SkillOwnerState
+from intentkit.skills.system.add_autonomous_task import AddAutonomousTask
 from intentkit.skills.system.base import SystemBaseTool
+from intentkit.skills.system.delete_autonomous_task import DeleteAutonomousTask
+from intentkit.skills.system.edit_autonomous_task import EditAutonomousTask
+from intentkit.skills.system.list_autonomous_tasks import ListAutonomousTasks
 from intentkit.skills.system.read_agent_api_key import ReadAgentApiKey
 from intentkit.skills.system.regenerate_agent_api_key import RegenerateAgentApiKey
 
@@ -18,6 +22,10 @@ logger = logging.getLogger(__name__)
 class SkillStates(TypedDict):
     read_agent_api_key: SkillOwnerState
     regenerate_agent_api_key: SkillOwnerState
+    list_autonomous_tasks: SkillOwnerState
+    add_autonomous_task: SkillOwnerState
+    delete_autonomous_task: SkillOwnerState
+    edit_autonomous_task: SkillOwnerState
 
 
 class Config(SkillConfig):
@@ -85,6 +93,30 @@ def get_system_skill(
                 skill_store=store,
             )
         return _cache[name]
+    elif name == "list_autonomous_tasks":
+        if name not in _cache:
+            _cache[name] = ListAutonomousTasks(
+                skill_store=store,
+            )
+        return _cache[name]
+    elif name == "add_autonomous_task":
+        if name not in _cache:
+            _cache[name] = AddAutonomousTask(
+                skill_store=store,
+            )
+        return _cache[name]
+    elif name == "delete_autonomous_task":
+        if name not in _cache:
+            _cache[name] = DeleteAutonomousTask(
+                skill_store=store,
+            )
+        return _cache[name]
+    elif name == "edit_autonomous_task":
+        if name not in _cache:
+            _cache[name] = EditAutonomousTask(
+                skill_store=store,
+            )
+        return _cache[name]
     else:
         logger.warning(f"Unknown system skill: {name}")
         return None

intentkit/skills/system/add_autonomous_task.py

@@ -0,0 +1,93 @@
+from typing import Optional
+
+from langchain_core.runnables import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.models.agent import AgentAutonomous
+from intentkit.skills.system.base import SystemBaseTool
+
+
+class AddAutonomousTaskInput(BaseModel):
+    """Input model for add_autonomous_task skill."""
+
+    name: Optional[str] = Field(
+        default=None,
+        description="Display name of the autonomous task configuration",
+        max_length=50,
+    )
+    description: Optional[str] = Field(
+        default=None,
+        description="Description of the autonomous task configuration",
+        max_length=200,
+    )
+    minutes: Optional[int] = Field(
+        default=None,
+        description="Interval in minutes between operations, mutually exclusive with cron",
+    )
+    cron: Optional[str] = Field(
+        default=None,
+        description="Cron expression for scheduling operations, mutually exclusive with minutes",
+    )
+    prompt: str = Field(description="Special prompt used during autonomous operation")
+
+
+class AddAutonomousTaskOutput(BaseModel):
+    """Output model for add_autonomous_task skill."""
+
+    task: AgentAutonomous = Field(
+        description="The created autonomous task configuration"
+    )
+
+
+class AddAutonomousTask(SystemBaseTool):
+    """Skill to add a new autonomous task to an agent."""
+
+    name: str = "system_add_autonomous_task"
+    description: str = (
+        "Add a new autonomous task configuration to the agent. "
+        "Allows setting up scheduled operations with custom prompts and intervals. "
+        "The minutes and cron fields are mutually exclusive. But you must provide one of them. "
+        "If user want to add a condition task, you can add a 5 minutes task to check the condition. "
+        "If the user does not explicitly state that the condition task should be executed continuously, "
+        "then add in the task prompt that it will delete itself after successful execution. "
+    )
+    args_schema = AddAutonomousTaskInput
+
+    async def _arun(
+        self,
+        name: Optional[str] = None,
+        description: Optional[str] = None,
+        minutes: Optional[int] = None,
+        cron: Optional[str] = None,
+        prompt: str = "",
+        config: RunnableConfig = None,
+        **kwargs,
+    ) -> AddAutonomousTaskOutput:
+        """Add an autonomous task to the agent.
+
+        Args:
+            name: Display name of the task
+            description: Description of the task
+            minutes: Interval in minutes (mutually exclusive with cron)
+            cron: Cron expression (mutually exclusive with minutes)
+            prompt: Special prompt for autonomous operation
+            config: Runtime configuration containing agent context
+
+        Returns:
+            AddAutonomousTaskOutput: The created task
+        """
+        context = self.context_from_config(config)
+        agent_id = context.agent_id
+
+        task = AgentAutonomous(
+            name=name,
+            description=description,
+            minutes=minutes,
+            cron=cron,
+            prompt=prompt,
+            enabled=True,
+        )
+
+        created_task = await self.skill_store.add_autonomous_task(agent_id, task)
+
+        return AddAutonomousTaskOutput(task=created_task)

intentkit/skills/system/delete_autonomous_task.py

@@ -0,0 +1,56 @@
+from langchain_core.runnables import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.skills.system.base import SystemBaseTool
+
+
+class DeleteAutonomousTaskInput(BaseModel):
+    """Input model for delete_autonomous_task skill."""
+
+    task_id: str = Field(
+        description="The unique identifier of the autonomous task to delete"
+    )
+
+
+class DeleteAutonomousTaskOutput(BaseModel):
+    """Output model for delete_autonomous_task skill."""
+
+    success: bool = Field(
+        description="Whether the task was successfully deleted", default=True
+    )
+    message: str = Field(description="Confirmation message about the deletion")
+
+
+class DeleteAutonomousTask(SystemBaseTool):
+    """Skill to delete an autonomous task from an agent."""
+
+    name: str = "system_delete_autonomous_task"
+    description: str = (
+        "Delete an autonomous task configuration from the agent. "
+        "Requires the task ID to identify which task to remove."
+    )
+    args_schema = DeleteAutonomousTaskInput
+
+    async def _arun(
+        self,
+        task_id: str,
+        config: RunnableConfig,
+        **kwargs,
+    ) -> DeleteAutonomousTaskOutput:
+        """Delete an autonomous task from the agent.
+
+        Args:
+            task_id: The ID of the task to delete
+            config: Runtime configuration containing agent context
+
+        Returns:
+            DeleteAutonomousTaskOutput: Confirmation of deletion
+        """
+        context = self.context_from_config(config)
+        agent_id = context.agent_id
+
+        await self.skill_store.delete_autonomous_task(agent_id, task_id)
+
+        return DeleteAutonomousTaskOutput(
+            success=True, message=f"Successfully deleted autonomous task {task_id}"
+        )

intentkit/skills/system/edit_autonomous_task.py

@@ -0,0 +1,116 @@
+from typing import Optional
+
+from langchain_core.runnables import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.models.agent import AgentAutonomous
+from intentkit.skills.system.base import SystemBaseTool
+
+
+class EditAutonomousTaskInput(BaseModel):
+    """Input model for edit_autonomous_task skill."""
+
+    task_id: str = Field(
+        description="The unique identifier of the autonomous task to edit"
+    )
+    name: Optional[str] = Field(
+        default=None,
+        description="Display name of the autonomous task configuration",
+        max_length=50,
+    )
+    description: Optional[str] = Field(
+        default=None,
+        description="Description of the autonomous task configuration",
+        max_length=200,
+    )
+    minutes: Optional[int] = Field(
+        default=None,
+        description="Interval in minutes between operations, mutually exclusive with cron",
+    )
+    cron: Optional[str] = Field(
+        default=None,
+        description="Cron expression for scheduling operations, mutually exclusive with minutes",
+    )
+    prompt: Optional[str] = Field(
+        default=None, description="Special prompt used during autonomous operation"
+    )
+    enabled: Optional[bool] = Field(
+        default=None, description="Whether the autonomous task is enabled"
+    )
+
+
+class EditAutonomousTaskOutput(BaseModel):
+    """Output model for edit_autonomous_task skill."""
+
+    task: AgentAutonomous = Field(
+        description="The updated autonomous task configuration"
+    )
+
+
+class EditAutonomousTask(SystemBaseTool):
+    """Skill to edit an existing autonomous task for an agent."""
+
+    name: str = "system_edit_autonomous_task"
+    description: str = (
+        "Edit an existing autonomous task configuration for the agent. "
+        "Allows updating the name, description, schedule (minutes or cron), prompt, and enabled status. "
+        "Only provided fields will be updated; omitted fields will keep their current values. "
+        "The minutes and cron fields are mutually exclusive. Do not provide both of them. "
+    )
+    args_schema = EditAutonomousTaskInput
+
+    async def _arun(
+        self,
+        task_id: str,
+        name: Optional[str] = None,
+        description: Optional[str] = None,
+        minutes: Optional[int] = None,
+        cron: Optional[str] = None,
+        prompt: Optional[str] = None,
+        enabled: Optional[bool] = None,
+        config: RunnableConfig = None,
+        **kwargs,
+    ) -> EditAutonomousTaskOutput:
+        """Edit an autonomous task for the agent.
+
+        Args:
+            task_id: ID of the task to edit
+            name: Display name of the task
+            description: Description of the task
+            minutes: Interval in minutes (mutually exclusive with cron)
+            cron: Cron expression (mutually exclusive with minutes)
+            prompt: Special prompt for autonomous operation
+            enabled: Whether the task is enabled
+            config: Runtime configuration containing agent context
+
+        Returns:
+            EditAutonomousTaskOutput: The updated task
+        """
+        context = self.context_from_config(config)
+        agent_id = context.agent_id
+
+        if minutes is not None and cron is not None:
+            raise ValueError("minutes and cron are mutually exclusive")
+
+        # Build the updates dictionary with only provided fields
+        task_updates = {}
+        if name is not None:
+            task_updates["name"] = name
+        if description is not None:
+            task_updates["description"] = description
+        if minutes is not None:
+            task_updates["minutes"] = minutes
+            task_updates["cron"] = None
+        if cron is not None:
+            task_updates["cron"] = cron
+            task_updates["minutes"] = None
+        if prompt is not None:
+            task_updates["prompt"] = prompt
+        if enabled is not None:
+            task_updates["enabled"] = enabled
+
+        updated_task = await self.skill_store.update_autonomous_task(
+            agent_id, task_id, task_updates
+        )
+
+        return EditAutonomousTaskOutput(task=updated_task)

intentkit/skills/system/list_autonomous_tasks.py

@@ -0,0 +1,52 @@
+from typing import List
+
+from langchain_core.runnables import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.models.agent import AgentAutonomous
+from intentkit.skills.system.base import SystemBaseTool
+
+
+class ListAutonomousTasksInput(BaseModel):
+    """Input model for list_autonomous_tasks skill."""
+
+    pass
+
+
+class ListAutonomousTasksOutput(BaseModel):
+    """Output model for list_autonomous_tasks skill."""
+
+    tasks: List[AgentAutonomous] = Field(
+        description="List of autonomous task configurations for the agent"
+    )
+
+
+class ListAutonomousTasks(SystemBaseTool):
+    """Skill to list all autonomous tasks for an agent."""
+
+    name: str = "system_list_autonomous_tasks"
+    description: str = (
+        "List all autonomous task configurations for the agent. "
+        "Returns details about each task including scheduling, prompts, and status."
+    )
+    args_schema = ListAutonomousTasksInput
+
+    async def _arun(
+        self,
+        config: RunnableConfig,
+        **kwargs,
+    ) -> ListAutonomousTasksOutput:
+        """List autonomous tasks for the agent.
+
+        Args:
+            config: Runtime configuration containing agent context
+
+        Returns:
+            ListAutonomousTasksOutput: List of autonomous tasks
+        """
+        context = self.context_from_config(config)
+        agent_id = context.agent_id
+
+        tasks = await self.skill_store.list_autonomous_tasks(agent_id)
+
+        return ListAutonomousTasksOutput(tasks=tasks)

intentkit/skills/system/schema.json

@@ -31,7 +31,7 @@
             "Agent Owner Only"
           ],
           "description": "Retrieve the API key for the agent. If no API key exists, generates and sets a new one.",
-          "default": "private"
+          "default": "disabled"
         },
         "regenerate_agent_api_key": {
           "type": "string",
@@ -45,7 +45,63 @@
             "Agent Owner Only"
           ],
           "description": "Generate a new API key for the agent, replacing any existing key.",
-          "default": "private"
+          "default": "disabled"
+        },
+        "list_autonomous_tasks": {
+          "type": "string",
+          "title": "List Autonomous Tasks",
+          "enum": [
+            "disabled",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner Only"
+          ],
+          "description": "List all autonomous task configurations for the agent.",
+          "default": "disabled"
+        },
+        "add_autonomous_task": {
+          "type": "string",
+          "title": "Add Autonomous Task",
+          "enum": [
+            "disabled",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner Only"
+          ],
+          "description": "Add a new autonomous task configuration to the agent.",
+          "default": "disabled"
+        },
+        "delete_autonomous_task": {
+          "type": "string",
+          "title": "Delete Autonomous Task",
+          "enum": [
+            "disabled",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner Only"
+          ],
+          "description": "Delete an autonomous task configuration from the agent.",
+          "default": "disabled"
+        },
+        "edit_autonomous_task": {
+          "type": "string",
+          "title": "Edit Autonomous Task",
+          "enum": [
+            "disabled",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner Only"
+          ],
+          "description": "Edit an existing autonomous task configuration for the agent.",
+          "default": "disabled"
         }
       }
     }

{intentkit-0.6.6.dist-info → intentkit-0.6.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 0.6.6
+Version: 0.6.7
 Summary: Intent-based AI Agent Platform - Core Package
 Project-URL: Homepage, https://github.com/crestal-network/intentkit
 Project-URL: Repository, https://github.com/crestal-network/intentkit

{intentkit-0.6.6.dist-info → intentkit-0.6.7.dist-info}/RECORD

@@ -1,11 +1,11 @@
-intentkit/__init__.py,sha256=3EyIFxq2kfV4QJlkFaFrmpKEeIGmFmaP6OsMpoieNFc,378
+intentkit/__init__.py,sha256=fIrJ9bOWDF1C4eSgiZndEAAzdSloSyRr31q5aGL2ex4,378
 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
 intentkit/abstracts/engine.py,sha256=C5C9d8vVMePhkKWURKIAbZSDZnmjxj5epL_04E6RpxQ,1449
 intentkit/abstracts/exception.py,sha256=NX7u_eFP0Cowu6fK4QW8LmDqd_Vybm3_6W5UiO6nMYA,239
 intentkit/abstracts/graph.py,sha256=QhaVLtKyo9iTotIWhjgUi7BbmRCcb8yrHCTSq4Hsvnw,735
-intentkit/abstracts/skill.py,sha256=WS8G_XP0Ukw1eUB-dhbx6FrJUbvV4tqzRnkWa2dt9ck,3573
+intentkit/abstracts/skill.py,sha256=cIJ6BkASD31U1IEkE8rdAawq99w_xsg0lt3oalqa1ZA,5071
 intentkit/abstracts/twitter.py,sha256=cEtP7ygR_b-pHdc9i8kBuyooz1cPoGUGwsBHDpowJyY,1262
 intentkit/clients/__init__.py,sha256=sQ_6_bRC2MPWLPH-skQ3qsEe8ce-dUGL7i8VJOautHg,298
 intentkit/clients/cdp.py,sha256=_CkvnBkzdq7-sFMGct4lz85FpaOoHxOGstWubhClzrA,5921
@@ -13,22 +13,22 @@ intentkit/clients/twitter.py,sha256=Lfa7srHOFnY96SXcElW0jfg7XKS_WliWnXjPZEe6SQc,
 intentkit/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 intentkit/config/config.py,sha256=Gn3KXgFyh4u0zmb-Awpu4AxvDFaGDa_5GrFrKBbOAXk,7509
 intentkit/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-intentkit/core/agent.py,sha256=PTHsFV_EbsfPUcTI0ErkebWurjxVykP9ISbNUsqV44Q,7764
+intentkit/core/agent.py,sha256=GIKDn1dTenIHWMRxe-ud7hd1cQaHzbTDdypy5IAgPfU,16658
 intentkit/core/api.py,sha256=3GIMJpwduLUSbVPNW6mQVxZncYHH3OlLwdiqFtYtEAE,1208
 intentkit/core/client.py,sha256=rIwtJVVm-7piXtFNDbeykt9vWdNTecgjW0aA3N-lHnM,1495
 intentkit/core/credit.py,sha256=vLT47NlLrGyvSU1OP8dkVXV5_VHqRNSeAK5t1FqSSYs,61742
-intentkit/core/engine.py,sha256=7RpT8KTRuBqQEJNpzrFWyOM6Qc0OUCBR-T1PN76BFGA,41171
+intentkit/core/engine.py,sha256=1JJuTSVs3k57M0aKD87Yx4T86Mc2DeefhLDXcHV13fY,42554
 intentkit/core/node.py,sha256=RqAdcR1Fcpgw4k7q9l1Sry8LgcuZWdNxSjOHDcoavCI,9108
 intentkit/core/prompt.py,sha256=RfLhlUktkB2kCr3wfldqq6ZP2l8heZIMc8jVp31KIyQ,3631
-intentkit/core/skill.py,sha256=d6VNArNseavb_OaSvmGRMFivYOjX7T6AyKpz9tjhVPI,3815
-intentkit/models/agent.py,sha256=hkcQIpIk84hObCJWDbtxyEDdCZrJ-KSIP2n5lFv0aFo,56664
-intentkit/models/agent_data.py,sha256=4fhhtTh9bl1hzHiaVYHy1RyaFjIqrDxEcRgnbrkKOKM,27225
+intentkit/core/skill.py,sha256=vPK37sDRT9kzkMBymPwqZ5uEdxTTRtb_DfREIeyz-Xw,5788
+intentkit/models/agent.py,sha256=L1nB-9RMvmZ38LRjtHeIdGbmdGeS8Ji1j_s0NJsFtSQ,57216
+intentkit/models/agent_data.py,sha256=mVsiK8TziYa1W1ujU1KwI9osIVIeSM7XJEogGRL1WVU,28263
 intentkit/models/agent_schema.json,sha256=5RMn474uWeN8Mo7RwPQuvPa5twXcenNbUjXCWjzywrI,21659
-intentkit/models/app_setting.py,sha256=WgW-9t0EbiVemRLrVaC6evdfRU5QFSDK0elsnUU5nIo,5008
+intentkit/models/app_setting.py,sha256=4fuW4J6NV826e53OAsW1bnn3Pgw8iUVKH9-AUMTSYQc,5550
 intentkit/models/base.py,sha256=o-zRjVrak-f5Jokdvj8BjLm8gcC3yYiYMCTLegwT2lA,185
 intentkit/models/chat.py,sha256=O-7qmFh9Qag-gY2xXR6tpLJ1i-D0wQzzZ1hXnrt0BA0,19052
 intentkit/models/conversation.py,sha256=nrbDIw-3GK5BYi_xkI15FLdx4a6SNrFK8wfAGLCsrqk,9032
-intentkit/models/credit.py,sha256=95buGlZwIuoSPasZcqYEKvdrnUiUe2RzJCR3a2rvQvU,42397
+intentkit/models/credit.py,sha256=bcasHyrCwforLGrH8ZWEvN6y6ml7NeAFrGl8cfqvqbI,42956
 intentkit/models/db.py,sha256=Ked8-PsvKvqxgvytGpWlDxZNgEuyac-uGM0xWWshKmY,4210
 intentkit/models/db_mig.py,sha256=vT6Tanm-BHC2T7dTztuB1UG494EFBAlHADKsNzR6xaQ,3577
 intentkit/models/generator.py,sha256=lyZu9U9rZUGkqd_QT5SAhay9DY358JJY8EhDSpN8I1M,10298
@@ -291,11 +291,15 @@ intentkit/skills/supabase/schema.json,sha256=cqjo20flg6Xlv6b-2nrsJAbdCMBCJfmlfz8
 intentkit/skills/supabase/supabase.svg,sha256=65_80QCtJiKKV4EAuny_xbOD5JlTONEiq9xqO00hDtM,1107
 intentkit/skills/supabase/update_data.py,sha256=Hbwsoa52GZNTPIhWdR9vj9VlcPRUn_vCMOYDzmMoPsI,4023
 intentkit/skills/supabase/upsert_data.py,sha256=JgKLFPcQkUwnQhqTZojT4Ae53hYULeGEkQ1gxZJEe-c,2538
-intentkit/skills/system/__init__.py,sha256=y5sBakdOL1vtXV8DNn-g_MN11CrJ8QrOceoJjD5MzXs,2402
+intentkit/skills/system/__init__.py,sha256=bqNYJCjLx9p23E21ELLP-T0B_NP0ltzT0TMqsBI-9Bg,3668
+intentkit/skills/system/add_autonomous_task.py,sha256=dUNppykHlCNtlxWfK2DzwT1FyaH2VNp0UU9V2Ecq07o,3269
 intentkit/skills/system/base.py,sha256=Sm4lSNgbxwGK5YimnBfwi3Hc8E1EwSMZIXsCJbIPiLM,700
+intentkit/skills/system/delete_autonomous_task.py,sha256=1zChfY3SkWr1V2QFotyitkVLaBsYBtk68qkhyA_qh-A,1741
+intentkit/skills/system/edit_autonomous_task.py,sha256=MahT7gDPH5ZpjAqEKfJ-xQx6KpmgG3RrkikJ9KAf-CI,4131
+intentkit/skills/system/list_autonomous_tasks.py,sha256=QTPL4He3OuNfil_xLwMwL1uoe1lbww-XZxD1837usuo,1496
 intentkit/skills/system/read_agent_api_key.py,sha256=x8DIQwDxZ1MONz4tyN3o6QUf2-2aEjZd4yVOY28-IaU,3410
 intentkit/skills/system/regenerate_agent_api_key.py,sha256=AiFXOEIRxXJRWiDufKCi3_ViyAyK19P1XZOleM1eQUc,3070
-intentkit/skills/system/schema.json,sha256=4lv144DEDz9m1NYQdTgke3nDyCrVsGm82QiIoLbIRww,1462
+intentkit/skills/system/schema.json,sha256=Yfd_pnSrJUQc__dwAoN9jl4WyzCKuauFjTV60U4MFaI,3099
 intentkit/skills/system/system.svg,sha256=PVbC6r6rOhvht0lB1fcxDNTcbMUa7haHAkJ8rxp7gm0,3740
 intentkit/skills/tavily/README.md,sha256=VagMkuHrS_ge2Sir9M9CoeqmWc_rysKhTO9-LGICQsA,2840
 intentkit/skills/tavily/__init__.py,sha256=PDtH-O3fdAPCc3lGMbgcXKK1fDdkTO1CW-40825FtGU,2386
@@ -390,7 +394,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.6.6.dist-info/METADATA,sha256=IPNIc3RN1f6eeIgxN_Os5wtVCqPGhyJCL-l6fzI-Sww,6316
-intentkit-0.6.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-intentkit-0.6.6.dist-info/licenses/LICENSE,sha256=Bln6DhK-LtcO4aXy-PBcdZv2f24MlJFm_qn222biJtE,1071
-intentkit-0.6.6.dist-info/RECORD,,
+intentkit-0.6.7.dist-info/METADATA,sha256=0c6E761qVmheLN9l7_CSmYBxELBCGVCO9Xw9JbJmDoI,6316
+intentkit-0.6.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+intentkit-0.6.7.dist-info/licenses/LICENSE,sha256=Bln6DhK-LtcO4aXy-PBcdZv2f24MlJFm_qn222biJtE,1071
+intentkit-0.6.7.dist-info/RECORD,,