intentkit 1.0.0__tar.gz → 1.1.0__tar.gz

{intentkit-1.0.0 → intentkit-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 1.0.0
+Version: 1.1.0
 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-1.0.0 → intentkit-1.1.0}/intentkit/__init__.py

@@ -3,7 +3,7 @@
 A powerful platform for building AI agents with blockchain and cryptocurrency capabilities.
 """
 
-__version__ = "1.0.0"
+__version__ = "1.1.0"
 __author__ = "Ruihua"
 __email__ = "ruihua@crestal.network"
 

{intentkit-1.0.0 → intentkit-1.1.0}/intentkit/core/api.py

@@ -22,6 +22,10 @@ from intentkit.core.engine import execute_agent, stream_agent
 from intentkit.core.lead.engine import stream_lead
 from intentkit.core.lead.service import verify_team_membership
 from intentkit.core.team.channel import set_push_channel, set_push_channel_if_empty
+from intentkit.core.team.wechat_session_notice import (
+    WECHAT_SESSION_EXPIRING,
+    build_expiring_prompt,
+)
 from intentkit.models.chat import (
     AuthorType,
     ChatMessage,
@@ -31,6 +35,11 @@ from intentkit.models.chat import (
 from intentkit.models.user import User, UserUpdate
 from intentkit.utils.error import IntentKitAPIError
 
+# Set of recognized system_trigger values. Each value supplies its own
+# synthesized prompt and may override the author_type to TRIGGER so the
+# event is recorded in chat history without looking like a real user message.
+_SYSTEM_TRIGGERS: frozenset[str] = frozenset({WECHAT_SESSION_EXPIRING})
+
 # ⚠️ INTERNAL API ONLY - DO NOT EXPOSE TO PUBLIC INTERNET ⚠️
 core_router = APIRouter(
     prefix="/core",
@@ -91,6 +100,11 @@ class LeadExecuteRequest(BaseModel):
     chat_id: str
     message: str
     attachments: list[ChatMessageAttachment] | None = None
+    # When set, the integration is asking the lead agent to handle a
+    # system-driven event (e.g. wechat reply window about to close) rather
+    # than a real user message. The `message` field is replaced with a
+    # synthesized prompt and the saved record is tagged AuthorType.TRIGGER.
+    system_trigger: str | None = None
 
 
 # Per-channel config: (user_lookup, bind_field, author_type, chat_id_prefix)
@@ -131,15 +145,31 @@ async def _resolve_lead(
     else:
         user_id = request.channel_user_id
 
+    # System-driven trigger: replace the (likely empty) caller message with
+    # a synthesized prompt and tag the saved record as TRIGGER so chat-UI
+    # consumers can hide it the same way they hide autonomous task triggers.
+    message_text = request.message
+    saved_author_type = author_type
+    if request.system_trigger:
+        if request.system_trigger not in _SYSTEM_TRIGGERS:
+            raise IntentKitAPIError(
+                400,
+                "Bad Request",
+                f"Unknown system_trigger: {request.system_trigger}",
+            )
+        if request.system_trigger == WECHAT_SESSION_EXPIRING:
+            message_text = await build_expiring_prompt(request.team_id)
+        saved_author_type = AuthorType.TRIGGER
+
     chat_msg = ChatMessageCreate(
         id=str(XID()),
         agent_id=f"team-{request.team_id}",
         chat_id=f"{chat_prefix}:{request.team_id}:{request.chat_id}",
         user_id=user_id,
         author_id=user_id,
-        author_type=author_type,
+        author_type=saved_author_type,
         thread_type=author_type,
-        message=request.message,
+        message=message_text,
         attachments=request.attachments,
     )
     return user_id, chat_msg

{intentkit-1.0.0 → intentkit-1.1.0}/intentkit/core/lead/engine.py

@@ -73,7 +73,8 @@ async def _build_lead_agent(team_id: str) -> Agent:
         "- `agent-manager`: Agent CRUD.\n"
         "- `task-manager`: Autonomous task scheduling and management.\n"
         "- `self-updater`: Update your own name, avatar, personality, or memory.\n"
-        "- `content-manager`: Read team activities and posts.\n\n"
+        "- `content-manager`: Read team activities and posts.\n"
+        "- `user-manager`: Update the current user's profile (name, timezone, language).\n\n"
         "You can also use `lead_call_agent` to delegate to any team agent "
         "discovered via `lead_list_team_agents`.\n\n"
         "### Workflow\n\n"

{intentkit-1.0.0 → intentkit-1.1.0}/intentkit/core/lead/skills/__init__.py

@@ -72,6 +72,10 @@ from intentkit.core.lead.skills.update_team_agent import (
     UpdateTeamAgent,
     update_team_agent_skill,
 )
+from intentkit.core.lead.skills.update_user_profile import (
+    LeadUpdateUserProfile,
+    lead_update_user_profile_skill,
+)
 
 __all__ = [
     "CreateTeamAgent",
@@ -108,6 +112,8 @@ __all__ = [
     "lead_update_self_memory_skill",
     "ListTeamAgents",
     "list_team_agents_skill",
+    "LeadUpdateUserProfile",
+    "lead_update_user_profile_skill",
     "UpdateTeamAgent",
     "update_team_agent_skill",
 ]

intentkit-1.1.0/intentkit/core/lead/skills/update_user_profile.py

@@ -0,0 +1,134 @@
+"""Skill to update the current user's profile."""
+
+from __future__ import annotations
+
+import logging
+from typing import Any, override
+from zoneinfo import ZoneInfo, ZoneInfoNotFoundError
+
+from langchain_core.tools import ArgsSchema
+from langchain_core.tools.base import ToolException
+from pydantic import BaseModel, Field
+
+from intentkit.config.redis import get_redis
+from intentkit.core.lead.skills.base import LeadSkill
+from intentkit.models.user import UserUpdate
+
+logger = logging.getLogger(__name__)
+
+# Must stay in sync with USER_CACHE_PREFIX in app/team/user.py — we duplicate
+# the constant because core/ cannot import from app/.
+_USER_CACHE_PREFIX = "intentkit:user:"
+
+
+class UpdateUserProfileInput(BaseModel):
+    """Input model for lead_update_user_profile skill."""
+
+    name: str | None = Field(
+        default=None,
+        description="New display name (max 50 chars). Omit to keep unchanged.",
+    )
+    timezone: str | None = Field(
+        default=None,
+        description=(
+            "IANA timezone identifier (e.g. 'Asia/Shanghai', 'America/New_York'). "
+            "Convert offsets like 'GMT+8' to the corresponding IANA name first. "
+            "Omit to keep unchanged. Pass an empty string to clear."
+        ),
+    )
+    language: str | None = Field(
+        default=None,
+        description=(
+            "Preferred language as a BCP 47 tag (e.g. 'zh-CN', 'en', 'ja'). "
+            "Omit to keep unchanged. Pass an empty string to clear."
+        ),
+    )
+
+
+class UpdateUserProfileOutput(BaseModel):
+    """Output model for lead_update_user_profile skill."""
+
+    message: str = Field(description="Success message")
+    updated_fields: list[str] = Field(description="List of fields that were updated")
+
+
+class LeadUpdateUserProfile(LeadSkill):
+    """Skill to update the current user's profile (name, timezone, language).
+
+    Writes go through `UserUpdate.patch`, so a row is created if the user does
+    not yet exist. The user's API-side Redis cache is invalidated so the next
+    GET reflects the change.
+    """
+
+    name: str = "lead_update_user_profile"
+    description: str = (
+        "Update the current user's profile. Supported fields: name, timezone, "
+        "language. Only provide the fields you want to change. The user is "
+        "always taken from the current conversation context — never accept a "
+        "user id as input."
+    )
+    args_schema: ArgsSchema | None = UpdateUserProfileInput
+
+    @override
+    async def _arun(
+        self,
+        name: str | None = None,
+        timezone: str | None = None,
+        language: str | None = None,
+        **kwargs: Any,
+    ) -> UpdateUserProfileOutput:
+        context = self.get_context()
+        user_id = context.user_id
+        if not user_id:
+            raise ToolException("No user_id in context")
+
+        updates: dict[str, Any] = {}
+        updated_fields: list[str] = []
+
+        if name is not None:
+            trimmed = name.strip()
+            if trimmed:
+                updates["name"] = trimmed[:50]
+                updated_fields.append("name")
+
+        if timezone is not None:
+            tz = timezone.strip()
+            if tz:
+                try:
+                    ZoneInfo(tz)
+                except (ZoneInfoNotFoundError, ValueError) as exc:
+                    raise ToolException(
+                        f"Invalid IANA timezone: {timezone!r}. "
+                        "Use a name like 'Asia/Shanghai' or 'America/New_York'."
+                    ) from exc
+                updates["timezone"] = tz
+            else:
+                updates["timezone"] = None
+            updated_fields.append("timezone")
+
+        if language is not None:
+            lang = language.strip()
+            updates["language"] = lang[:32] if lang else None
+            updated_fields.append("language")
+
+        if not updates:
+            return UpdateUserProfileOutput(
+                message="No fields provided to update.",
+                updated_fields=[],
+            )
+
+        await UserUpdate.model_validate(updates).patch(user_id)
+
+        try:
+            redis = get_redis()
+            await redis.delete(f"{_USER_CACHE_PREFIX}{user_id}")
+        except Exception as exc:
+            logger.warning("Failed to invalidate user cache for %s: %s", user_id, exc)
+
+        return UpdateUserProfileOutput(
+            message=f"User profile updated: {', '.join(updated_fields)}.",
+            updated_fields=updated_fields,
+        )
+
+
+lead_update_user_profile_skill = LeadUpdateUserProfile()

{intentkit-1.0.0 → intentkit-1.1.0}/intentkit/core/lead/sub_agents/__init__.py

@@ -23,6 +23,7 @@ SLUG_AGENT_MANAGER = "agent-manager"
 SLUG_TASK_MANAGER = "task-manager"
 SLUG_SELF_UPDATER = "self-updater"
 SLUG_CONTENT_MANAGER = "content-manager"
+SLUG_USER_MANAGER = "user-manager"
 
 
 @dataclass
@@ -112,6 +113,10 @@ from intentkit.core.lead.sub_agents.task_manager import (  # noqa: E402
     build_task_manager,
     get_task_manager_skills,
 )
+from intentkit.core.lead.sub_agents.user_manager import (  # noqa: E402
+    build_user_manager,
+    get_user_manager_skills,
+)
 
 SUB_AGENT_REGISTRY: dict[str, SubAgentDefinition] = {
     SLUG_AGENT_MANAGER: SubAgentDefinition(
@@ -147,4 +152,10 @@ SUB_AGENT_REGISTRY: dict[str, SubAgentDefinition] = {
         build_fn=build_content_manager,
         skills_fn=get_content_manager_skills,
     ),
+    SLUG_USER_MANAGER: SubAgentDefinition(
+        slug=SLUG_USER_MANAGER,
+        description=("Manages the current user's profile: name, timezone, language."),
+        build_fn=build_user_manager,
+        skills_fn=get_user_manager_skills,
+    ),
 }

intentkit-1.1.0/intentkit/core/lead/sub_agents/user_manager.py

@@ -0,0 +1,82 @@
+"""User Manager sub-agent definition."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+from datetime import datetime, timezone
+
+from langchain_core.tools import BaseTool
+
+from intentkit.core.lead.skills.update_user_profile import (
+    lead_update_user_profile_skill,
+)
+from intentkit.models.agent import Agent
+from intentkit.models.llm_picker import pick_default_model
+
+
+def get_user_manager_skills() -> Sequence[BaseTool]:
+    """Return skills for the user-manager sub-agent."""
+    return [
+        lead_update_user_profile_skill,
+    ]
+
+
+def build_user_manager(team_id: str) -> Agent:
+    """Build an in-memory User Manager sub-agent."""
+    now = datetime.now(timezone.utc)
+
+    prompt = (
+        "### Workflow\n\n"
+        "1. Confirm with the user which fields they want to change "
+        "(name, timezone, language).\n"
+        "2. Call `lead_update_user_profile` with only the fields being changed.\n"
+        "3. Report the result back to the user.\n\n"
+        "### Field Guidelines\n\n"
+        "- `name`: max 50 characters, the user's preferred display name.\n"
+        "- `timezone`: must be an IANA timezone (e.g. `Asia/Shanghai`, "
+        "`America/New_York`, `Europe/Berlin`). If the user gives an offset "
+        "like `GMT+8` or `UTC-5`, translate it to the matching IANA name "
+        "before calling the tool.\n"
+        "- `language`: BCP 47 tag (e.g. `zh-CN`, `en`, `ja`, `ko`). Use the "
+        "tag, not the language's English name.\n\n"
+        "### Boundaries\n\n"
+        "- Only ever update the current user. Never accept or use a user id "
+        "supplied by the user.\n"
+        "- Do not expose or modify any other user's profile.\n"
+    )
+
+    agent_data = {
+        "id": f"team-{team_id}-user-manager",
+        "owner": "system",
+        "team_id": team_id,
+        "name": "User Manager",
+        "purpose": "Manage the current user's profile (name, timezone, language).",
+        "principles": (
+            "1. Speak to users in their language.\n"
+            "2. Only operate on the current user — never on others.\n"
+            "3. Confirm what will be changed before updating."
+        ),
+        "model": pick_default_model(),
+        "prompt": prompt,
+        "temperature": 0.2,
+        "search_internet": False,
+        "super_mode": False,
+        "enable_todo": False,
+        "enable_activity": False,
+        "enable_post": False,
+        "enable_long_term_memory": False,
+        "sub_agents": None,
+        "skills": {
+            "ui": {
+                "enabled": True,
+                "states": {
+                    "ui_show_card": "private",
+                    "ui_ask_user": "private",
+                },
+            },
+        },
+        "created_at": now,
+        "updated_at": now,
+    }
+
+    return Agent.model_validate(agent_data)

{intentkit-1.0.0 → intentkit-1.1.0}/intentkit/core/prompt.py

@@ -224,6 +224,13 @@ async def _build_user_info_section(context: AgentContext) -> str:
             prompt_array.append(f"User X Username: {user.x_username}\n")
         if user.telegram_username:
             prompt_array.append(f"User Telegram Username: {user.telegram_username}\n")
+        if user.timezone:
+            prompt_array.append(f"User Timezone: {user.timezone}\n")
+        if user.language:
+            prompt_array.append(
+                f"User Preferred Language: {user.language} "
+                "(reply in this language unless the user clearly switches)\n"
+            )
 
     if prompt_array:
         prompt_array.append("\n")

intentkit-1.1.0/intentkit/core/team/wechat_session_notice.py

@@ -0,0 +1,88 @@
+"""Build the synthesized prompt sent to the lead agent when the wechat
+24-hour reply window is about to close.
+
+The Go integration's per-team timer fires this through the
+``/core/lead/stream`` endpoint with ``system_trigger='wechat_session_expiring'``.
+The lead agent receives the prompt as a TRIGGER-author message, generates a
+heads-up message for the user, and the response is dispatched back over
+wechat by the existing sender path while the window is still open.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import logging
+
+from intentkit.core.autonomous import list_autonomous_tasks
+from intentkit.core.lead.service import get_team_agents
+
+logger = logging.getLogger(__name__)
+
+
+# Trigger value shared with integrations/wechat/bot/session_timer.go
+# (SessionTriggerExpiring). Keep aligned.
+WECHAT_SESSION_EXPIRING = "wechat_session_expiring"
+
+
+async def _build_team_status_block(team_id: str) -> str:
+    """Return a compact, human-readable summary of the team's agents and
+    their currently enabled autonomous tasks. Best-effort: failures are
+    swallowed and reflected as a placeholder line so the notice still goes
+    out even if status collection breaks."""
+    try:
+        agents = await get_team_agents(team_id)
+    except Exception:
+        logger.warning(
+            "wechat session notice: failed to list team agents", exc_info=True
+        )
+        return "（暂无法获取 agent 状态）"
+
+    if not agents:
+        return "团队当前没有部署任何 agent。"
+
+    # Fan out per-agent task lookups concurrently — sequential awaits would
+    # add one DB round-trip per agent on the user-facing latency path.
+    task_results = await asyncio.gather(
+        *(list_autonomous_tasks(a.id) for a in agents),
+        return_exceptions=True,
+    )
+
+    lines: list[str] = []
+    for agent, tasks_or_err in zip(agents, task_results):
+        if isinstance(tasks_or_err, BaseException):
+            logger.warning(
+                "wechat session notice: failed to list autonomous tasks for %s",
+                agent.id,
+                exc_info=tasks_or_err,
+            )
+            tasks = []
+        else:
+            tasks = tasks_or_err
+
+        enabled_tasks = [t for t in tasks if t.enabled]
+        if enabled_tasks:
+            task_summaries = [f"{t.name}（cron={t.cron}）" for t in enabled_tasks]
+            lines.append(
+                f"- {agent.name}: 进行中的自动任务 {len(enabled_tasks)} 个 — "
+                + "；".join(task_summaries)
+            )
+        else:
+            lines.append(f"- {agent.name}: 暂无启用中的自动任务。")
+
+    return "\n".join(lines)
+
+
+async def build_expiring_prompt(team_id: str) -> str:
+    """Build the synthesized user-facing prompt for the lead agent."""
+    status_block = await _build_team_status_block(team_id)
+    return (
+        "系统事件：用户在微信上即将达到 24 小时未与你互动的时间窗口，"
+        "再过 30 分钟左右我将无法主动给 ta 发消息。"
+        "请直接以你自己的口吻给用户写一条微信消息，做到：\n"
+        "1) 简明告知微信对主动消息有 1 天的时间限制，即将到期；\n"
+        "2) 提示如果想继续接收推送，回复任意消息或交付一个新任务即可；\n"
+        "3) 顺带把当前每个 agent 的状态和未完成任务概要带上。\n\n"
+        "回复直接就是发给用户的文本，不要再加引导语、问候或 markdown。\n\n"
+        "当前团队状态如下：\n"
+        f"{status_block}"
+    )

{intentkit-1.0.0 → intentkit-1.1.0}/intentkit/models/user.py

@@ -109,6 +109,14 @@ class UserTable(Base):
         String,
         nullable=True,
     )
+    timezone: Mapped[str | None] = mapped_column(
+        String,
+        nullable=True,
+    )
+    language: Mapped[str | None] = mapped_column(
+        String,
+        nullable=True,
+    )
     extra: Mapped[dict[str, object] | None] = mapped_column(
         JSONB(),
         nullable=True,
@@ -180,6 +188,22 @@ class UserUpdate(BaseModel):
     wechat_id: Annotated[
         str | None, Field(None, description="User's WeChat ID (e.g. xxxxx@im.wechat)")
     ]
+    timezone: Annotated[
+        str | None,
+        Field(
+            None,
+            description=(
+                "IANA timezone identifier (e.g. 'Asia/Shanghai', 'America/New_York')"
+            ),
+        ),
+    ]
+    language: Annotated[
+        str | None,
+        Field(
+            None,
+            description="Preferred language as BCP 47 tag (e.g. 'zh-CN', 'en')",
+        ),
+    ]
     extra: Annotated[
         dict[str, object] | None, Field(None, description="Additional user information")
     ]

{intentkit-1.0.0 → intentkit-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "intentkit"
-version = "1.0.0"
+version = "1.1.0"
 description = "Intent-based AI Agent Platform - Core Package"
 authors = [
     { name = "Ruihua", email = "ruihua@crestal.network" },