agentlaunch-templates 0.4.2 → 0.4.3

package/dist/templates/chat-memory.d.ts

@@ -1,19 +1,10 @@
 /**
- * chat-memory.ts — Base template with conversation memory and configurable LLM
+ * chat-memory.ts — Base template with chat memory and context
  *
- * This is the foundation template for building AI agents on Agentverse.
- * Features:
- *   - Conversation memory (persists last N exchanges per user)
- *   - Configurable LLM backend (ASI1, OpenRouter, OpenAI, or any compatible API)
- *   - Clean Chat Protocol v0.3.0 implementation
- *   - Session persistence via ctx.storage
- *   - Lazy LLM client initialization (avoids compile-time issues)
- *
- * Compatible LLM providers:
- *   - ASI1: https://api.asi1.ai/v1 (default)
- *   - OpenRouter: https://openrouter.ai/api/v1
- *   - OpenAI: https://api.openai.com/v1
- *   - Any OpenAI-compatible endpoint
+ * Platform constants (source of truth: deployed smart contracts):
+ *   - Deploy fee: 120 FET (read dynamically, can change via multi-sig)
+ *   - Graduation target: 30,000 FET -> auto DEX listing
+ *   - Trading fee: 2% -> 100% to protocol treasury (NO creator fee)
  */
 import type { AgentTemplate } from "../registry.js";
 export declare const template: AgentTemplate;

package/dist/templates/chat-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-memory.d.ts","sourceRoot":"","sources":["../../src/templates/chat-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,eAAO,MAAM,QAAQ,EAAE,aAyQtB,CAAC"}
+{"version":3,"file":"chat-memory.d.ts","sourceRoot":"","sources":["../../src/templates/chat-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAQpD,eAAO,MAAM,QAAQ,EAAE,aA+LtB,CAAC"}

package/dist/templates/chat-memory.js

@@ -1,279 +1,201 @@
 /**
- * chat-memory.ts — Base template with conversation memory and configurable LLM
+ * chat-memory.ts — Base template with chat memory and context
  *
- * This is the foundation template for building AI agents on Agentverse.
- * Features:
- *   - Conversation memory (persists last N exchanges per user)
- *   - Configurable LLM backend (ASI1, OpenRouter, OpenAI, or any compatible API)
- *   - Clean Chat Protocol v0.3.0 implementation
- *   - Session persistence via ctx.storage
- *   - Lazy LLM client initialization (avoids compile-time issues)
- *
- * Compatible LLM providers:
- *   - ASI1: https://api.asi1.ai/v1 (default)
- *   - OpenRouter: https://openrouter.ai/api/v1
- *   - OpenAI: https://api.openai.com/v1
- *   - Any OpenAI-compatible endpoint
+ * Platform constants (source of truth: deployed smart contracts):
+ *   - Deploy fee: 120 FET (read dynamically, can change via multi-sig)
+ *   - Graduation target: 30,000 FET -> auto DEX listing
+ *   - Trading fee: 2% -> 100% to protocol treasury (NO creator fee)
  */
+// Environment-based URL resolution (production is default, set AGENT_LAUNCH_ENV=dev for dev)
+const PROD_API_URL = 'https://agent-launch.ai/api';
+const DEV_API_URL = 'https://launchpad-backend-dev-1056182620041.us-central1.run.app';
+const RESOLVED_API_URL = process.env.AGENT_LAUNCH_API_URL ??
+    (process.env.AGENT_LAUNCH_ENV === 'dev' ? DEV_API_URL : PROD_API_URL);
 export const template = {
     name: "chat-memory",
-    description: "AI agent with conversation memory and configurable LLM (ASI1, OpenRouter, OpenAI)",
-    category: "AI/ML",
+    description: "Chat agent with conversation memory — recommended starting point",
+    category: "General",
     variables: [
         { name: "agent_name", required: true, description: "Name of the agent" },
         {
             name: "description",
-            required: false,
-            default: "AI assistant with conversation memory",
+            required: true,
             description: "Short description of what this agent does",
         },
         {
-            name: "system_prompt",
-            default: "You are a helpful AI assistant. Be concise and accurate.",
-            description: "System prompt that defines the agent's personality and knowledge",
-        },
-        {
-            name: "llm_base_url",
-            default: "https://api.asi1.ai/v1",
-            description: "LLM API base URL (ASI1, OpenRouter, OpenAI, or compatible)",
-        },
-        {
-            name: "llm_model",
-            default: "asi1-mini",
-            description: "Model name to use (e.g., asi1-mini, gpt-4o-mini, claude-3-haiku)",
-        },
-        {
-            name: "max_history",
+            name: "memory_size",
             default: "10",
-            description: "Number of conversation exchanges to remember per user",
-        },
-        {
-            name: "max_tokens",
-            default: "1500",
-            description: "Maximum tokens in LLM response",
-        },
-        {
-            name: "temperature",
-            default: "0.7",
-            description: "LLM temperature (0.0-1.0, lower = more deterministic)",
+            description: "Number of messages to remember per user",
         },
     ],
-    dependencies: ["openai"],
-    secrets: ["LLM_API_KEY", "AGENTVERSE_API_KEY"],
-    code: `"""
-{{agent_name}} — AI Agent with Conversation Memory
-
-{{description}}
-
-Built with the chat-memory template.
-Supports ASI1, OpenRouter, OpenAI, or any OpenAI-compatible LLM.
+    dependencies: ["requests"],
+    secrets: ["AGENTVERSE_API_KEY", "AGENTLAUNCH_API_KEY", "AGENT_ADDRESS"],
+    code: `#!/usr/bin/env python3
+"""
+{{agent_name}} — AgentLaunch Chat Memory Agent
+Generated by: agentlaunch scaffold {{agent_name}} --type chat-memory
 
-Environment variables (set as Agentverse secrets):
-  LLM_API_KEY     - Your LLM provider API key (required)
-  LLM_BASE_URL    - API endpoint (default: {{llm_base_url}})
-  LLM_MODEL       - Model name (default: {{llm_model}})
-  SYSTEM_PROMPT   - Override the default system prompt
+Platform constants (source of truth: deployed smart contracts):
+  - Deploy fee: 120 FET (read dynamically, can change via multi-sig)
+  - Graduation target: 30,000 FET -> auto DEX listing
+  - Trading fee: 2% -> 100% to protocol treasury (NO creator fee)
 """
 
 from uagents import Agent, Context, Protocol
 from uagents_core.contrib.protocols.chat import (
-    ChatMessage, ChatAcknowledgement, TextContent,
-    EndSessionContent, chat_protocol_spec
+    ChatAcknowledgement,
+    ChatMessage,
+    EndSessionContent,
+    TextContent,
+    chat_protocol_spec,
 )
-from datetime import datetime
+
 import json
 import os
+from collections import defaultdict
+from datetime import datetime
+from typing import Dict, List
+from uuid import uuid4
 
-agent = Agent()
-chat_proto = Protocol(spec=chat_protocol_spec)
+# ==============================================================================
+# CONFIG
+# ==============================================================================
 
-# =============================================================================
-# CONFIGURATION
-# =============================================================================
+AGENTLAUNCH_API = os.environ.get("AGENTLAUNCH_API", "${RESOLVED_API_URL}")
+MEMORY_SIZE = {{memory_size}}
 
-CONFIG = {
+BUSINESS = {
     "name": "{{agent_name}}",
     "description": "{{description}}",
-    "llm_base_url": os.environ.get("LLM_BASE_URL", "{{llm_base_url}}"),
-    "llm_model": os.environ.get("LLM_MODEL", "{{llm_model}}"),
-    "max_history": {{max_history}},
-    "max_tokens": {{max_tokens}},
-    "temperature": {{temperature}},
+    "version": "1.0.0",
 }
 
-DEFAULT_SYSTEM_PROMPT = """{{system_prompt}}"""
-
-SYSTEM_PROMPT = os.environ.get("SYSTEM_PROMPT", DEFAULT_SYSTEM_PROMPT)
-
-# =============================================================================
-# LLM CLIENT (Lazy initialization)
-# =============================================================================
-
-_llm_client = None
-
-def get_llm_client():
-    """Get or create LLM client. Lazy init avoids compile-time issues."""
-    global _llm_client
-    if _llm_client is None:
-        from openai import OpenAI
-        _llm_client = OpenAI(
-            api_key=os.environ.get("LLM_API_KEY", ""),
-            base_url=CONFIG["llm_base_url"]
-        )
-    return _llm_client
-
-# =============================================================================
+# ==============================================================================
 # CONVERSATION MEMORY
-# =============================================================================
-
-def get_session(ctx: Context, sender: str) -> dict:
-    """Get or create session state with conversation history."""
-    key = f"session:{sender}"
-    data = ctx.storage.get(key)
-    if data:
-        session = json.loads(data)
-        if "history" not in session:
-            session["history"] = []
-        return session
-    return {"history": [], "message_count": 0}
-
-def save_session(ctx: Context, sender: str, session: dict):
-    """Persist session state."""
-    ctx.storage.set(f"session:{sender}", json.dumps(session))
-
-def add_to_history(session: dict, role: str, content: str):
-    """Add message to history, keeping only last MAX_HISTORY exchanges."""
-    session["history"].append({"role": role, "content": content})
-    max_messages = CONFIG["max_history"] * 2  # user + assistant pairs
-    if len(session["history"]) > max_messages:
-        session["history"] = session["history"][-max_messages:]
-
-# =============================================================================
-# LLM INTERACTION
-# =============================================================================
-
-def chat_with_llm(user_message: str, history: list = None) -> str:
-    """
-    Send a message to the LLM with conversation history.
-    Returns the assistant's response.
-    """
-    messages = [{"role": "system", "content": SYSTEM_PROMPT}]
-
-    if history:
-        messages.extend(history)
-
-    messages.append({"role": "user", "content": user_message})
-
+# ==============================================================================
+
+class ConversationMemory:
+    """Store recent messages per user for context."""
+
+    def __init__(self, max_messages: int = MEMORY_SIZE) -> None:
+        self._history: Dict[str, List[Dict]] = defaultdict(list)
+        self._max = max_messages
+
+    def add(self, user_id: str, role: str, content: str) -> None:
+        self._history[user_id].append({
+            "role": role,
+            "content": content,
+            "timestamp": datetime.utcnow().isoformat(),
+        })
+        if len(self._history[user_id]) > self._max:
+            self._history[user_id] = self._history[user_id][-self._max:]
+
+    def get(self, user_id: str) -> List[Dict]:
+        return list(self._history[user_id])
+
+    def clear(self, user_id: str) -> None:
+        self._history[user_id] = []
+
+    def summary(self, user_id: str) -> str:
+        history = self.get(user_id)
+        if not history:
+            return "No conversation history."
+        lines = [f"- {m['role']}: {m['content'][:100]}" for m in history[-5:]]
+        return "\\n".join(lines)
+
+# ==============================================================================
+# REPLY HELPER
+# ==============================================================================
+
+async def reply(ctx: Context, sender: str, text: str, end: bool = False) -> None:
+    content = [TextContent(type="text", text=text)]
+    if end:
+        content.append(EndSessionContent(type="end-session"))
     try:
-        client = get_llm_client()
-        response = client.chat.completions.create(
-            model=CONFIG["llm_model"],
-            messages=messages,
-            max_tokens=CONFIG["max_tokens"],
-            temperature=CONFIG["temperature"]
+        await ctx.send(
+            sender,
+            ChatMessage(timestamp=datetime.utcnow(), msg_id=uuid4(), content=content),
         )
-        return response.choices[0].message.content
-
     except Exception as e:
-        return f"I encountered an error: {str(e)}. Please try again."
-
-# =============================================================================
-# RESPONSE HELPERS
-# =============================================================================
-
-async def send_text(ctx: Context, sender: str, msg_id: str, text: str, end: bool = False):
-    """Send a text response, optionally ending the session."""
-    await ctx.send(sender, ChatMessage(
-        timestamp=datetime.now(),
-        msg_id=msg_id,
-        content=[TextContent(text=text)]
-    ))
-    if end:
-        await ctx.send(sender, ChatMessage(
-            timestamp=datetime.now(),
-            msg_id=msg_id,
-            content=[EndSessionContent()]
-        ))
-
-def get_help() -> str:
-    """Return help message."""
-    return f"""# {CONFIG["name"]}
-
-{CONFIG["description"]}
+        ctx.logger.error(f"Failed to send reply: {e}")
 
-**Commands:**
-- \`help\` — Show this message
-- \`clear\` — Clear conversation history
-- \`status\` — Show session info
-
-Just send a message to start chatting!
-"""
+# ==============================================================================
+# MAIN AGENT
+# ==============================================================================
 
-# =============================================================================
-# CHAT HANDLER
-# =============================================================================
+memory = ConversationMemory(max_messages=MEMORY_SIZE)
+agent = Agent()
+chat_proto = Protocol(spec=chat_protocol_spec)
 
 @chat_proto.on_message(ChatMessage)
-async def handle_message(ctx: Context, sender: str, msg: ChatMessage):
-    """Main chat handler with conversation memory."""
-    ctx.logger.info(f"Message from {sender}")
+async def handle_chat(ctx: Context, sender: str, msg: ChatMessage) -> None:
+    # Send acknowledgement
+    try:
+        await ctx.send(
+            sender,
+            ChatAcknowledgement(
+                timestamp=datetime.utcnow(), acknowledged_msg_id=msg.msg_id
+            ),
+        )
+    except Exception as e:
+        ctx.logger.error(f"Failed to send ack: {e}")
 
     # Extract text from message
-    text = ""
-    for content in msg.content:
-        if hasattr(content, "text"):
-            text = content.text.strip()
-            break
+    text = " ".join(
+        item.text for item in msg.content if isinstance(item, TextContent)
+    ).strip()[:2000]
 
     if not text:
-        await send_text(ctx, sender, msg.msg_id, "Please send a text message.", end=True)
+        await reply(ctx, sender, "Please send a message.", end=True)
         return
 
-    ctx.logger.info(f"Query: {text[:100]}")
-
-    # Get session with conversation history
-    session = get_session(ctx, sender)
+    lower = text.lower()
 
-    # Handle commands
-    command = text.lower().split()[0] if text else ""
-
-    if command in {"help", "?", "start", "hello", "hi"}:
-        await send_text(ctx, sender, msg.msg_id, get_help(), end=True)
+    # Help command
+    if lower in ("help", "?"):
+        await reply(
+            ctx,
+            sender,
+            f"**{BUSINESS['name']}** v{BUSINESS['version']}\\n\\n"
+            f"{BUSINESS['description']}\\n\\n"
+            f"Commands: help, history, clear",
+        )
         return
 
-    if command in {"clear", "reset", "new"}:
-        session["history"] = []
-        save_session(ctx, sender, session)
-        await send_text(ctx, sender, msg.msg_id, "Conversation cleared. Starting fresh!", end=True)
+    # History command
+    if lower == "history":
+        summary = memory.summary(sender)
+        await reply(ctx, sender, f"**Recent conversation:**\\n{summary}")
         return
 
-    if command == "status":
-        status = f"""**Session Status**
-- Messages: {session.get('message_count', 0)}
-- History: {len(session.get('history', []))} messages
-- Model: {CONFIG['llm_model']}
-- Provider: {CONFIG['llm_base_url']}
-"""
-        await send_text(ctx, sender, msg.msg_id, status, end=True)
+    # Clear command
+    if lower == "clear":
+        memory.clear(sender)
+        await reply(ctx, sender, "Conversation history cleared.", end=True)
         return
 
-    # Chat with LLM using conversation history
-    response = chat_with_llm(text, session.get("history", []))
+    # Store user message
+    memory.add(sender, "user", text)
 
-    # Save this exchange to history
-    add_to_history(session, "user", text)
-    add_to_history(session, "assistant", response)
-    session["message_count"] = session.get("message_count", 0) + 1
-    save_session(ctx, sender, session)
+    # Get context for response
+    history = memory.get(sender)
+    context_msgs = len(history) - 1  # Exclude current message
 
-    await send_text(ctx, sender, msg.msg_id, response, end=True)
+    # Generate response (customize this!)
+    response = (
+        f"I received your message: '{text[:100]}'\\n\\n"
+        f"I have {context_msgs} previous messages in memory.\\n\\n"
+        f"This is a template — customize the response logic in handle_chat()."
+    )
 
+    # Store assistant response
+    memory.add(sender, "assistant", response[:200])
 
-@chat_proto.on_message(ChatAcknowledgement)
-async def handle_ack(ctx: Context, sender: str, msg: ChatAcknowledgement):
-    """Handle acknowledgements (required by protocol)."""
-    ctx.logger.info(f"Ack from {sender}: {msg.acknowledged_msg_id}")
+    await reply(ctx, sender, response, end=True)
 
+@chat_proto.on_message(ChatAcknowledgement)
+async def handle_ack(ctx: Context, sender: str, msg: ChatAcknowledgement) -> None:
+    ctx.logger.debug(f"Ack from {sender[:20]} for msg {msg.acknowledged_msg_id}")
 
 agent.include(chat_proto, publish_manifest=True)
 

package/dist/templates/chat-memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-memory.js","sourceRoot":"","sources":["../../src/templates/chat-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,mFAAmF;IAChG,QAAQ,EAAE,OAAO;IACjB,SAAS,EAAE;QACT,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,mBAAmB,EAAE;QACxE;YACE,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,uCAAuC;YAChD,WAAW,EAAE,2CAA2C;SACzD;QACD;YACE,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,0DAA0D;YACnE,WAAW,EAAE,kEAAkE;SAChF;QACD;YACE,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,wBAAwB;YACjC,WAAW,EAAE,4DAA4D;SAC1E;QACD;YACE,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,WAAW;YACpB,WAAW,EAAE,kEAAkE;SAChF;QACD;YACE,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,uDAAuD;SACrE;QACD;YACE,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,gCAAgC;SAC9C;QACD;YACE,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,uDAAuD;SACrE;KACF;IACD,YAAY,EAAE,CAAC,QAAQ,CAAC;IACxB,OAAO,EAAE,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC9C,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2NP;CACA,CAAC"}
+{"version":3,"file":"chat-memory.js","sourceRoot":"","sources":["../../src/templates/chat-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,6FAA6F;AAC7F,MAAM,YAAY,GAAG,6BAA6B,CAAC;AACnD,MAAM,WAAW,GAAG,iEAAiE,CAAC;AACtF,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB;IACvD,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,kEAAkE;IAC/E,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE;QACT,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,mBAAmB,EAAE;QACxE;YACE,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,2CAA2C;SACzD;QACD;YACE,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,yCAAyC;SACvD;KACF;IACD,YAAY,EAAE,CAAC,UAAU,CAAC;IAC1B,OAAO,EAAE,CAAC,oBAAoB,EAAE,qBAAqB,EAAE,eAAe,CAAC;IACvE,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uDA+B+C,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4ItE;CACA,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlaunch-templates",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Agent code templates for the AgentLaunch platform",
   "type": "module",
   "main": "dist/index.js",