beercan 0.4.2 → 0.4.3

package/README.md

@@ -20,6 +20,16 @@ beercan setup
 
 Interactive wizard that configures your API keys, models, and optional integrations (Cloudflare, Telegram, Slack). Creates `~/.beercan/.env`.
 
+## Config
+
+Quick config management without the full setup wizard:
+
+```bash
+beercan config set KEY=VALUE        # Set a config value
+beercan config get KEY              # Get a value (keys masked)
+beercan config list                 # Show all config
+```
+
 ## Quick Start
 
 ```bash
@@ -197,6 +207,35 @@ Three ways to extend BeerCan with tools:
 
 Custom tools are automatically available to all agent roles. No configuration needed.
 
+## Skills
+
+Skills are higher-level than tools — they orchestrate workflows with instructions, triggers, and config. Drop a `.json` file in `~/.beercan/skills/`.
+
+```bash
+beercan skill:create social-post    # Scaffold a skill template
+beercan skill:list                  # List installed skills
+```
+
+Example skill (`~/.beercan/skills/social-post.json`):
+```json
+{
+  "name": "social-post",
+  "description": "Generate and publish social media posts via Mark Supreme",
+  "triggers": ["social media", "twitter", "linkedin", "post to"],
+  "instructions": "1. Call list_social_platforms to check connections\n2. Generate platform-appropriate content\n3. Use upload_post tool to publish",
+  "requiredTools": ["upload_post", "list_social_platforms"],
+  "config": {
+    "UPLOAD_POST_API_URL": "https://api.marksupreme.com/v1",
+    "UPLOAD_POST_API_KEY": "your-key"
+  },
+  "enabled": true
+}
+```
+
+When a bloop goal matches a skill's triggers, the instructions are automatically injected into agent context. Skills + tools work together:
+- **Tools** = atomic API calls (post to Twitter, fetch a URL)
+- **Skills** = workflow recipes (research → generate → post to multiple platforms)
+
 ## Memory System
 
 4-layer hybrid RAG — all in SQLite:
@@ -274,6 +313,13 @@ BeerCan's conversational interface is provider-agnostic:
 
 All providers share the same ChatBridge — slash commands and natural language work everywhere.
 
+### Telegram Quick Setup
+
+1. Message `@BotFather` on Telegram → `/newbot` → get token
+2. `beercan config set BEERCAN_TELEGRAM_TOKEN=your-token`
+3. `beercan stop && beercan start`
+4. Message your bot — Skippy answers!
+
 ## Production Features
 
 - **Crash recovery** — stale "running" jobs auto-recovered on startup
@@ -304,6 +350,11 @@ beercan mcp:add <project> <name> <cmd> [args]
 beercan tool:create <name>              Scaffold a custom tool
 beercan tool:list                       List custom tools
 beercan tool:remove <name>              Remove a custom tool
+beercan skill:create <name>             Scaffold a skill template
+beercan skill:list                      List installed skills
+beercan config set KEY=VALUE            Set a config value
+beercan config get KEY                  Get a config value
+beercan config list                     Show all config
 beercan daemon                              Run scheduler + events
 beercan chat [project]                  Interactive Skippy chat
 beercan serve [port]                    API server (default: 3939)

package/dist/skills/index.d.ts

@@ -16,8 +16,10 @@ export declare class SkillManager {
     private dataDir;
     private skills;
     constructor(dataDir: string);
-    /** Load all skills from ~/.beercan/skills/ */
+    /** Load built-in + user skills */
     load(): void;
+    /** Register built-in skills that are always available */
+    private loadBuiltinSkills;
     /** Get all loaded skills */
     listSkills(): Skill[];
     /** Get enabled skills */

package/dist/skills/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,YAAY;IAGX,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,MAAM,CAA4B;gBAEtB,OAAO,EAAE,MAAM;IAEnC,8CAA8C;IAC9C,IAAI,IAAI,IAAI;IA6BZ,4BAA4B;IAC5B,UAAU,IAAI,KAAK,EAAE;IAIrB,yBAAyB;IACzB,gBAAgB,IAAI,KAAK,EAAE;IAI3B,wDAAwD;IACxD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE;IAOlC,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIzC,4EAA4E;IAC5E,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAuB9C,mCAAmC;IACnC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAkBrC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,YAAY;IAGX,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,MAAM,CAA4B;gBAEtB,OAAO,EAAE,MAAM;IAEnC,kCAAkC;IAClC,IAAI,IAAI,IAAI;IA+BZ,yDAAyD;IACzD,OAAO,CAAC,iBAAiB;IAwEzB,4BAA4B;IAC5B,UAAU,IAAI,KAAK,EAAE;IAIrB,yBAAyB;IACzB,gBAAgB,IAAI,KAAK,EAAE;IAI3B,wDAAwD;IACxD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE;IAOlC,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIzC,4EAA4E;IAC5E,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAuB9C,mCAAmC;IACnC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAkBrC"}

package/dist/skills/index.js

@@ -7,8 +7,9 @@ export class SkillManager {
     constructor(dataDir) {
         this.dataDir = dataDir;
     }
-    /** Load all skills from ~/.beercan/skills/ */
+    /** Load built-in + user skills */
     load() {
+        this.loadBuiltinSkills();
         const skillsDir = path.join(this.dataDir, "skills");
         if (!fs.existsSync(skillsDir))
             return;
@@ -36,6 +37,76 @@ export class SkillManager {
             }
         }
     }
+    /** Register built-in skills that are always available */
+    loadBuiltinSkills() {
+        const toolsDir = path.join(this.dataDir, "tools");
+        const skillsDir = path.join(this.dataDir, "skills");
+        this.skills.set("generate-tool", {
+            name: "generate-tool",
+            description: "Generate a custom tool file for BeerCan agents",
+            triggers: ["create a tool", "generate a tool", "make a tool", "new tool", "build a tool", "add a tool"],
+            instructions: [
+                `When asked to create/generate a custom tool:`,
+                ``,
+                `1. Ask what the tool should do if not clear from the request`,
+                `2. Generate a JavaScript ESM file with this EXACT structure:`,
+                ``,
+                `   export const definition = {`,
+                `     name: "tool_name",  // snake_case, descriptive`,
+                `     description: "What the tool does — agents read this to decide when to use it",`,
+                `     inputSchema: {`,
+                `       type: "object",`,
+                `       properties: { /* input params */ },`,
+                `       required: ["param1"],`,
+                `     },`,
+                `   };`,
+                ``,
+                `   export async function handler({ param1 }) {`,
+                `     // Tool logic — can use fetch(), process.env, etc.`,
+                `     return "string result that the agent sees";`,
+                `   }`,
+                ``,
+                `3. IMPORTANT: Write the file to: ${toolsDir}/<tool_name>.js`,
+                `4. The tool will be auto-loaded on next BeerCan restart`,
+                `5. For multi-tool files, export: export const tools = [{ definition, handler }, ...]`,
+                `6. Tools can access env vars via process.env for API keys`,
+                `7. Always return a string from the handler — that's what the agent sees`,
+            ].join("\n"),
+            requiredTools: ["write_file"],
+            config: {},
+            enabled: true,
+        });
+        this.skills.set("generate-skill", {
+            name: "generate-skill",
+            description: "Generate a skill configuration file for BeerCan",
+            triggers: ["create a skill", "generate a skill", "make a skill", "new skill", "build a skill", "add a skill"],
+            instructions: [
+                `When asked to create/generate a skill:`,
+                ``,
+                `1. Ask what the skill should do if not clear`,
+                `2. Generate a JSON file with this structure:`,
+                ``,
+                `   {`,
+                `     "name": "skill-name",`,
+                `     "description": "What this skill does",`,
+                `     "triggers": ["keyword1", "keyword2"],  // words that activate this skill`,
+                `     "instructions": "Step-by-step instructions for agents...",`,
+                `     "requiredTools": ["tool1", "tool2"],  // tools agents need`,
+                `     "config": { "API_KEY": "value" },  // env vars/config`,
+                `     "enabled": true`,
+                `   }`,
+                ``,
+                `3. IMPORTANT: Write the file to: ${skillsDir}/<skill-name>.json`,
+                `4. The skill will be auto-loaded on next BeerCan restart`,
+                `5. Triggers should be natural language phrases users might say`,
+                `6. Instructions tell agents HOW to accomplish the workflow step by step`,
+                `7. If the skill needs a custom tool, offer to generate that too`,
+            ].join("\n"),
+            requiredTools: ["write_file"],
+            config: {},
+            enabled: true,
+        });
+    }
     /** Get all loaded skills */
     listSkills() {
         return Array.from(this.skills.values());

package/dist/skills/index.js.map

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

package/examples/skills/daily-report.json

@@ -0,0 +1,9 @@
+{
+  "name": "daily-report",
+  "description": "Generate daily summary reports from web sources on a given topic",
+  "triggers": ["daily report", "daily briefing", "daily summary", "news summary", "daily digest"],
+  "instructions": "When generating a daily report:\n1. Use web_fetch to search multiple news sources for the topic\n2. Try at least 3-5 sources (RSS feeds, news sites, blogs)\n3. For each article found: extract title, source, date, and summary\n4. Write a structured markdown report with:\n   - Date/time header\n   - Executive summary (3-5 sentences)\n   - Individual article sections with links\n   - Key takeaways at the end\n5. Save the report as a .md file in the project directory\n6. Store key findings in memory for future reference",
+  "requiredTools": ["web_fetch", "write_file", "memory_store"],
+  "config": {},
+  "enabled": true
+}

package/examples/skills/social-post.json

@@ -0,0 +1,12 @@
+{
+  "name": "social-post",
+  "description": "Generate and publish social media posts via Upload-Post (10 platforms supported)",
+  "triggers": ["social media", "social post", "twitter", "instagram", "tiktok", "linkedin", "reddit", "threads", "facebook", "youtube", "pinterest", "bluesky", "post to", "publish post", "social network", "tweet", "share on"],
+  "instructions": "When asked about social media posting:\n\n1. FIRST, call list_social_platforms to see connected accounts\n   - If not configured: tell user to run:\n     beercan config set UPLOAD_POST_API_KEY=your-key\n     beercan config set UPLOAD_POST_PROFILE=your-nickname\n   - To connect more networks: go to Mark Supreme dashboard → Platforms\n\n2. Supported platforms (10): Twitter/X, Instagram, TikTok, LinkedIn, Reddit, Threads, Facebook, YouTube, Pinterest, Bluesky\n\n3. When creating a post:\n   a. Research the topic using web_fetch if needed\n   b. Generate platform-appropriate content:\n      - Twitter/X: max 280 chars, punchy, 2-3 hashtags\n      - LinkedIn: professional, 1-3 paragraphs\n      - Instagram: visual caption, emojis, 5-10 hashtags\n      - TikTok: casual, trending hashtags\n      - Reddit: needs title + subreddit name\n   c. Use upload_post tool with platforms array: upload_post({ platforms: ['twitter', 'linkedin'], content: '...' })\n   d. Can post to multiple platforms at once\n   e. Store results in memory\n\n4. When asked 'what social networks do we support?': call list_social_platforms",
+  "requiredTools": ["upload_post", "list_social_platforms"],
+  "config": {
+    "UPLOAD_POST_API_KEY": "set-via-beercan-config",
+    "UPLOAD_POST_PROFILE": "set-via-beercan-config"
+  },
+  "enabled": false
+}

package/examples/tools/hello_world.js

@@ -0,0 +1,22 @@
+// BeerCan Custom Tool Example: hello_world
+// This is a minimal example showing how to create a custom tool.
+// Drop .js files in ~/.beercan/tools/ and they're auto-loaded on startup.
+
+export const definition = {
+  name: "hello_world",
+  description: "A simple example tool that echoes back a greeting. Use this as a template for your own tools.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      name: {
+        type: "string",
+        description: "Name to greet",
+      },
+    },
+    required: ["name"],
+  },
+};
+
+export async function handler({ name }) {
+  return `Hello, ${name}! This is a custom BeerCan tool. Modify this handler to do anything you need.`;
+}

package/examples/tools/upload_post.js

@@ -0,0 +1,160 @@
+// BeerCan Custom Tools: Upload-Post Social Media Integration
+// Requires UPLOAD_POST_API_KEY and UPLOAD_POST_PROFILE (nickname).
+// Connect networks at your Mark Supreme dashboard → Platforms section.
+
+const getConfig = () => ({
+  apiUrl: process.env.UPLOAD_POST_API_URL || "https://api.upload-post.com/api",
+  apiKey: process.env.UPLOAD_POST_API_KEY,
+  profile: process.env.UPLOAD_POST_PROFILE,
+  markSupremeUrl: process.env.MARK_SUPREME_URL || "https://app.marksupreme.com",
+});
+
+export const tools = [
+  // ── List Connected Platforms ────────────────────────────
+  {
+    definition: {
+      name: "list_social_platforms",
+      description: "List connected social media platforms from Upload-Post. Shows which networks are available for posting.",
+      inputSchema: {
+        type: "object",
+        properties: {},
+      },
+    },
+    handler: async () => {
+      const { apiUrl, apiKey, profile, markSupremeUrl } = getConfig();
+
+      if (!apiKey) {
+        return [
+          "Upload-Post is not configured yet.",
+          "",
+          "To set up:",
+          `1. Go to ${markSupremeUrl} → Platforms to connect your social networks`,
+          "2. Get your API key from Upload-Post settings",
+          "3. Run these commands:",
+          "   beercan config set UPLOAD_POST_API_KEY=your-key",
+          "   beercan config set UPLOAD_POST_PROFILE=your-nickname",
+        ].join("\n");
+      }
+
+      if (!profile) {
+        return "ERROR: UPLOAD_POST_PROFILE (nickname) not set. Run: beercan config set UPLOAD_POST_PROFILE=your-nickname";
+      }
+
+      try {
+        const response = await fetch(`${apiUrl}/uploadposts/users/${profile}`, {
+          headers: {
+            "Authorization": `ApiKey ${apiKey}`,
+            "Accept": "application/json",
+          },
+        });
+
+        if (!response.ok) {
+          return `ERROR: Upload-Post API returned ${response.status}. Check your API key and profile nickname.`;
+        }
+
+        const data = await response.json();
+        const accounts = data.social_accounts || data.platforms || data.connected || [];
+
+        if (Array.isArray(accounts) && accounts.length === 0) {
+          return [
+            "No social networks connected yet.",
+            "",
+            `Go to ${markSupremeUrl} → Platforms to connect your accounts.`,
+            "",
+            "Supported: Twitter/X, Instagram, TikTok, LinkedIn, Reddit, Threads, Facebook, YouTube, Pinterest, Bluesky",
+          ].join("\n");
+        }
+
+        let result = `Connected platforms for profile "${profile}":\n`;
+        if (Array.isArray(accounts)) {
+          for (const a of accounts) {
+            result += `\n● ${a.platform || a.name} — ${a.username || a.handle || "connected"}`;
+          }
+        } else {
+          result += JSON.stringify(accounts, null, 2);
+        }
+        result += `\n\nManage connections: ${markSupremeUrl}`;
+        return result;
+      } catch (err) {
+        return `Cannot reach Upload-Post API: ${err.message}\nManage connections: ${markSupremeUrl}`;
+      }
+    },
+  },
+
+  // ── Upload Text Post ───────────────────────────────────
+  {
+    definition: {
+      name: "upload_post",
+      description: "Publish a text post to social media via Upload-Post. Supports: twitter/x, instagram, tiktok, linkedin, reddit, threads, facebook, youtube, pinterest, bluesky. Call list_social_platforms first to check connected accounts.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          platforms: {
+            type: "array",
+            items: { type: "string" },
+            description: "Target platforms (e.g., ['twitter', 'linkedin']). Use 'x' or 'twitter' for Twitter.",
+          },
+          content: {
+            type: "string",
+            description: "The post text/description",
+          },
+          title: {
+            type: "string",
+            description: "Optional title (used by Reddit, YouTube, some platforms)",
+          },
+          subreddit: {
+            type: "string",
+            description: "Required for Reddit posts — the subreddit name without r/",
+          },
+        },
+        required: ["platforms", "content"],
+      },
+    },
+    handler: async ({ platforms, content, title, subreddit }) => {
+      const { apiUrl, apiKey, profile } = getConfig();
+
+      if (!apiKey) {
+        return "ERROR: UPLOAD_POST_API_KEY not configured. Run: beercan config set UPLOAD_POST_API_KEY=your-key";
+      }
+      if (!profile) {
+        return "ERROR: UPLOAD_POST_PROFILE not configured. Run: beercan config set UPLOAD_POST_PROFILE=your-nickname";
+      }
+
+      try {
+        const body = new URLSearchParams();
+        body.append("user", profile);
+        body.append("description", content);
+        if (title) body.append("title", title);
+        if (subreddit) body.append("subreddit", subreddit);
+        for (const p of platforms) {
+          body.append("platforms[]", p === "twitter" ? "x" : p);
+        }
+
+        const response = await fetch(`${apiUrl}/upload_text`, {
+          method: "POST",
+          headers: {
+            "Authorization": `ApiKey ${apiKey}`,
+            "Accept": "application/json",
+          },
+          body,
+        });
+
+        if (!response.ok) {
+          const err = await response.text();
+          return `ERROR: Upload-Post returned ${response.status}: ${err}`;
+        }
+
+        const result = await response.json();
+        const platformList = platforms.join(", ");
+
+        if (result.errors && Object.keys(result.errors).length > 0) {
+          return `Partial success posting to ${platformList}:\n${JSON.stringify(result.errors, null, 2)}`;
+        }
+
+        return `Post published to ${platformList}! ${result.id ? "ID: " + result.id : ""}`;
+      } catch (err) {
+        return `ERROR: Failed to publish: ${err.message}`;
+      }
+    },
+  },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beercan",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Autonomous AI agent system — powered by Skippy the Magnificent.",
   "type": "module",
   "main": "dist/index.js",
@@ -11,6 +11,7 @@
   "files": [
     "dist",
     "src/dashboard",
+    "examples",
     "README.md",
     "LICENSE"
   ],