@trikhub/cli 0.17.0 → 0.17.1-dev.1

package/dist/lib/validator.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @deprecated Use @trikhub/linter instead.
+ *
+ * v1 validator removed in P1. All validation now through @trikhub/linter.
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export declare function validateTrik(_trikPath: string): ValidationResult;
+export declare function formatValidationResult(result: ValidationResult): string;
+//# sourceMappingURL=validator.d.ts.map

package/dist/lib/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/lib/validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAEhE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAEvE"}

package/dist/lib/validator.js

@@ -0,0 +1,12 @@
+/**
+ * @deprecated Use @trikhub/linter instead.
+ *
+ * v1 validator removed in P1. All validation now through @trikhub/linter.
+ */
+export function validateTrik(_trikPath) {
+    return { valid: true, errors: [], warnings: [] };
+}
+export function formatValidationResult(result) {
+    return result.valid ? 'Validation passed' : 'Validation failed';
+}
+//# sourceMappingURL=validator.js.map

package/dist/lib/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/lib/validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAwB;IAC7D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC;AAClE,CAAC"}

package/dist/templates/agent-python.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-python.d.ts","sourceRoot":"","sources":["../../src/templates/agent-python.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AA0L/D;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAW5F"}
+{"version":3,"file":"agent-python.d.ts","sourceRoot":"","sources":["../../src/templates/agent-python.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AA+X/D;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgB5F"}

package/dist/templates/agent-python.js

@@ -47,13 +47,17 @@ dependencies = [
     "langchain-core>=0.3.0",
     "langgraph>=0.2.0",
     "trikhub>=0.6.0",
-    "python-dotenv>=1.0.0",
+    "python-dotenv>=1.0.0",${config.channels === 'cli+telegram' ? `\n    "python-telegram-bot>=21.0",` : ''}
 ]
 `;
 }
 function generateEnvExample(config) {
     const provider = PROVIDERS[config.provider];
-    return `${provider.envVar}=your-api-key-here\n`;
+    let env = `${provider.envVar}=your-api-key-here\n`;
+    if (config.channels === 'cli+telegram') {
+        env += `TELEGRAM_BOT_TOKEN=your-token-from-botfather\n`;
+    }
+    return env;
 }
 function generateGitignore() {
     return `__pycache__/
@@ -77,32 +81,35 @@ from __future__ import annotations
 from ${provider.importPath} import ${provider.className}
 from langgraph.prebuilt import create_react_agent
 
-from trikhub.gateway import TrikGateway
-from trikhub.langchain import enhance, get_handoff_tools_for_agent, get_exposed_tools_for_agent
+from trikhub.langchain import enhance, EnhanceOptions
+
+SYSTEM_PROMPT = """You are a helpful agent spawned by Trikhub. A user has installed you and you are ready to install Triks to help them with various tasks. You can call any tools provided by the installed Triks to assist the user.
+Feel free to propose a few starting Triks that the user should use to test out your capabilitites:
+- @molefas/trikster: The first Trik anyone should have. This allows you to install other Triks, which will expand your capabilities with new tools and handoffs.
+- @molefas/site-builder: A Demo Trik for building websites. It's meant to showcase how Triks can generate files and execute commands in a safe environment (docker container). With this Trik, you can build a static website by describing it to the agent, which will generate the necessary HTML/CSS/JS files and even run a local server for you to preview it.
+- @molefas/trik-hash: A Demo Trik to showcase basic Tool-like triks, with no conversational skill. It provides a simple hashing tool that can hash any input with various algorithms (md5, sha256, etc). It's a great starting point to understand how to call tools from your agent.
+- @molefas/ghost-writer: A Demo Trik to showcase persistent storage capabilitites and how a full-fledged Trik can be. It also exposes a web interface for users to interact with their data.
+
+Other useful tips:
+- Users can do trik list to see installed triks and trik search <query> to find new ones.
+- Users can refer to the Trikhub documentation at https://docs.trikhub.com for more details on how to use and create triks.
+- If you've chosen the Telegram installation, check the readme for instructions on how to interact with your agent via Telegram.
 
-SYSTEM_PROMPT = """You are a helpful assistant.
 When a trik can handle the user's request, use the appropriate tool."""
 
 
 async def initialize_agent():
     model = ${provider.className}(model="${provider.defaultModel}")
 
-    gateway = TrikGateway()
-    await gateway.initialize()
-    await gateway.load_triks_from_config()
-
-    handoff_tools = get_handoff_tools_for_agent(gateway)
-    exposed_tools = get_exposed_tools_for_agent(gateway)
-
-    agent = create_react_agent(
-        model=model,
-        tools=[*handoff_tools, *exposed_tools],
-        prompt=SYSTEM_PROMPT,
-    )
-
-    app = await enhance(agent, gateway_instance=gateway)
+    app = await enhance(None, EnhanceOptions(
+        create_agent=lambda trik_tools: create_react_agent(
+            model=model,
+            tools=list(trik_tools),
+            prompt=SYSTEM_PROMPT,
+        ),
+    ))
 
-    return app, handoff_tools, exposed_tools
+    return app
 `;
 }
 function generateCliPy() {
@@ -123,13 +130,13 @@ from agent import initialize_agent
 async def main() -> None:
     print("Loading agent...\\n")
 
-    app, handoff_tools, exposed_tools = await initialize_agent()
+    app = await initialize_agent()
 
-    if handoff_tools:
-        print(f"Handoff triks: {', '.join(t.name for t in handoff_tools)}")
-    if exposed_tools:
-        print(f"Tool-mode triks: {', '.join(t.name for t in exposed_tools)}")
-    print('Type "/back" to return from a trik handoff, "exit" to quit.\\n')
+    loaded_triks = app.get_loaded_triks()
+    if loaded_triks:
+        print(f"Loaded triks: {', '.join(loaded_triks)}")
+    print('Type "/back" to return from a trik handoff, "exit" to quit.')
+    print('Tip: Ask the Agent what to do next\\n')
 
     session_id = f"cli-{id(app)}"
 
@@ -164,6 +171,188 @@ if __name__ == "__main__":
     asyncio.run(main())
 `;
 }
+function generateTelegramPy() {
+    return `#!/usr/bin/env python3
+"""Telegram bot for the TrikHub-powered agent."""
+
+from __future__ import annotations
+
+import asyncio
+import logging
+import os
+import time
+
+from dotenv import load_dotenv
+
+load_dotenv()
+
+from telegram import Update
+from telegram.ext import Application, MessageHandler, filters, ContextTypes
+
+from agent import initialize_agent
+
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
+
+
+async def main() -> None:
+    print("Loading agent...\\n")
+
+    app = await initialize_agent()
+
+    loaded_triks = app.get_loaded_triks()
+    if loaded_triks:
+        print(f"Loaded triks: {', '.join(loaded_triks)}")
+
+    token = os.environ.get("TELEGRAM_BOT_TOKEN")
+    if not token:
+        print("TELEGRAM_BOT_TOKEN is not set in .env")
+        raise SystemExit(1)
+
+    session_id = f"telegram-{int(time.time())}"
+
+    async def handle_message(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
+        if not update.message or not update.message.text:
+            return
+        try:
+            result = await app.process_message(update.message.text, session_id)
+            await update.message.reply_text(result.message)
+        except Exception as e:
+            logger.error("Error processing message: %s", e)
+            await update.message.reply_text("Something went wrong. Please try again.")
+
+    application = Application.builder().token(token).build()
+    application.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, handle_message))
+
+    print("\\nTelegram bot started! Send a message to your bot.\\n")
+    await application.run_polling()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+`;
+}
+function generateReadme(config) {
+    const provider = PROVIDERS[config.provider];
+    const hasTelegram = config.channels === 'cli+telegram';
+    let readme = `# ${config.name}
+
+An AI agent powered by [TrikHub](https://trikhub.com). This agent uses **${provider.className}** and can be extended with triks — composable capabilities that plug into your agent.
+
+## What can this agent do?
+
+Out of the box, your agent is a general-purpose assistant. Its real power comes from **triks** — install them to give your agent new capabilities:
+
+\`\`\`bash
+# Browse and search available triks
+trik search <query>
+
+# Install a trik
+trik install @scope/trik-name
+\`\`\`
+
+Triks come in two flavors:
+- **Handoff triks** — take over the conversation for a specialized task (e.g. a coding assistant, a travel planner). Use \`/back\` to return.
+- **Tool triks** — appear as native tools the agent can call (e.g. web search, calculator).
+
+## Setup
+
+\`\`\`bash
+python -m venv .venv
+source .venv/bin/activate  # Windows: .venv\\Scripts\\activate
+pip install -e .
+cp .env.example .env
+\`\`\`
+
+Add your **${provider.envVar}** to \`.env\`.
+`;
+    if (hasTelegram) {
+        readme += `
+### Telegram Bot Token
+
+To run the Telegram bot, you need a bot token:
+
+1. Open Telegram and message [@BotFather](https://t.me/BotFather)
+2. Send \`/newbot\`
+3. Choose a display name (e.g. "${config.name}")
+4. Choose a username (must end in \`bot\`, e.g. \`${config.name.replace(/-/g, '_')}_bot\`)
+5. Copy the token into \`.env\` as \`TELEGRAM_BOT_TOKEN\`
+`;
+    }
+    readme += `
+## Running
+
+### CLI mode
+
+\`\`\`bash
+python cli.py
+\`\`\`
+
+Chat with your agent in the terminal. Type \`/back\` to return from a trik handoff, \`exit\` to quit.
+`;
+    if (hasTelegram) {
+        readme += `
+### Telegram mode
+
+\`\`\`bash
+python telegram_bot.py
+\`\`\`
+
+Your agent runs as a Telegram bot. Open Telegram, find your bot by username, and start chatting.
+
+## Keeping your bot running
+
+The Telegram bot needs to stay running to receive messages. Here are a few options:
+
+### pm2 (Recommended)
+
+\`\`\`bash
+npm install -g pm2
+pm2 start python --name "${config.name}" -- telegram_bot.py
+pm2 save
+pm2 startup  # auto-start on boot
+\`\`\`
+
+### Docker
+
+\`\`\`dockerfile
+FROM python:3.12-slim
+WORKDIR /app
+COPY pyproject.toml .
+COPY *.py .
+RUN pip install .
+CMD ["python", "telegram_bot.py"]
+\`\`\`
+
+### systemd (Linux VPS)
+
+\`\`\`ini
+[Unit]
+Description=${config.name} Telegram bot
+After=network.target
+
+[Service]
+ExecStart=/home/user/${config.name}/.venv/bin/python /home/user/${config.name}/telegram_bot.py
+WorkingDirectory=/home/user/${config.name}
+Restart=always
+EnvironmentFile=/home/user/${config.name}/.env
+
+[Install]
+WantedBy=multi-user.target
+\`\`\`
+`;
+    }
+    readme += `
+## Installing triks
+
+\`\`\`bash
+trik install @scope/trik-name
+\`\`\`
+
+Installed triks are saved to \`.trikhub/config.json\` and loaded automatically when your agent starts.
+`;
+    return readme;
+}
 // ============================================================================
 // Public API
 // ============================================================================
@@ -178,8 +367,12 @@ export function generateAgentPythonProject(config) {
     files['.env.example'] = generateEnvExample(config);
     files['.gitignore'] = generateGitignore();
     files['.trikhub/config.json'] = generateTrikhubConfig();
+    files['README.md'] = generateReadme(config);
     files['agent.py'] = generateAgentPy(config);
     files['cli.py'] = generateCliPy();
+    if (config.channels === 'cli+telegram') {
+        files['telegram_bot.py'] = generateTelegramPy();
+    }
     return files;
 }
 //# sourceMappingURL=agent-python.js.map

package/dist/templates/agent-python.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-python.js","sourceRoot":"","sources":["../../src/templates/agent-python.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,MAAM,SAAS,GAAiC;IAC9C,MAAM,EAAE;QACN,UAAU,EAAE,kBAAkB;QAC9B,SAAS,EAAE,YAAY;QACvB,UAAU,EAAE,kBAAkB;QAC9B,YAAY,EAAE,aAAa;QAC3B,MAAM,EAAE,gBAAgB;KACzB;IACD,SAAS,EAAE;QACT,UAAU,EAAE,qBAAqB;QACjC,SAAS,EAAE,eAAe;QAC1B,UAAU,EAAE,qBAAqB;QACjC,YAAY,EAAE,0BAA0B;QACxC,MAAM,EAAE,mBAAmB;KAC5B;IACD,MAAM,EAAE;QACN,UAAU,EAAE,wBAAwB;QACpC,SAAS,EAAE,wBAAwB;QACnC,UAAU,EAAE,wBAAwB;QACpC,YAAY,EAAE,kBAAkB;QAChC,MAAM,EAAE,gBAAgB;KACzB;CACF,CAAC;AAEF,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,SAAS,qBAAqB,CAAC,MAAyB;IACtD,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO;;;;;UAKC,MAAM,CAAC,IAAI;;;;;;OAMd,QAAQ,CAAC,UAAU;;;;;;CAMzB,CAAC;AACF,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAyB;IACnD,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,GAAG,QAAQ,CAAC,MAAM,sBAAsB,CAAC;AAClD,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO;;;;;;;CAOR,CAAC;AACF,CAAC;AAED,SAAS,qBAAqB;IAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,eAAe,CAAC,MAAyB;IAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO;;;;OAIF,QAAQ,CAAC,UAAU,WAAW,QAAQ,CAAC,SAAS;;;;;;;;;;;cAWzC,QAAQ,CAAC,SAAS,WAAW,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;CAkB/D,CAAC;AACF,CAAC;AAED,SAAS,aAAa;IACpB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDR,CAAC;AACF,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAyB;IAClE,MAAM,KAAK,GAA2B,EAAE,CAAC;IAEzC,KAAK,CAAC,gBAAgB,CAAC,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACxD,KAAK,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACnD,KAAK,CAAC,YAAY,CAAC,GAAG,iBAAiB,EAAE,CAAC;IAC1C,KAAK,CAAC,sBAAsB,CAAC,GAAG,qBAAqB,EAAE,CAAC;IACxD,KAAK,CAAC,UAAU,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,CAAC,QAAQ,CAAC,GAAG,aAAa,EAAE,CAAC;IAElC,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"agent-python.js","sourceRoot":"","sources":["../../src/templates/agent-python.ts"],"names":[],"mappings":"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"}

package/dist/templates/agent-typescript.d.ts

@@ -8,6 +8,7 @@
 export interface CreateAgentConfig {
     name: string;
     provider: 'openai' | 'anthropic' | 'google';
+    channels?: 'cli' | 'cli+telegram';
 }
 /**
  * Generate a complete TypeScript agent project ready to consume triks.

package/dist/templates/agent-typescript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-typescript.d.ts","sourceRoot":"","sources":["../../src/templates/agent-typescript.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC7C;AA+MD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYhG"}
+{"version":3,"file":"agent-typescript.d.ts","sourceRoot":"","sources":["../../src/templates/agent-typescript.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC5C,QAAQ,CAAC,EAAE,KAAK,GAAG,cAAc,CAAC;CACnC;AA8YD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBhG"}

package/dist/templates/agent-typescript.js

@@ -33,22 +33,31 @@ const PROVIDERS = {
 // ============================================================================
 function generatePackageJson(config) {
     const provider = PROVIDERS[config.provider];
+    const hasTelegram = config.channels === 'cli+telegram';
+    const scripts = {
+        dev: 'node --import tsx src/cli.ts',
+        build: 'tsc',
+    };
+    if (hasTelegram) {
+        scripts.telegram = 'node --import tsx src/telegram.ts';
+    }
+    const dependencies = {
+        [provider.npmPackage]: '^1.0.0',
+        '@langchain/core': '^1.0.0',
+        '@langchain/langgraph': '^1.0.0',
+        '@trikhub/gateway': 'latest',
+        dotenv: '^16.4.0',
+    };
+    if (hasTelegram) {
+        dependencies.grammy = '^1.0.0';
+    }
     const pkg = {
         name: config.name,
         version: '0.1.0',
         description: 'AI agent powered by TrikHub',
         type: 'module',
-        scripts: {
-            dev: 'node --import tsx src/cli.ts',
-            build: 'tsc',
-        },
-        dependencies: {
-            [provider.npmPackage]: '^1.0.0',
-            '@langchain/core': '^1.0.0',
-            '@langchain/langgraph': '^1.0.0',
-            '@trikhub/gateway': 'latest',
-            dotenv: '^16.4.0',
-        },
+        scripts,
+        dependencies,
         devDependencies: {
             tsx: '^4.19.0',
             typescript: '^5.7.0',
@@ -76,7 +85,11 @@ function generateTsConfig() {
 }
 function generateEnvExample(config) {
     const provider = PROVIDERS[config.provider];
-    return `${provider.envVar}=your-api-key-here\n`;
+    let env = `${provider.envVar}=your-api-key-here\n`;
+    if (config.channels === 'cli+telegram') {
+        env += `TELEGRAM_BOT_TOKEN=your-token-from-botfather\n`;
+    }
+    return env;
 }
 function generateGitignore() {
     return `node_modules/
@@ -94,31 +107,35 @@ function generateAgentTs(config) {
     const modelParam = config.provider === 'anthropic' ? 'modelName' : 'model';
     return `import { ${provider.className} } from '${provider.importPath}';
 import { createReactAgent } from '@langchain/langgraph/prebuilt';
-import { TrikGateway } from '@trikhub/gateway';
-import { enhance, getHandoffToolsForAgent, getExposedToolsForAgent } from '@trikhub/gateway/langchain';
+import { enhance } from '@trikhub/gateway/langchain';
+
+const SYSTEM_PROMPT = \`You are a helpful agent spawned by Trikhub. A user has installed you and you are ready to install Triks to help them with various tasks. You can call any tools provided by the installed Triks to assist the user.
+Feel free to propose a few starting Triks that the user should use to test out your capabilitites:
+- @molefas/trikster: The first Trik anyone should have. This allows you to install other Triks, which will expand your capabilities with new tools and handoffs.
+- @molefas/site-builder: A Demo Trik for building websites. It's meant to showcase how Triks can generate files and execute commands in a safe environment (docker container). With this Trik, you can build a static website by describing it to the agent, which will generate the necessary HTML/CSS/JS files and even run a local server for you to preview it.
+- @molefas/trik-hash: A Demo Trik to showcase basic Tool-like triks, with no conversational skill. It provides a simple hashing tool that can hash any input with various algorithms (md5, sha256, etc). It's a great starting point to understand how to call tools from your agent.
+- @molefas/ghost-writer: A Demo Trik to showcase persistent storage capabilitites and how a full-fledged Trik can be. It also exposes a web interface for users to interact with their data.
+
+Other useful tips:
+- Users can do trik list to see installed triks and trik search <query> to find new ones.
+- Users can refer to the Trikhub documentation at https://docs.trikhub.com for more details on how to use and create triks.
+- If you've chosen the Telegram installation, check the readme for instructions on how to interact with your agent via Telegram.
 
-const SYSTEM_PROMPT = \`You are a helpful assistant.
 When a trik can handle the user's request, use the appropriate tool.\`;
 
 export async function initializeAgent() {
   const model = new ${provider.className}({ ${modelParam}: '${provider.defaultModel}' });
 
-  const gateway = new TrikGateway();
-  await gateway.initialize();
-  await gateway.loadTriksFromConfig();
-
-  const handoffTools = getHandoffToolsForAgent(gateway);
-  const exposedTools = getExposedToolsForAgent(gateway);
-
-  const agent = createReactAgent({
-    llm: model,
-    tools: [...handoffTools, ...exposedTools] as any,
-    messageModifier: SYSTEM_PROMPT,
+  const app = await enhance(null, {
+    createAgent: (trikTools) =>
+      createReactAgent({
+        llm: model,
+        tools: [...trikTools] as any,
+        messageModifier: SYSTEM_PROMPT,
+      }),
   });
 
-  const app = await enhance(agent as any, { gatewayInstance: gateway });
-
-  return { app, handoffTools, exposedTools };
+  return app;
 }
 `;
 }
@@ -141,15 +158,14 @@ function prompt(question: string): Promise<string> {
 async function main() {
   console.log('Loading agent...\\n');
 
-  const { app, handoffTools, exposedTools } = await initializeAgent();
+  const app = await initializeAgent();
 
-  if (handoffTools.length > 0) {
-    console.log(\`Handoff triks: \${handoffTools.map((t) => t.name).join(', ')}\`);
-  }
-  if (exposedTools.length > 0) {
-    console.log(\`Tool-mode triks: \${exposedTools.map((t) => t.name).join(', ')}\`);
+  const loadedTriks = app.getLoadedTriks();
+  if (loadedTriks.length > 0) {
+    console.log(\`Loaded triks: \${loadedTriks.join(', ')}\`);
   }
-  console.log('Type "/back" to return from a trik handoff, "exit" to quit.\\n');
+  console.log('Type "/back" to return from a trik handoff, "exit" to quit.');
+  console.log('Tip: Ask the Agent what to do next\\n');
 
   const sessionId = \`cli-\${Date.now()}\`;
 
@@ -187,6 +203,170 @@ main().catch((error) => {
 });
 `;
 }
+function generateTelegramTs() {
+    return `import 'dotenv/config';
+import { Bot } from 'grammy';
+import { initializeAgent } from './agent.js';
+
+async function main() {
+  console.log('Loading agent...\\n');
+
+  const app = await initializeAgent();
+
+  const loadedTriks = app.getLoadedTriks();
+  if (loadedTriks.length > 0) {
+    console.log(\`Loaded triks: \${loadedTriks.join(', ')}\`);
+  }
+
+  const token = process.env.TELEGRAM_BOT_TOKEN;
+  if (!token) {
+    console.error('TELEGRAM_BOT_TOKEN is not set in .env');
+    process.exit(1);
+  }
+
+  const bot = new Bot(token);
+  const sessionId = \`telegram-\${Date.now()}\`;
+
+  bot.on('message:text', async (ctx) => {
+    try {
+      const result = await app.processMessage(ctx.message.text, sessionId);
+      await ctx.reply(result.message);
+    } catch (error) {
+      console.error('Error processing message:', error);
+      await ctx.reply('Something went wrong. Please try again.');
+    }
+  });
+
+  bot.catch((err) => {
+    console.error('Bot error:', err);
+  });
+
+  console.log('\\nTelegram bot started! Send a message to your bot.\\n');
+  bot.start();
+}
+
+main().catch(console.error);
+`;
+}
+function generateReadme(config) {
+    const provider = PROVIDERS[config.provider];
+    const hasTelegram = config.channels === 'cli+telegram';
+    let readme = `# ${config.name}
+
+An AI agent powered by [TrikHub](https://trikhub.com). This agent uses **${provider.className}** and can be extended with triks — composable capabilities that plug into your agent.
+
+## What can this agent do?
+
+Out of the box, your agent is a general-purpose assistant. Its real power comes from **triks** — install them to give your agent new capabilities:
+
+\`\`\`bash
+# Browse and search available triks
+trik search <query>
+
+# Install a trik
+trik install @scope/trik-name
+\`\`\`
+
+Triks come in two flavors:
+- **Handoff triks** — take over the conversation for a specialized task (e.g. a coding assistant, a travel planner). Use \`/back\` to return.
+- **Tool triks** — appear as native tools the agent can call (e.g. web search, calculator).
+
+## Setup
+
+\`\`\`bash
+cp .env.example .env
+\`\`\`
+
+Add your **${provider.envVar}** to \`.env\`.
+`;
+    if (hasTelegram) {
+        readme += `
+### Telegram Bot Token
+
+To run the Telegram bot, you need a bot token:
+
+1. Open Telegram and message [@BotFather](https://t.me/BotFather)
+2. Send \`/newbot\`
+3. Choose a display name (e.g. "${config.name}")
+4. Choose a username (must end in \`bot\`, e.g. \`${config.name.replace(/-/g, '_')}_bot\`)
+5. Copy the token into \`.env\` as \`TELEGRAM_BOT_TOKEN\`
+`;
+    }
+    readme += `
+## Running
+
+### CLI mode
+
+\`\`\`bash
+npm run dev
+\`\`\`
+
+Chat with your agent in the terminal. Type \`/back\` to return from a trik handoff, \`exit\` to quit.
+`;
+    if (hasTelegram) {
+        readme += `
+### Telegram mode
+
+\`\`\`bash
+npm run telegram
+\`\`\`
+
+Your agent runs as a Telegram bot. Open Telegram, find your bot by username, and start chatting.
+
+## Keeping your bot running
+
+The Telegram bot needs to stay running to receive messages. Here are a few options:
+
+### pm2 (Recommended)
+
+\`\`\`bash
+npm install -g pm2
+pm2 start npm --name "${config.name}" -- run telegram
+pm2 save
+pm2 startup  # auto-start on boot
+\`\`\`
+
+### Docker
+
+\`\`\`dockerfile
+FROM node:22-slim
+WORKDIR /app
+COPY package.json package-lock.json ./
+RUN npm install --production
+COPY . .
+RUN npm run build
+CMD ["node", "dist/telegram.js"]
+\`\`\`
+
+### systemd (Linux VPS)
+
+\`\`\`ini
+[Unit]
+Description=${config.name} Telegram bot
+After=network.target
+
+[Service]
+ExecStart=/usr/bin/node /home/user/${config.name}/dist/telegram.js
+WorkingDirectory=/home/user/${config.name}
+Restart=always
+EnvironmentFile=/home/user/${config.name}/.env
+
+[Install]
+WantedBy=multi-user.target
+\`\`\`
+`;
+    }
+    readme += `
+## Installing triks
+
+\`\`\`bash
+trik install @scope/trik-name
+\`\`\`
+
+Installed triks are saved to \`.trikhub/config.json\` and loaded automatically when your agent starts.
+`;
+    return readme;
+}
 // ============================================================================
 // Public API
 // ============================================================================
@@ -202,8 +382,12 @@ export function generateAgentTypescriptProject(config) {
     files['.env.example'] = generateEnvExample(config);
     files['.gitignore'] = generateGitignore();
     files['.trikhub/config.json'] = generateTrikhubConfig();
+    files['README.md'] = generateReadme(config);
     files['src/agent.ts'] = generateAgentTs(config);
     files['src/cli.ts'] = generateCliTs();
+    if (config.channels === 'cli+telegram') {
+        files['src/telegram.ts'] = generateTelegramTs();
+    }
     return files;
 }
 //# sourceMappingURL=agent-typescript.js.map