agentlaunch-templates 0.1.0

package/dist/generator.d.ts

@@ -0,0 +1,43 @@
+/**
+ * generator.ts — Variable substitution engine for @agent-launch/templates
+ *
+ * Takes a template name + variable map and returns the generated files
+ * ready to be written to disk or returned over the MCP protocol.
+ */
+export interface GenerateResult {
+    /** The generated agent.py source code */
+    code: string;
+    /** A quickstart README.md for the generated project */
+    readme: string;
+    /** A .env.example file listing all required secrets */
+    envExample: string;
+}
+export interface GenerateOptions {
+    /** Variable values to inject into the template */
+    variables: Record<string, string>;
+    /**
+     * When true, missing required variables throw an error.
+     * When false (default for MCP/preview use), they are left as-is.
+     */
+    strict?: boolean;
+}
+/**
+ * Generates agent files from a named template with variable substitution.
+ *
+ * @param templateName - The template slug (e.g. "price-monitor")
+ * @param variables    - Key-value pairs for `{{variable}}` placeholders
+ * @param options      - Generation options (strict mode, etc.)
+ * @returns An object containing `code`, `readme`, and `envExample` strings
+ * @throws  If the template is not found, or if `strict` is true and required
+ *          variables are missing
+ *
+ * @example
+ * const result = generateFromTemplate("price-monitor", {
+ *   agent_name: "MyPriceBot",
+ *   token_address: "0xabc...",
+ *   alert_threshold: "10",
+ * });
+ * fs.writeFileSync("agent.py", result.code);
+ */
+export declare function generateFromTemplate(templateName: string, variables: Record<string, string>, options?: GenerateOptions): GenerateResult;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAsMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,OAAO,GAAE,eAAmC,GAC3C,cAAc,CAiBhB"}

package/dist/generator.js

@@ -0,0 +1,213 @@
+/**
+ * generator.ts — Variable substitution engine for @agent-launch/templates
+ *
+ * Takes a template name + variable map and returns the generated files
+ * ready to be written to disk or returned over the MCP protocol.
+ */
+import { getTemplate } from "./registry.js";
+// ---------------------------------------------------------------------------
+// Core substitution
+// ---------------------------------------------------------------------------
+/**
+ * Replaces all `{{variable}}` placeholders in `text` with values from `vars`.
+ * Unknown placeholders are left untouched so callers can detect them.
+ */
+function substitute(text, vars) {
+    return text.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+        return Object.prototype.hasOwnProperty.call(vars, key) ? vars[key] : match;
+    });
+}
+/**
+ * Merges caller-supplied variables with template defaults.
+ * Required variables with no value will remain as empty string unless `strict` is true.
+ */
+function resolveVariables(templateVars, supplied, strict) {
+    const resolved = {};
+    for (const v of templateVars) {
+        if (Object.prototype.hasOwnProperty.call(supplied, v.name) && supplied[v.name] !== "") {
+            resolved[v.name] = supplied[v.name];
+        }
+        else if (v.default !== undefined) {
+            resolved[v.name] = v.default;
+        }
+        else if (v.required) {
+            if (strict) {
+                throw new Error(`Required variable "${v.name}" was not provided for template.`);
+            }
+            // Leave the placeholder so the caller can see it is missing
+            resolved[v.name] = `{{${v.name}}}`;
+        }
+        else {
+            resolved[v.name] = "";
+        }
+    }
+    // Pass through any extra caller-supplied variables not declared in the template
+    for (const [k, val] of Object.entries(supplied)) {
+        if (!Object.prototype.hasOwnProperty.call(resolved, k)) {
+            resolved[k] = val;
+        }
+    }
+    return resolved;
+}
+// ---------------------------------------------------------------------------
+// README generator
+// ---------------------------------------------------------------------------
+function buildReadme(template, vars) {
+    const name = vars["agent_name"] || template.name;
+    const description = vars["description"] || template.description;
+    const deps = template.dependencies.join(" ");
+    const secretsList = template.secrets
+        .map((s) => `- \`${s}\``)
+        .join("\n");
+    return `# ${name}
+
+${description}
+
+Generated from the **${template.name}** template by \`agentlaunch scaffold\`.
+
+## Quickstart
+
+### 1. Install dependencies
+
+\`\`\`bash
+pip install uagents uagents-core ${deps}
+\`\`\`
+
+### 2. Configure environment
+
+\`\`\`bash
+cp .env.example .env
+# Edit .env and fill in the required values
+\`\`\`
+
+### 3. Customize your agent
+
+Open \`agent.py\` and edit the business logic class to add your own value exchange.
+
+### 4. Run locally
+
+\`\`\`bash
+source .env && python agent.py
+\`\`\`
+
+### 5. Deploy to Agentverse
+
+\`\`\`bash
+agentlaunch deploy
+\`\`\`
+
+This uploads \`agent.py\` to Agentverse, sets secrets, and starts the agent.
+
+### 6. Tokenize your agent
+
+\`\`\`bash
+agentlaunch tokenize \\
+  --agent <address> \\
+  --name "${name}" \\
+  --symbol "${name.slice(0, 4).toUpperCase()}"
+\`\`\`
+
+You will receive a handoff link. Share it with a human to complete on-chain deployment.
+
+## Required Secrets
+
+${secretsList}
+
+## Platform Constants
+
+- Deploy fee: **120 FET** (read dynamically from contract)
+- Graduation target: **30,000 FET** — auto DEX listing
+- Trading fee: **2%** — 100% to protocol treasury (no creator fee)
+
+## Key Commands
+
+| Command | Description |
+|---------|-------------|
+| \`agentlaunch config show\` | Show current config |
+| \`agentlaunch deploy\` | Deploy agent.py to Agentverse |
+| \`agentlaunch tokenize\` | Create a token record + handoff link |
+
+## Resources
+
+- [AgentLaunch Platform](https://agent-launch.ai)
+- [Agentverse](https://agentverse.ai)
+- [skill.md](https://agent-launch.ai/skill.md)
+- [API docs](https://agent-launch.ai/docs/openapi)
+`;
+}
+// ---------------------------------------------------------------------------
+// .env.example generator
+// ---------------------------------------------------------------------------
+function buildEnvExample(template, vars) {
+    const name = vars["agent_name"] || template.name;
+    const lines = [
+        `# ${name} — Environment Variables`,
+        `# Copy to .env and fill in real values. Never commit .env to version control.`,
+        ``,
+        `# Your Agentverse API key (https://agentverse.ai/profile/api-keys)`,
+        `AGENTVERSE_API_KEY=`,
+        ``,
+        `# Your AgentLaunch API key (same as Agentverse key in most cases)`,
+        `AGENTLAUNCH_API_KEY=`,
+        ``,
+        `# The address of this agent on Agentverse (set after first deploy)`,
+        `AGENT_ADDRESS=`,
+        ``,
+        `# The wallet address that owns this agent (for owner-gated commands)`,
+        `AGENT_OWNER_ADDRESS=`,
+        ``,
+        `# Optional: override the API base URL (default: https://agent-launch.ai/api)`,
+        `# AGENTLAUNCH_API=https://agent-launch.ai/api`,
+    ];
+    // Add template-specific secrets that are not in the base set
+    const baseSecrets = new Set([
+        "AGENTVERSE_API_KEY",
+        "AGENTLAUNCH_API_KEY",
+        "AGENT_ADDRESS",
+        "AGENT_OWNER_ADDRESS",
+    ]);
+    const extraSecrets = template.secrets.filter((s) => !baseSecrets.has(s));
+    if (extraSecrets.length > 0) {
+        lines.push(``);
+        lines.push(`# Template-specific secrets`);
+        for (const secret of extraSecrets) {
+            lines.push(`${secret}=`);
+        }
+    }
+    return lines.join("\n") + "\n";
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Generates agent files from a named template with variable substitution.
+ *
+ * @param templateName - The template slug (e.g. "price-monitor")
+ * @param variables    - Key-value pairs for `{{variable}}` placeholders
+ * @param options      - Generation options (strict mode, etc.)
+ * @returns An object containing `code`, `readme`, and `envExample` strings
+ * @throws  If the template is not found, or if `strict` is true and required
+ *          variables are missing
+ *
+ * @example
+ * const result = generateFromTemplate("price-monitor", {
+ *   agent_name: "MyPriceBot",
+ *   token_address: "0xabc...",
+ *   alert_threshold: "10",
+ * });
+ * fs.writeFileSync("agent.py", result.code);
+ */
+export function generateFromTemplate(templateName, variables, options = { variables: {} }) {
+    const template = getTemplate(templateName);
+    if (!template) {
+        const available = ["custom", "price-monitor", "trading-bot", "data-analyzer", "research", "gifter"];
+        throw new Error(`Template "${templateName}" not found. Available templates: ${available.join(", ")}`);
+    }
+    const strict = options.strict ?? false;
+    const resolved = resolveVariables(template.variables, variables, strict);
+    const code = substitute(template.code, resolved);
+    const readme = buildReadme(template, resolved);
+    const envExample = buildEnvExample(template, resolved);
+    return { code, readme, envExample };
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @agent-launch/templates
+ *
+ * Agent code templates for the AgentLaunch platform.
+ *
+ * Provides six ready-to-use Python agent templates built on:
+ *   - Agentverse Chat Protocol v0.3.0
+ *   - uAgents Agent() zero-param init
+ *   - ctx.logger structured logging
+ *   - Rate limiting, health monitoring, token-gated tiers
+ *   - agent-launch.ai/api integration
+ *
+ * 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)
+ *
+ * @example
+ * import { listTemplates, getTemplate, generateFromTemplate } from "@agent-launch/templates";
+ *
+ * // List all available templates
+ * const templates = listTemplates();
+ * console.log(templates.map(t => t.name));
+ * // ["custom", "price-monitor", "trading-bot", "data-analyzer", "research", "gifter"]
+ *
+ * // Get metadata for a specific template
+ * const tpl = getTemplate("price-monitor");
+ * console.log(tpl?.variables);
+ *
+ * // Generate files from a template
+ * const { code, readme, envExample } = generateFromTemplate("price-monitor", {
+ *   agent_name: "MyPriceWatcher",
+ *   token_address: "0xabc123...",
+ *   alert_threshold: "10",
+ * });
+ */
+export type { AgentTemplate, TemplateVariable } from "./registry.js";
+export { listTemplates, getTemplate } from "./registry.js";
+export type { GenerateResult, GenerateOptions } from "./generator.js";
+export { generateFromTemplate } from "./generator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG3D,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+/**
+ * @agent-launch/templates
+ *
+ * Agent code templates for the AgentLaunch platform.
+ *
+ * Provides six ready-to-use Python agent templates built on:
+ *   - Agentverse Chat Protocol v0.3.0
+ *   - uAgents Agent() zero-param init
+ *   - ctx.logger structured logging
+ *   - Rate limiting, health monitoring, token-gated tiers
+ *   - agent-launch.ai/api integration
+ *
+ * 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)
+ *
+ * @example
+ * import { listTemplates, getTemplate, generateFromTemplate } from "@agent-launch/templates";
+ *
+ * // List all available templates
+ * const templates = listTemplates();
+ * console.log(templates.map(t => t.name));
+ * // ["custom", "price-monitor", "trading-bot", "data-analyzer", "research", "gifter"]
+ *
+ * // Get metadata for a specific template
+ * const tpl = getTemplate("price-monitor");
+ * console.log(tpl?.variables);
+ *
+ * // Generate files from a template
+ * const { code, readme, envExample } = generateFromTemplate("price-monitor", {
+ *   agent_name: "MyPriceWatcher",
+ *   token_address: "0xabc123...",
+ *   alert_threshold: "10",
+ * });
+ */
+export { listTemplates, getTemplate } from "./registry.js";
+export { generateFromTemplate } from "./generator.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAIH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * registry.ts — Template registry for @agent-launch/templates
+ *
+ * All templates are imported here and exposed via listTemplates() / getTemplate().
+ * Add new templates by:
+ *   1. Creating src/templates/<name>.ts exporting `template: AgentTemplate`
+ *   2. Importing and adding to TEMPLATES below
+ */
+export interface TemplateVariable {
+    /** Variable name used as {{name}} placeholder in the template code */
+    name: string;
+    /** Whether this variable must be supplied by the caller (default: false) */
+    required?: boolean;
+    /** Default value used when caller does not provide the variable */
+    default?: string;
+    /** Human-readable description shown in CLI help and MCP prompts */
+    description: string;
+}
+export interface AgentTemplate {
+    /** Unique slug used to look up the template — e.g. "price-monitor" */
+    name: string;
+    /** One-line description shown in listings */
+    description: string;
+    /** Category label for grouping — e.g. "AI/ML", "Finance", "Infrastructure" */
+    category: string;
+    /** Variables that will be substituted into the template code */
+    variables: TemplateVariable[];
+    /** Python package names required by the generated agent.py */
+    dependencies: string[];
+    /** Environment variable names that must be set as Agentverse secrets */
+    secrets: string[];
+    /** The Python source code with {{variable}} placeholders */
+    code: string;
+}
+/**
+ * Returns a copy of the full template registry.
+ * Safe to mutate — the original array is not exposed.
+ */
+export declare function listTemplates(): AgentTemplate[];
+/**
+ * Looks up a template by its `name` slug.
+ * Returns `undefined` if no template with that name exists.
+ *
+ * @example
+ * const tpl = getTemplate("price-monitor");
+ * if (!tpl) throw new Error("Template not found");
+ */
+export declare function getTemplate(name: string): AgentTemplate | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,8DAA8D;IAC9D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wEAAwE;IACxE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,aAAa,EAAE,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEnE"}

package/dist/registry.js

@@ -0,0 +1,47 @@
+/**
+ * registry.ts — Template registry for @agent-launch/templates
+ *
+ * All templates are imported here and exposed via listTemplates() / getTemplate().
+ * Add new templates by:
+ *   1. Creating src/templates/<name>.ts exporting `template: AgentTemplate`
+ *   2. Importing and adding to TEMPLATES below
+ */
+import { template as customTemplate } from "./templates/custom.js";
+import { template as priceMonitorTemplate } from "./templates/price-monitor.js";
+import { template as tradingBotTemplate } from "./templates/trading-bot.js";
+import { template as dataAnalyzerTemplate } from "./templates/data-analyzer.js";
+import { template as researchTemplate } from "./templates/research.js";
+import { template as gifterTemplate } from "./templates/gifter.js";
+// ---------------------------------------------------------------------------
+// Internal registry
+// ---------------------------------------------------------------------------
+const TEMPLATES = [
+    customTemplate,
+    priceMonitorTemplate,
+    tradingBotTemplate,
+    dataAnalyzerTemplate,
+    researchTemplate,
+    gifterTemplate,
+];
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Returns a copy of the full template registry.
+ * Safe to mutate — the original array is not exposed.
+ */
+export function listTemplates() {
+    return [...TEMPLATES];
+}
+/**
+ * Looks up a template by its `name` slug.
+ * Returns `undefined` if no template with that name exists.
+ *
+ * @example
+ * const tpl = getTemplate("price-monitor");
+ * if (!tpl) throw new Error("Template not found");
+ */
+export function getTemplate(name) {
+    return TEMPLATES.find((t) => t.name === name);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAkCnE,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,SAAS,GAAoB;IACjC,cAAc;IACd,oBAAoB;IACpB,kBAAkB;IAClB,oBAAoB;IACpB,gBAAgB;IAChB,cAAc;CACf,CAAC;AAEF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/dist/templates/custom.d.ts

@@ -0,0 +1,11 @@
+/**
+ * custom.ts — Blank boilerplate template with Chat Protocol
+ *
+ * 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;
+//# sourceMappingURL=custom.d.ts.map

package/dist/templates/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/templates/custom.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,eAAO,MAAM,QAAQ,EAAE,aAgctB,CAAC"}