@0xmaxma/claude-gateway 1.1.4 → 1.1.5

package/README.md

@@ -405,6 +405,17 @@ Pass API key via `X-Api-Key: <key>` or `Authorization: Bearer <key>` header.
 | `POST` | `/api/v1/agents/:agentId/chats/:chatId/sessions/:sessionId/messages` | Inject a message into an existing session |
 | `POST` | `/api/v1/agents/:agentId/media` | Upload a media file (image or PDF) |
 | `GET` | `/api/v1/agents/:agentId/media/*` | Serve a media file by path |
+| `PUT` | `/api/v1/agents/:agentId/avatar` | Upload or replace agent avatar (admin/write) |
+| `DELETE` | `/api/v1/agents/:agentId/avatar` | Remove agent avatar (admin/write) |
+| `GET` | `/api/v1/agents/:agentId/avatar` | Serve agent avatar image |
+| `POST` | `/api/v1/agents/wizard/start` | Start wizard: generate agent workspace via Claude (admin) |
+| `PUT` | `/api/v1/agents/wizard/:wizardId/avatar` | Upload avatar to wizard before confirm (admin) |
+| `POST` | `/api/v1/agents/wizard/:wizardId/confirm` | Write workspace to disk and add agent to config (admin) |
+| `POST` | `/api/v1/agents/wizard/:wizardId/channel` | Verify bot token and generate pairing code (admin) |
+| `POST` | `/api/v1/agents/wizard/:wizardId/channel/verify` | Poll for pairing code confirmation (admin) |
+| `POST` | `/api/v1/agents/wizard/:wizardId/complete` | Skip channel and finalise wizard (admin) |
+
+**Wizard API** — create agents programmatically with the same flow as the interactive `make create-agent` terminal wizard. The wizard generates workspace files via Claude, writes them on confirm, and optionally pairs a Telegram/Discord bot. State is in-memory with a 30-minute TTL; nothing is written until `/confirm`. See [API.md](./API.md) for the full wizard flow.
 
 See **[API.md](./API.md)** for full reference with request/response schemas and curl examples.
 

package/dist/agent/create-agent-prompts.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Prompt templates and output parsers for the create-agent wizard.
+ */
+/**
+ * Build the Claude generation prompt for workspace markdown files.
+ */
+export declare function buildGenerationPrompt(name: string, description: string, options?: {
+    signatureEmoji?: string;
+}): string;
+/**
+ * Parse Claude's generated output into a Map of filename -> content.
+ * Expects sections in the format:
+ *   === filename.md ===
+ *   <content here>
+ */
+export declare function parseGeneratedFiles(output: string): Map<string, string>;
+/**
+ * Build the Claude update prompt for an existing agent.md file.
+ */
+export declare function buildUpdatePrompt(name: string, currentContent: string): string;
+//# sourceMappingURL=create-agent-prompts.d.ts.map

package/dist/agent/create-agent-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent-prompts.d.ts","sourceRoot":"","sources":["../../src/agent/create-agent-prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,MAAM,CAwCR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA4BvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAwB9E"}

package/dist/agent/create-agent-prompts.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Prompt templates and output parsers for the create-agent wizard.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildGenerationPrompt = buildGenerationPrompt;
+exports.parseGeneratedFiles = parseGeneratedFiles;
+exports.buildUpdatePrompt = buildUpdatePrompt;
+/**
+ * Build the Claude generation prompt for workspace markdown files.
+ */
+function buildGenerationPrompt(name, description, options) {
+    const signatureNote = options?.signatureEmoji
+        ? `\nThe agent has a signature emoji: ${options.signatureEmoji}. Include it in the Emoji Usage section as the signature emoji.`
+        : '';
+    // Prevent prompt injection via triple-quote delimiter escape
+    const safeDescription = description.replace(/"""/g, "'''");
+    return `You are helping configure a Claude Code agent for the claude-gateway multi-bot system.
+
+The user described the agent as:
+"""
+${safeDescription}
+"""
+
+Generate workspace markdown files for this agent. Output each file as:
+
+=== AGENTS.md ===
+<content here>
+
+=== SOUL.md ===
+<content here>
+
+Rules:
+- AGENTS.md is REQUIRED. Start with "# Agent: ${name}" on line 1.
+  Include: role, rules, what it can/cannot do, language to use.
+  Always include these rules under ## Rules:
+  "Report completion (mandatory): After finishing any task, ALWAYS send a reply summarising what
+   was done before the session ends. Never silently complete work without reporting the result back
+   to the user."
+  Also include an "## Emoji Usage" section in AGENTS.md with these guidelines:
+    - React to messages naturally — use the react tool. Max 1 reaction per message.
+    - Signature emoji: ${options?.signatureEmoji ? `Use ${options.signatureEmoji} as your signature emoji in greetings or sign-offs.` : 'None assigned.'}${signatureNote}
+- IDENTITY.md (optional): agent name, emoji, avatar, creature, vibe. Omit if not needed.
+- SOUL.md: tone and personality only (not rules). Omit if no distinct style.
+- USER.md: target user profile. Omit if public/unknown.
+- HEARTBEAT.md: only if proactive/scheduled tasks were described. Use YAML tasks format.
+- Keep each file under 500 words.
+- Omit files that are not relevant.
+- IMPORTANT: On the very FIRST line of your output (before any === markers), output a single emoji that best represents this agent's personality or role. Just the emoji alone on line 1, nothing else.`;
+}
+/**
+ * Parse Claude's generated output into a Map of filename -> content.
+ * Expects sections in the format:
+ *   === filename.md ===
+ *   <content here>
+ */
+function parseGeneratedFiles(output) {
+    const files = new Map();
+    // Match sections starting with === filename ===
+    const sectionRegex = /^=== ([^\s=][^=]*?) ===\s*$/gm;
+    const matches = [];
+    let match;
+    while ((match = sectionRegex.exec(output)) !== null) {
+        const headerStart = match.index;
+        const afterHeader = match.index + match[0].length;
+        // Skip the newline immediately after the header line
+        const contentStart = output[afterHeader] === '\n' ? afterHeader + 1 : afterHeader;
+        matches.push({ filename: match[1].trim(), headerStart, contentStart });
+    }
+    for (let i = 0; i < matches.length; i++) {
+        const { filename, contentStart } = matches[i];
+        // Content ends at the start of the next section header (not mid-header)
+        const contentEnd = i + 1 < matches.length ? matches[i + 1].headerStart : output.length;
+        const content = output.slice(contentStart, contentEnd).trimEnd();
+        if (content.length > 0) {
+            files.set(filename, content);
+        }
+    }
+    return files;
+}
+/**
+ * Build the Claude update prompt for an existing agent.md file.
+ */
+function buildUpdatePrompt(name, currentContent) {
+    const safeContent = currentContent.replace(/"""/g, "'''");
+    return `You are updating the agent.md file for a Claude Gateway agent named "${name}".
+
+Current agent.md content:
+"""
+${safeContent}
+"""
+
+Update this agent.md to follow current best practices:
+- Preserve the agent's role, purpose, and all existing rules
+- REMOVE any "Acknowledge first" rule if present — this is now handled at infrastructure level
+- Ensure ## Rules section includes this rule (add if missing, strengthen if weak):
+  "Report completion (mandatory): After finishing any task, ALWAYS send a reply summarising what
+   was done before the session ends. Never silently complete work without reporting the result back
+   to the user."
+- Ensure an "## Emoji Usage" section exists with these guidelines:
+    - React to messages naturally — use the react tool. Max 1 reaction per message.
+    - Signature emoji: preserve any existing signature emoji setting.
+- Remove any mention of "emojiReactionMode" if present
+- Keep the file under 500 words
+
+Output ONLY the updated agent.md content — no preamble, no explanation, no commentary.
+Start directly with the first line of the agent.md content.`;
+}
+//# sourceMappingURL=create-agent-prompts.js.map

package/dist/agent/create-agent-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent-prompts.js","sourceRoot":"","sources":["../../src/agent/create-agent-prompts.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAKH,sDA4CC;AAQD,kDA4BC;AAKD,8CAwBC;AAhHD;;GAEG;AACH,SAAgB,qBAAqB,CACnC,IAAY,EACZ,WAAmB,EACnB,OAAqC;IAErC,MAAM,aAAa,GAAG,OAAO,EAAE,cAAc;QAC3C,CAAC,CAAC,sCAAsC,OAAO,CAAC,cAAc,iEAAiE;QAC/H,CAAC,CAAC,EAAE,CAAC;IAEP,6DAA6D;IAC7D,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE3D,OAAO;;;;EAIP,eAAe;;;;;;;;;;;;gDAY+B,IAAI;;;;;;;;yBAQ3B,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,cAAc,qDAAqD,CAAC,CAAC,CAAC,gBAAgB,GAAG,aAAa;;;;;;;wMAOgC,CAAC;AACzM,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,MAAc;IAChD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,gDAAgD;IAChD,MAAM,YAAY,GAAG,+BAA+B,CAAC;IAErD,MAAM,OAAO,GAA2E,EAAE,CAAC;IAC3F,IAAI,KAA6B,CAAC;IAElC,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC;QAChC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAClD,qDAAqD;QACrD,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAClF,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC9C,wEAAwE;QACxE,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;QACvF,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QAEjE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,IAAY,EAAE,cAAsB;IACpE,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1D,OAAO,wEAAwE,IAAI;;;;EAInF,WAAW;;;;;;;;;;;;;;;;;4DAiB+C,CAAC;AAC7D,CAAC"}

package/dist/api/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/api/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAMpD,OAAO,EAAE,WAAW,EAAkB,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AA0D5D,wBAAgB,eAAe,CAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACtC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACtC,OAAO,EAAE,MAAM,EAAE,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,WAAW,EAAE,GACrB,MAAM,CAsiCR"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/api/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAOpD,OAAO,EAAE,WAAW,EAAkB,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAmL5D,wBAAgB,eAAe,CAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACtC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACtC,OAAO,EAAE,MAAM,EAAE,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,WAAW,EAAE,GACrB,MAAM,CA2iDR"}