intentkit 0.7.5.dev1__tar.gz → 0.7.5.dev3__tar.gz

{intentkit-0.7.5.dev1 → intentkit-0.7.5.dev3}/PKG-INFO

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

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

{intentkit-0.7.5.dev1 → intentkit-0.7.5.dev3}/models/agent.py

@@ -166,61 +166,22 @@ class AgentExample(BaseModel):
     ]
 
 
-class AgentTable(Base):
-    """Agent table db model."""
+class AgentUserInputColumns:
+    """Abstract base class containing columns that are common to AgentTable and other tables."""
 
-    __tablename__ = "agents"
+    __abstract__ = True
 
-    id = Column(
-        String,
-        primary_key=True,
-        comment="Unique identifier for the agent. Must be URL-safe, containing only lowercase letters, numbers, and hyphens",
-    )
+    # Basic information fields from AgentCore
     name = Column(
         String,
         nullable=True,
         comment="Display name of the agent",
     )
-    slug = Column(
-        String,
-        nullable=True,
-        comment="Slug of the agent, used for URL generation",
-    )
-    description = Column(
-        String,
-        nullable=True,
-        comment="Description of the agent, for public view, not contained in prompt",
-    )
-    external_website = Column(
-        String,
-        nullable=True,
-        comment="Link of external website of the agent, if you have one",
-    )
     picture = Column(
         String,
         nullable=True,
         comment="Picture of the agent",
     )
-    ticker = Column(
-        String,
-        nullable=True,
-        comment="Ticker symbol of the agent",
-    )
-    token_address = Column(
-        String,
-        nullable=True,
-        comment="Token address of the agent",
-    )
-    token_pool = Column(
-        String,
-        nullable=True,
-        comment="Pool of the agent token",
-    )
-    fee_percentage = Column(
-        Numeric(22, 4),
-        nullable=True,
-        comment="Fee percentage of the agent",
-    )
     purpose = Column(
         String,
         nullable=True,
@@ -236,39 +197,8 @@ class AgentTable(Base):
         nullable=True,
         comment="Principles or values of the agent",
     )
-    owner = Column(
-        String,
-        nullable=True,
-        comment="Owner identifier of the agent, used for access control",
-    )
-    upstream_id = Column(
-        String,
-        index=True,
-        nullable=True,
-        comment="Upstream reference ID for idempotent operations",
-    )
-    upstream_extra = Column(
-        JSON().with_variant(JSONB(), "postgresql"),
-        nullable=True,
-        comment="Additional data store for upstream use",
-    )
-    wallet_provider = Column(
-        String,
-        nullable=True,
-        comment="Provider of the agent's wallet",
-    )
-    readonly_wallet_address = Column(
-        String,
-        nullable=True,
-        comment="Readonly wallet address of the agent",
-    )
-    network_id = Column(
-        String,
-        nullable=True,
-        default="base-mainnet",
-        comment="Network identifier",
-    )
-    # AI part
+
+    # AI model configuration fields from AgentCore
     model = Column(
         String,
         nullable=True,
@@ -303,36 +233,44 @@ class AgentTable(Base):
         default=0.0,
         comment="Controls topic adherence (-2.0~2.0). Higher values allow more topic deviation, lower values enforce stricter topic adherence.",
     )
-    short_term_memory_strategy = Column(
+
+    # Wallet and network configuration fields from AgentCore
+    wallet_provider = Column(
         String,
         nullable=True,
-        default="trim",
-        comment="Strategy for managing short-term memory when context limit is reached. 'trim' removes oldest messages, 'summarize' creates summaries.",
+        comment="Provider of the agent's wallet",
     )
-    # autonomous mode
-    autonomous = Column(
-        JSON().with_variant(JSONB(), "postgresql"),
+    readonly_wallet_address = Column(
+        String,
         nullable=True,
-        comment="Autonomous agent configurations",
+        comment="Readonly wallet address of the agent",
     )
-    # agent examples
-    example_intro = Column(
+    network_id = Column(
         String,
         nullable=True,
-        comment="Introduction for example interactions",
+        default="base-mainnet",
+        comment="Network identifier",
     )
-    examples = Column(
+
+    # Skills configuration from AgentCore
+    skills = Column(
         JSON().with_variant(JSONB(), "postgresql"),
         nullable=True,
-        comment="List of example interactions for the agent",
+        comment="Dict of skills and their corresponding configurations",
     )
-    # skills
-    skills = Column(
+
+    # Additional fields from AgentUserInput
+    short_term_memory_strategy = Column(
+        String,
+        nullable=True,
+        default="trim",
+        comment="Strategy for managing short-term memory when context limit is reached. 'trim' removes oldest messages, 'summarize' creates summaries.",
+    )
+    autonomous = Column(
         JSON().with_variant(JSONB(), "postgresql"),
         nullable=True,
-        comment="Dict of skills and their corresponding configurations",
+        comment="Autonomous agent configurations",
     )
-    # if telegram_entrypoint_enabled, the telegram_entrypoint_enabled will be enabled, telegram_config will be checked
     telegram_entrypoint_enabled = Column(
         Boolean,
         nullable=True,
@@ -354,6 +292,39 @@ class AgentTable(Base):
         nullable=True,
         comment="Extra prompt for xmtp entrypoint",
     )
+
+
+class AgentTable(Base, AgentUserInputColumns):
+    """Agent table db model."""
+
+    __tablename__ = "agents"
+
+    id = Column(
+        String,
+        primary_key=True,
+        comment="Unique identifier for the agent. Must be URL-safe, containing only lowercase letters, numbers, and hyphens",
+    )
+    slug = Column(
+        String,
+        nullable=True,
+        comment="Slug of the agent, used for URL generation",
+    )
+    owner = Column(
+        String,
+        nullable=True,
+        comment="Owner identifier of the agent, used for access control",
+    )
+    upstream_id = Column(
+        String,
+        index=True,
+        nullable=True,
+        comment="Upstream reference ID for idempotent operations",
+    )
+    upstream_extra = Column(
+        JSON().with_variant(JSONB(), "postgresql"),
+        nullable=True,
+        comment="Additional data store for upstream use",
+    )
     version = Column(
         String,
         nullable=True,
@@ -379,6 +350,49 @@ class AgentTable(Base):
         nullable=True,
         comment="Other helper data fields for query, come from agent and agent data",
     )
+
+    # Fields moved from AgentUserInputColumns that are no longer in AgentUserInput
+    description = Column(
+        String,
+        nullable=True,
+        comment="Description of the agent, for public view, not contained in prompt",
+    )
+    external_website = Column(
+        String,
+        nullable=True,
+        comment="Link of external website of the agent, if you have one",
+    )
+    ticker = Column(
+        String,
+        nullable=True,
+        comment="Ticker symbol of the agent",
+    )
+    token_address = Column(
+        String,
+        nullable=True,
+        comment="Token address of the agent",
+    )
+    token_pool = Column(
+        String,
+        nullable=True,
+        comment="Pool of the agent token",
+    )
+    fee_percentage = Column(
+        Numeric(22, 4),
+        nullable=True,
+        comment="Fee percentage of the agent",
+    )
+    example_intro = Column(
+        String,
+        nullable=True,
+        comment="Introduction for example interactions",
+    )
+    examples = Column(
+        JSON().with_variant(JSONB(), "postgresql"),
+        nullable=True,
+        comment="List of example interactions for the agent",
+    )
+
     # auto timestamp
     created_at = Column(
         DateTime(timezone=True),
@@ -411,29 +425,6 @@ class AgentCore(BaseModel):
             },
         ),
     ]
-    description: Annotated[
-        Optional[str],
-        PydanticField(
-            default=None,
-            description="Description of the agent, for public view, not contained in prompt",
-            json_schema_extra={
-                "x-group": "basic",
-                "x-placeholder": "Introduce your agent",
-            },
-        ),
-    ]
-    external_website: Annotated[
-        Optional[str],
-        PydanticField(
-            default=None,
-            description="Link of external website of the agent, if you have one",
-            json_schema_extra={
-                "x-group": "basic",
-                "x-placeholder": "Enter agent external website url",
-                "format": "uri",
-            },
-        ),
-    ]
     picture: Annotated[
         Optional[str],
         PydanticField(
@@ -445,54 +436,6 @@ class AgentCore(BaseModel):
             },
         ),
     ]
-    ticker: Annotated[
-        Optional[str],
-        PydanticField(
-            default=None,
-            description="Ticker symbol of the agent",
-            max_length=10,
-            min_length=1,
-            json_schema_extra={
-                "x-group": "basic",
-                "x-placeholder": "If one day, your agent has it's own token, what will it be?",
-            },
-        ),
-    ]
-    token_address: Annotated[
-        Optional[str],
-        PydanticField(
-            default=None,
-            description="Token address of the agent",
-            max_length=42,
-            json_schema_extra={
-                "x-group": "internal",
-                "readOnly": True,
-            },
-        ),
-    ]
-    token_pool: Annotated[
-        Optional[str],
-        PydanticField(
-            default=None,
-            description="Pool of the agent token",
-            max_length=42,
-            json_schema_extra={
-                "x-group": "internal",
-                "readOnly": True,
-            },
-        ),
-    ]
-    fee_percentage: Annotated[
-        Optional[Decimal],
-        PydanticField(
-            default=None,
-            description="Fee percentage of the agent",
-            ge=Decimal("0.0"),
-            json_schema_extra={
-                "x-group": "basic",
-            },
-        ),
-    ]
     purpose: Annotated[
         Optional[str],
         PydanticField(
@@ -701,6 +644,11 @@ class AgentCore(BaseModel):
 class AgentUserInput(AgentCore):
     """Agent update model."""
 
+    model_config = ConfigDict(
+        title="AgentUserInput",
+        from_attributes=True,
+    )
+
     short_term_memory_strategy: Annotated[
         Optional[Literal["trim", "summarize"]],
         PydanticField(
@@ -736,29 +684,6 @@ class AgentUserInput(AgentCore):
             },
         ),
     ]
-    example_intro: Annotated[
-        Optional[str],
-        PydanticField(
-            default=None,
-            description="Introduction of the example",
-            max_length=2000,
-            json_schema_extra={
-                "x-group": "examples",
-            },
-        ),
-    ]
-    examples: Annotated[
-        Optional[List[AgentExample]],
-        PydanticField(
-            default=None,
-            description="List of example prompts for the agent",
-            max_length=6,
-            json_schema_extra={
-                "x-group": "examples",
-                "x-inline": True,
-            },
-        ),
-    ]
     # if telegram_entrypoint_enabled, the telegram_entrypoint_enabled will be enabled, telegram_config will be checked
     telegram_entrypoint_enabled: Annotated[
         Optional[bool],
@@ -1019,7 +944,111 @@ class AgentCreate(AgentUpdate):
             return Agent.model_validate(db_agent)
 
 
-class Agent(AgentCreate):
+class AgentPublicInfo(BaseModel):
+    """Public information of the agent."""
+
+    model_config = ConfigDict(
+        title="AgentPublicInfo",
+        from_attributes=True,
+    )
+
+    description: Annotated[
+        Optional[str],
+        PydanticField(
+            default=None,
+            description="Description of the agent, for public view, not contained in prompt",
+            json_schema_extra={
+                "x-group": "basic",
+                "x-placeholder": "Introduce your agent",
+            },
+        ),
+    ]
+    external_website: Annotated[
+        Optional[str],
+        PydanticField(
+            default=None,
+            description="Link of external website of the agent, if you have one",
+            json_schema_extra={
+                "x-group": "basic",
+                "x-placeholder": "Enter agent external website url",
+                "format": "uri",
+            },
+        ),
+    ]
+    ticker: Annotated[
+        Optional[str],
+        PydanticField(
+            default=None,
+            description="Ticker symbol of the agent",
+            max_length=10,
+            min_length=1,
+            json_schema_extra={
+                "x-group": "basic",
+                "x-placeholder": "If one day, your agent has it's own token, what will it be?",
+            },
+        ),
+    ]
+    token_address: Annotated[
+        Optional[str],
+        PydanticField(
+            default=None,
+            description="Token address of the agent",
+            max_length=42,
+            json_schema_extra={
+                "x-group": "internal",
+                "readOnly": True,
+            },
+        ),
+    ]
+    token_pool: Annotated[
+        Optional[str],
+        PydanticField(
+            default=None,
+            description="Pool of the agent token",
+            max_length=42,
+            json_schema_extra={
+                "x-group": "internal",
+                "readOnly": True,
+            },
+        ),
+    ]
+    fee_percentage: Annotated[
+        Optional[Decimal],
+        PydanticField(
+            default=None,
+            description="Fee percentage of the agent",
+            ge=Decimal("0.0"),
+            json_schema_extra={
+                "x-group": "basic",
+            },
+        ),
+    ]
+    example_intro: Annotated[
+        Optional[str],
+        PydanticField(
+            default=None,
+            description="Introduction of the example",
+            max_length=2000,
+            json_schema_extra={
+                "x-group": "examples",
+            },
+        ),
+    ]
+    examples: Annotated[
+        Optional[List[AgentExample]],
+        PydanticField(
+            default=None,
+            description="List of example prompts for the agent",
+            max_length=6,
+            json_schema_extra={
+                "x-group": "examples",
+                "x-inline": True,
+            },
+        ),
+    ]
+
+
+class Agent(AgentCreate, AgentPublicInfo):
     """Agent model."""
 
     model_config = ConfigDict(from_attributes=True)
@@ -1446,6 +1475,7 @@ class AgentResponse(Agent):
     """Response model for Agent API."""
 
     model_config = ConfigDict(
+        use_enum_values=True,
         from_attributes=True,
         json_encoders={
             datetime: lambda dt: dt.isoformat(),
@@ -1556,14 +1586,33 @@ class AgentResponse(Agent):
             filtered_autonomous = []
             for item in data["autonomous"]:
                 if isinstance(item, dict):
-                    filtered_item = {
-                        "id": item.get("id"),
-                        "name": item.get("name"),
-                        "enabled": item.get("enabled"),
-                    }
-                    filtered_autonomous.append(filtered_item)
+                    # Create proper AgentAutonomous instance with only public fields
+                    filtered_autonomous.append(
+                        AgentAutonomous(
+                            id=item.get("id"),
+                            name=item.get("name"),
+                            enabled=item.get("enabled"),
+                            # Set required prompt field to empty string for public view
+                            prompt="",
+                        )
+                    )
             data["autonomous"] = filtered_autonomous
 
+        # Convert examples dictionaries to AgentExample instances
+        if data.get("examples"):
+            examples_list = []
+            for item in data["examples"]:
+                if isinstance(item, dict):
+                    # Create proper AgentExample instance
+                    examples_list.append(
+                        AgentExample(
+                            name=item.get("name", ""),
+                            description=item.get("description", ""),
+                            prompt=item.get("prompt", ""),
+                        )
+                    )
+            data["examples"] = examples_list
+
         # Filter sensitive fields from skills dictionary
         if data.get("skills"):
             filtered_skills = {}

intentkit-0.7.5.dev3/models/agent_public.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "AgentPublicInfo",
+  "description": "Public information of the agent",
+  "properties": {
+    "description": {
+      "title": "Description",
+      "type": "string",
+      "description": "Description of the agent, for public view, not contained in prompt",
+      "x-group": "basic",
+      "x-placeholder": "Introduce your agent"
+    },
+    "external_website": {
+      "title": "External Website",
+      "type": "string",
+      "description": "Link of external website of the agent, if you have one",
+      "format": "uri",
+      "x-group": "basic",
+      "x-placeholder": "Enter agent external website url"
+    },
+    "ticker": {
+      "title": "Ticker",
+      "type": "string",
+      "description": "Ticker symbol of the agent",
+      "maxLength": 10,
+      "minLength": 1,
+      "x-group": "basic",
+      "x-placeholder": "If one day, your agent has it's own token, what will it be?"
+    },
+    "token_address": {
+      "title": "Token Address",
+      "type": "string",
+      "description": "Token address of the agent",
+      "maxLength": 42,
+      "x-group": "internal",
+      "readOnly": true
+    },
+    "token_pool": {
+      "title": "Token Pool",
+      "type": "string",
+      "description": "Pool of the agent token",
+      "maxLength": 42,
+      "x-group": "internal",
+      "readOnly": true
+    },
+    "fee_percentage": {
+      "title": "Fee Percentage",
+      "type": "number",
+      "description": "Fee percentage of the agent",
+      "minimum": 0,
+      "x-group": "basic"
+    },
+    "example_intro": {
+      "title": "Example Introduction",
+      "type": "string",
+      "description": "Introduction of the example",
+      "maxLength": 2000,
+      "x-group": "examples"
+    },
+    "examples": {
+      "title": "Examples",
+      "type": "array",
+      "description": "List of example prompts for the agent",
+      "maxItems": 6,
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "title": "Name",
+            "type": "string",
+            "description": "Name of the example",
+            "maxLength": 50,
+            "x-group": "examples"
+          },
+          "description": {
+            "title": "Description",
+            "type": "string",
+            "description": "Description of the example",
+            "maxLength": 200,
+            "x-group": "examples"
+          },
+          "prompt": {
+            "title": "Prompt",
+            "type": "string",
+            "description": "Example prompt",
+            "maxLength": 2000,
+            "x-group": "examples"
+          }
+        },
+        "required": ["name", "description", "prompt"]
+      },
+      "x-group": "examples",
+      "x-inline": true
+    }
+  },
+  "additionalProperties": true
+}