intentkit 0.6.12__py3-none-any.whl → 0.6.13.dev1__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.12"
+__version__ = "0.6.13-dev1"
 __author__ = "hyacinthus"
 __email__ = "hyacinthus@gmail.com"
 

intentkit/config/config.py

@@ -96,9 +96,16 @@ class Config:
         self.eternal_api_key = self.load("ETERNAL_API_KEY")
         self.reigent_api_key = self.load("REIGENT_API_KEY")
         self.venice_api_key = self.load("VENICE_API_KEY")
+        # LLM Config
         self.system_prompt = self.load("SYSTEM_PROMPT")
         self.input_token_limit = self.load_int("INPUT_TOKEN_LIMIT", 60000)
+        # XMTP
+        self.xmtp_system_prompt = self.load(
+            "XMTP_SYSTEM_PROMPT",
+            "You are assisting a user who uses an XMTP client that only displays plain-text messages, so do not use Markdown formatting.",
+        )
         # Telegram server settings
+        self.tg_system_prompt = self.load("TG_SYSTEM_PROMPT")
         self.tg_base_url = self.load("TG_BASE_URL")
         self.tg_server_host = self.load("TG_SERVER_HOST", "127.0.0.1")
         self.tg_server_port = self.load("TG_SERVER_PORT", "8081")

intentkit/core/api.py

@@ -6,9 +6,10 @@ This module provides the core API endpoints for agent execution and management.
 from typing import Annotated
 
 from fastapi import APIRouter, Body
+from fastapi.responses import StreamingResponse
 from pydantic import AfterValidator
 
-from intentkit.core.engine import execute_agent
+from intentkit.core.engine import execute_agent, stream_agent
 from intentkit.models.chat import ChatMessage, ChatMessageCreate
 
 core_router = APIRouter(prefix="/core", tags=["Core"])
@@ -23,13 +24,22 @@ async def execute(
         description="The chat message containing agent_id, chat_id and message content",
     ),
 ) -> list[ChatMessage]:
-    """Execute an agent with the given input and return response lines.
+    """Execute an agent with the provided message and return all results.
+
+    This endpoint executes an agent with the provided message and returns all
+    generated messages as a complete list after execution finishes.
 
     **Request Body:**
     * `message` - The chat message containing agent_id, chat_id and message content
 
+    **Response:**
+    Returns a list of ChatMessage objects containing:
+    * Skill call results (including tool executions)
+    * Agent reasoning and responses
+    * System messages or error notifications
+
     **Returns:**
-    * `list[ChatMessage]` - Formatted response lines from agent execution
+    * `list[ChatMessage]` - Complete list of response messages
 
     **Raises:**
     * `HTTPException`:
@@ -38,3 +48,53 @@ async def execute(
         - 500: For other server-side errors
     """
     return await execute_agent(message)
+
+
+@core_router.post("/stream")
+async def stream(
+    message: Annotated[
+        ChatMessageCreate, AfterValidator(ChatMessageCreate.model_validate)
+    ] = Body(
+        ChatMessageCreate,
+        description="The chat message containing agent_id, chat_id and message content",
+    ),
+) -> StreamingResponse:
+    """Stream agent execution results in real-time using Server-Sent Events.
+
+    This endpoint executes an agent with the provided message and streams the results
+    in real-time using the SSE (Server-Sent Events) standard format.
+
+    **Request Body:**
+    * `message` - The chat message containing agent_id, chat_id and message content
+
+    **Stream Format:**
+    The response uses Server-Sent Events with the following format:
+    * Event type: `message`
+    * Data: ChatMessage object as JSON
+    * Format: `event: message\\ndata: {ChatMessage JSON}\\n\\n`
+
+    **Response Content:**
+    Each streamed message can be:
+    * Skill call results (including tool executions)
+    * Agent reasoning and responses
+    * System messages or error notifications
+
+    **Returns:**
+    * `StreamingResponse` - SSE stream with real-time ChatMessage objects
+
+    **Raises:**
+    * `HTTPException`:
+        - 400: If input parameters are invalid
+        - 404: If agent not found
+        - 500: For other server-side errors
+    """
+
+    async def generate():
+        async for chat_message in stream_agent(message):
+            yield f"event: message\ndata: {chat_message.model_dump_json()}\n\n"
+
+    return StreamingResponse(
+        generate(),
+        media_type="text/event-stream",
+        headers={"Cache-Control": "no-cache", "Connection": "keep-alive"},
+    )

intentkit/core/client.py

@@ -3,16 +3,17 @@
 This module provides client functions for core API endpoints with environment-aware routing.
 """
 
+from typing import AsyncIterator
+
 import httpx
 
 from intentkit.config.config import config
 from intentkit.core.engine import execute_agent as local_execute_agent
+from intentkit.core.engine import stream_agent as local_stream_agent
 from intentkit.models.chat import ChatMessage, ChatMessageCreate
 
 
-async def execute_agent(
-    message: ChatMessageCreate, debug: bool = False
-) -> list[ChatMessage]:
+async def execute_agent(message: ChatMessageCreate) -> list[ChatMessage]:
     """Execute an agent with environment-aware routing.
 
     In local environment, directly calls the local execute_agent function.
@@ -30,7 +31,7 @@ async def execute_agent(
         Exception: For other execution errors
     """
     if config.env == "local":
-        return await local_execute_agent(message, debug)
+        return await local_execute_agent(message)
 
     # Make HTTP request in non-local environment
     url = f"{config.internal_base_url}/core/execute"
@@ -38,8 +39,47 @@ async def execute_agent(
         response = await client.post(
             url,
             json=message.model_dump(mode="json"),
-            timeout=180,
+            timeout=300,
         )
     response.raise_for_status()
     json_data = response.json()
     return [ChatMessage.model_validate(msg) for msg in json_data]
+
+
+async def stream_agent(message: ChatMessageCreate) -> AsyncIterator[ChatMessage]:
+    """Stream agent execution with environment-aware routing using Server-Sent Events.
+
+    In local environment, directly calls the local stream_agent function.
+    In other environments, makes HTTP request to the core stream API endpoint and parses SSE format.
+
+    Args:
+        message (ChatMessageCreate): The chat message containing agent_id, chat_id and message content
+        debug (bool): Enable debug mode
+
+    Yields:
+        ChatMessage: Individual response messages from agent execution
+
+    Raises:
+        HTTPException: For API errors (in non-local environment)
+        Exception: For other execution errors
+    """
+    if config.env == "local":
+        async for chat_message in local_stream_agent(message):
+            yield chat_message
+        return
+
+    # Make HTTP request in non-local environment
+    url = f"{config.internal_base_url}/core/stream"
+    async with httpx.AsyncClient() as client:
+        async with client.stream(
+            "POST",
+            url,
+            json=message.model_dump(mode="json"),
+            timeout=300,
+        ) as response:
+            response.raise_for_status()
+            async for line in response.aiter_lines():
+                if line.startswith("data: "):
+                    json_str = line[6:]  # Remove "data: " prefix
+                    if json_str.strip():
+                        yield ChatMessage.model_validate_json(json_str)

intentkit/core/engine.py

@@ -758,7 +758,7 @@ async def stream_agent(message: ChatMessageCreate):
             author_type=AuthorType.SYSTEM,
             thread_type=input.author_type,
             reply_to=input.id,
-            message="IntentKit Internal Error",
+            message="Agent Internal Error",
             time_cost=time.perf_counter() - start,
         )
         error_message = await error_message_create.save()
@@ -800,7 +800,7 @@ async def stream_agent(message: ChatMessageCreate):
             author_type=AuthorType.SYSTEM,
             thread_type=input.author_type,
             reply_to=input.id,
-            message="Internal Agent Error",
+            message="Agent Internal Error",
             time_cost=time.perf_counter() - start,
         )
         error_message = await error_message_create.save()

intentkit/core/prompt.py

@@ -252,23 +252,6 @@ def escape_prompt(prompt: str) -> str:
 # ============================================================================
 
 
-def _build_social_entrypoint_prompt(agent: Agent, entrypoint: str) -> Optional[str]:
-    """Build prompt for social media entrypoints (Twitter, Telegram)."""
-    if (
-        agent.twitter_entrypoint_enabled
-        and agent.twitter_entrypoint_prompt
-        and entrypoint == AuthorType.TWITTER.value
-    ):
-        return agent.twitter_entrypoint_prompt
-    elif (
-        agent.telegram_entrypoint_enabled
-        and agent.telegram_entrypoint_prompt
-        and entrypoint == AuthorType.TELEGRAM.value
-    ):
-        return agent.telegram_entrypoint_prompt
-    return None
-
-
 def _build_autonomous_task_prompt(agent: Agent, context: AgentContext) -> str:
     """Build prompt for autonomous task entrypoint."""
     task_id = context.chat_id.removeprefix("autonomous-")
@@ -327,11 +310,18 @@ async def build_entrypoint_prompt(agent: Agent, context: AgentContext) -> Option
     entrypoint_prompt = None
 
     # Handle social media entrypoints
-    entrypoint_prompt = _build_social_entrypoint_prompt(agent, entrypoint)
-
-    # Handle autonomous task entrypoint
-    if not entrypoint_prompt and entrypoint == AuthorType.TRIGGER.value:
-        entrypoint_prompt = _build_autonomous_task_prompt(agent, context)
+    if entrypoint == AuthorType.TELEGRAM.value:
+        if config.tg_system_prompt:
+            entrypoint_prompt = "\n\n" + config.tg_system_prompt
+        if agent.telegram_entrypoint_prompt:
+            entrypoint_prompt = "\n\n" + agent.telegram_entrypoint_prompt
+    elif entrypoint == AuthorType.XMTP.value:
+        if config.xmtp_system_prompt:
+            entrypoint_prompt = "\n\n" + config.xmtp_system_prompt
+        if agent.xmtp_entrypoint_prompt:
+            entrypoint_prompt = "\n\n" + agent.xmtp_entrypoint_prompt
+    elif entrypoint == AuthorType.TRIGGER.value:
+        entrypoint_prompt = "\n\n" + _build_autonomous_task_prompt(agent, context)
 
     # Process with admin LLM skill control if enabled
     if entrypoint_prompt and config.admin_llm_skill_control:
@@ -406,7 +396,7 @@ def create_formatted_prompt_function(agent: Agent, agent_data: AgentData) -> Cal
         entrypoint_prompt = await build_entrypoint_prompt(agent, context)
         if entrypoint_prompt:
             final_system_prompt = (
-                f"{final_system_prompt}## Entrypoint rules\n\n{entrypoint_prompt}\n\n"
+                f"{final_system_prompt}## Entrypoint rules{entrypoint_prompt}\n\n"
             )
 
         # Add user info if user_id is a valid EVM wallet address

intentkit/models/agent.py

@@ -398,6 +398,11 @@ class AgentTable(Base):
         nullable=True,
         comment="Telegram integration configuration settings",
     )
+    xmtp_entrypoint_prompt = Column(
+        String,
+        nullable=True,
+        comment="Extra prompt for xmtp entrypoint",
+    )
     # auto timestamp
     created_at = Column(
         DateTime(timezone=True),
@@ -628,7 +633,7 @@ class AgentUpdate(BaseModel):
         str,
         PydanticField(
             default="gpt-5-mini",
-            description="AI model identifier to be used by this agent for processing requests. Available models: gpt-4o, gpt-4o-mini, deepseek-chat, deepseek-reasoner, grok-2, eternalai, reigent, venice-uncensored",
+            description="AI model identifier to be used by this agent for processing requests.",
             json_schema_extra={
                 "x-group": "ai",
             },
@@ -771,7 +776,7 @@ class AgentUpdate(BaseModel):
         ),
     ]
     wallet_provider: Annotated[
-        Optional[Literal["cdp"]],
+        Optional[Literal["cdp", "readonly"]],
         PydanticField(
             default="cdp",
             description="Provider of the agent's wallet",
@@ -780,6 +785,13 @@ class AgentUpdate(BaseModel):
             },
         ),
     ]
+    readonly_wallet_address: Annotated[
+        Optional[str],
+        PydanticField(
+            default=None,
+            description="Address of the agent's wallet, only used when wallet_provider is readonly. Agent will not be able to sign transactions.",
+        ),
+    ]
     network_id: Annotated[
         Optional[
             Literal[
@@ -827,70 +839,49 @@ class AgentUpdate(BaseModel):
             },
         ),
     ]
-    # if twitter_enabled, the twitter_entrypoint will be enabled, twitter_config will be checked
-    twitter_entrypoint_enabled: Annotated[
+    # if telegram_entrypoint_enabled, the telegram_entrypoint_enabled will be enabled, telegram_config will be checked
+    telegram_entrypoint_enabled: Annotated[
         Optional[bool],
         PydanticField(
             default=False,
-            description="Dangerous, reply all mentions from x.com",
+            description="Whether the agent can play telegram bot",
             json_schema_extra={
                 "x-group": "entrypoint",
             },
         ),
     ]
-    twitter_entrypoint_prompt: Annotated[
+    telegram_entrypoint_prompt: Annotated[
         Optional[str],
         PydanticField(
             default=None,
-            description="Extra prompt for twitter entrypoint",
+            description="Extra prompt for telegram entrypoint",
             max_length=10000,
             json_schema_extra={
                 "x-group": "entrypoint",
             },
         ),
     ]
-    twitter_config: Annotated[
+    telegram_config: Annotated[
         Optional[dict],
         PydanticField(
             default=None,
-            description="You must use your own key for twitter entrypoint, it is separated from twitter skills",
-            json_schema_extra={
-                "x-group": "entrypoint",
-            },
-        ),
-    ]
-    # if telegram_entrypoint_enabled, the telegram_entrypoint_enabled will be enabled, telegram_config will be checked
-    telegram_entrypoint_enabled: Annotated[
-        Optional[bool],
-        PydanticField(
-            default=False,
-            description="Whether the agent can play telegram bot",
+            description="Telegram integration configuration settings",
             json_schema_extra={
                 "x-group": "entrypoint",
             },
         ),
     ]
-    telegram_entrypoint_prompt: Annotated[
+    xmtp_entrypoint_prompt: Annotated[
         Optional[str],
         PydanticField(
             default=None,
-            description="Extra prompt for telegram entrypoint",
+            description="Extra prompt for xmtp entrypoint, xmtp support is in beta",
             max_length=10000,
             json_schema_extra={
                 "x-group": "entrypoint",
             },
         ),
     ]
-    telegram_config: Annotated[
-        Optional[dict],
-        PydanticField(
-            default=None,
-            description="Telegram integration configuration settings",
-            json_schema_extra={
-                "x-group": "entrypoint",
-            },
-        ),
-    ]
 
     @field_validator("purpose", "personality", "principles", "prompt", "prompt_append")
     @classmethod

intentkit/models/agent_schema.json

@@ -715,10 +715,11 @@
       "type": "string",
       "description": "Provider of the agent's wallet",
       "enum": [
-        "cdp"
+        "cdp",
+        "readonly"
       ],
       "default": "cdp",
-      "x-group": "internal"
+      "x-group": "onchain"
     },
     "network_id": {
       "title": "Network ID",
@@ -741,5 +742,26 @@
       "x-group": "internal"
     }
   },
-  "additionalProperties": false
+  "additionalProperties": false,
+  "if": {
+    "properties": {
+      "wallet_provider": {
+        "const": "readonly"
+      }
+    }
+  },
+  "then": {
+    "properties": {
+      "readonly_wallet_address": {
+        "title": "Readonly Wallet Address",
+        "type": "string",
+        "description": "Wallet address for readonly wallet provider",
+        "maxLength": 100,
+        "x-group": "onchain"
+      }
+    },
+    "required": [
+      "readonly_wallet_address"
+    ]
+  }
 }

intentkit/models/chat.py

@@ -45,6 +45,7 @@ class AuthorType(str, Enum):
     WEB = "web"
     SYSTEM = "system"
     API = "api"
+    XMTP = "xmtp"
 
 
 class ChatMessageAttachment(TypedDict):

{intentkit-0.6.12.dist-info → intentkit-0.6.13.dev1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 0.6.12
+Version: 0.6.13.dev1
 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.12.dist-info → intentkit-0.6.13.dev1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-intentkit/__init__.py,sha256=zbzkgPvIQ2ztT7vi9btpb1O9JHehm-iYvyI4ObByJUw,379
+intentkit/__init__.py,sha256=F_uVU5SmU_nyr1x_Q6qMwoJszldvQIhAXb63neYsZFA,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
@@ -11,22 +11,22 @@ intentkit/clients/__init__.py,sha256=sQ_6_bRC2MPWLPH-skQ3qsEe8ce-dUGL7i8VJOautHg
 intentkit/clients/cdp.py,sha256=VaIFzgfqpq5H4bHbFBe8UPabhkwe8s5pge_P5FssGqU,6453
 intentkit/clients/twitter.py,sha256=Lfa7srHOFnY96SXcElW0jfg7XKS_WliWnXjPZEe6SQc,18976
 intentkit/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-intentkit/config/config.py,sha256=Q3xsxRvn0RxcPpAOHbHcPumTRlJQMcE_pfnPfAl6aXw,8553
+intentkit/config/config.py,sha256=jhPr7FzZZHUsLIdyiOcaKeAsZQ8FdEo6yUaiIcvmryo,8879
 intentkit/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 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/api.py,sha256=WfoaHNquujYJIpNPuTR1dSaaxog0S3X2W4lG9Ehmkm4,3284
+intentkit/core/client.py,sha256=J5K7f08-ucszBKAbn9K3QNOFKIC__7amTbKYii1jFkI,3056
 intentkit/core/credit.py,sha256=Y5cjShFFqGBhz7Uc_ziqejyW-2FP58TYxsSNc4N_6hI,63039
-intentkit/core/engine.py,sha256=RESmyjzzcnBVHdsuA2ul68ZkxwLoqB34NnLwYJ0vwYw,37028
+intentkit/core/engine.py,sha256=MNn2M1yVIekb1kZabmnn12uphyJbylgH48Ee82vga4Y,37024
 intentkit/core/node.py,sha256=7h9zgDSd928bzUi3m3EZnKkhbwqlbRAQUr_uz7gKB5Y,8880
-intentkit/core/prompt.py,sha256=eaa2FyFptpsWlEGWCL8jVmZMGB6Pl9hBnt-y8Yq37RU,16041
+intentkit/core/prompt.py,sha256=MnT8XfrpvN51SPRGFg-wkjEOsQ1QYIjKIJkP_BMx0BU,15856
 intentkit/core/skill.py,sha256=vPK37sDRT9kzkMBymPwqZ5uEdxTTRtb_DfREIeyz-Xw,5788
-intentkit/models/agent.py,sha256=pKeafRhmFMJwuIEBJkBEIl_oEu_CQ5AkvsBVfNfoxuQ,67168
+intentkit/models/agent.py,sha256=uRImjimQadelouV2qo3crCWaioWFBoiyhqsan6VfQHI,66781
 intentkit/models/agent_data.py,sha256=mVsiK8TziYa1W1ujU1KwI9osIVIeSM7XJEogGRL1WVU,28263
-intentkit/models/agent_schema.json,sha256=sVDjTLYNcyFoMnCI2LjkN6qXbbaP_m3LXMJRo0YQgos,21762
+intentkit/models/agent_schema.json,sha256=Ln__ypJTCQuFDXWQ815UBdQXyW12pcJgNmC48bVPHc0,22223
 intentkit/models/app_setting.py,sha256=4fuW4J6NV826e53OAsW1bnn3Pgw8iUVKH9-AUMTSYQc,5550
 intentkit/models/base.py,sha256=o-zRjVrak-f5Jokdvj8BjLm8gcC3yYiYMCTLegwT2lA,185
-intentkit/models/chat.py,sha256=hLVKF0IY5w-bYn9nGuVmKVxtU558FUIJ9en9I62WRZA,19230
+intentkit/models/chat.py,sha256=5NNEAsSnoFaSYzuhS0Nh5U3f_3PhIEm-nXBxwNyO5mE,19248
 intentkit/models/conversation.py,sha256=nrbDIw-3GK5BYi_xkI15FLdx4a6SNrFK8wfAGLCsrqk,9032
 intentkit/models/credit.py,sha256=bcasHyrCwforLGrH8ZWEvN6y6ml7NeAFrGl8cfqvqbI,42956
 intentkit/models/db.py,sha256=nuDX6NEtnfD5YLr2iVpAAXsgHbSpG5diqfLC-PkHsA4,4406
@@ -403,7 +403,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.12.dist-info/METADATA,sha256=0JFswdPnQBbraUg-rN2t-1nuHIkECrniEYHtLGeNmaM,6409
-intentkit-0.6.12.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-intentkit-0.6.12.dist-info/licenses/LICENSE,sha256=Bln6DhK-LtcO4aXy-PBcdZv2f24MlJFm_qn222biJtE,1071
-intentkit-0.6.12.dist-info/RECORD,,
+intentkit-0.6.13.dev1.dist-info/METADATA,sha256=-SIA2BnS5cS6it0Cp9g60dhOZFiPXowigJSD-gOIDjI,6414
+intentkit-0.6.13.dev1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+intentkit-0.6.13.dev1.dist-info/licenses/LICENSE,sha256=Bln6DhK-LtcO4aXy-PBcdZv2f24MlJFm_qn222biJtE,1071
+intentkit-0.6.13.dev1.dist-info/RECORD,,