@lawrencehui/citio 0.2.0

package/dist/utils/slack-onboarding.js

@@ -0,0 +1,205 @@
+import https from "node:https";
+import os from "node:os";
+import { execFileSync } from "node:child_process";
+export function buildCitioSlackManifest(options = {}) {
+    const appName = options.appName || "Citio";
+    return {
+        display_information: {
+            name: appName,
+            description: "Slack-native autonomous CTO agent",
+            long_description: "Citio is a self-hosted autonomous CTO agent for Slack. It helps engineering teams investigate bugs, check CloudWatch logs, make safe repository changes, create pull requests, and report progress back into Slack while keeping the control plane and credentials inside your own infrastructure.",
+            background_color: "#1d1c1d",
+        },
+        features: {
+            app_home: {
+                home_tab_enabled: false,
+                messages_tab_enabled: true,
+                messages_tab_read_only_enabled: false,
+            },
+            assistant_view: {
+                assistant_description: "Investigates bugs, checks logs, makes code changes, and opens PRs from Slack.",
+                suggested_prompts: [
+                    {
+                        title: "Investigate a bug",
+                        message: "There is a bug in the login flow. Can you investigate it and suggest a fix?",
+                    },
+                    {
+                        title: "Check deploy health",
+                        message: "Can you check the latest deployment and review the logs for errors?",
+                    },
+                    {
+                        title: "Open a PR",
+                        message: "Can you make the smallest safe fix for this issue and open a PR?",
+                    },
+                ],
+            },
+            bot_user: {
+                display_name: "citio",
+                always_online: false,
+            },
+        },
+        oauth_config: {
+            scopes: {
+                bot: [
+                    "app_mentions:read",
+                    "assistant:write",
+                    "channels:history",
+                    "chat:write",
+                    "groups:history",
+                    "im:history",
+                    "mpim:history",
+                ],
+            },
+        },
+        settings: {
+            event_subscriptions: {
+                bot_events: [
+                    "app_mention",
+                    "message.im",
+                    // Required by the Assistant view (adapters/slack.ts uses Bolt's Assistant):
+                    // without these, Socket Mode never delivers assistant-thread events and
+                    // the assistant pane silently does nothing.
+                    "assistant_thread_started",
+                    "assistant_thread_context_changed",
+                    // Ambient mode: plain messages in the bot's home channel
+                    "message.channels",
+                    "message.groups",
+                ],
+            },
+            interactivity: {
+                is_enabled: true,
+            },
+            org_deploy_enabled: false,
+            socket_mode_enabled: true,
+            token_rotation_enabled: false,
+        },
+    };
+}
+function callSlackApi(method, token, payload) {
+    const body = new URLSearchParams({
+        token,
+        ...payload,
+    }).toString();
+    return new Promise((resolve, reject) => {
+        const req = https.request({
+            method: "POST",
+            hostname: "slack.com",
+            path: `/api/${method}`,
+            headers: {
+                "content-type": "application/x-www-form-urlencoded",
+                "content-length": Buffer.byteLength(body),
+            },
+        }, (res) => {
+            let data = "";
+            res.setEncoding("utf8");
+            res.on("data", (chunk) => {
+                data += chunk;
+            });
+            res.on("end", () => {
+                try {
+                    resolve(JSON.parse(data));
+                }
+                catch (error) {
+                    reject(new Error(`Slack ${method} returned invalid JSON: ${String(error)}`));
+                }
+            });
+        });
+        req.on("error", (error) => {
+            reject(error);
+        });
+        req.write(body);
+        req.end();
+    });
+}
+function formatSlackErrors(response) {
+    if (!response.errors || response.errors.length === 0) {
+        return response.error || "unknown_error";
+    }
+    return response.errors
+        .map((entry) => {
+        const pointer = entry.pointer ? ` (${entry.pointer})` : "";
+        return `${entry.message || "invalid manifest"}${pointer}`;
+    })
+        .join("; ");
+}
+export async function createCitioSlackApp(configToken, options = {}) {
+    const manifest = buildCitioSlackManifest(options);
+    const manifestJson = JSON.stringify(manifest);
+    const validation = await callSlackApi("apps.manifest.validate", configToken, {
+        manifest: manifestJson,
+    });
+    if (!validation.ok) {
+        throw new Error(`Slack manifest validation failed: ${formatSlackErrors(validation)}`);
+    }
+    const created = await callSlackApi("apps.manifest.create", configToken, {
+        manifest: manifestJson,
+    });
+    if (!created.ok || !created.app_id || !created.oauth_authorize_url) {
+        throw new Error(`Slack app creation failed: ${formatSlackErrors(created)}`);
+    }
+    return {
+        appId: created.app_id,
+        oauthAuthorizeUrl: created.oauth_authorize_url,
+        settingsUrl: `https://api.slack.com/apps/${created.app_id}`,
+    };
+}
+export function openBrowser(url) {
+    try {
+        switch (os.platform()) {
+            case "darwin":
+                execFileSync("open", [url], { stdio: "ignore" });
+                return true;
+            case "win32":
+                execFileSync("cmd", ["/c", "start", "", url], { stdio: "ignore" });
+                return true;
+            default:
+                execFileSync("xdg-open", [url], { stdio: "ignore" });
+                return true;
+        }
+    }
+    catch {
+        return false;
+    }
+}
+export function validateSlackBotToken(token) {
+    if (!token) {
+        return "Slack bot token is required.";
+    }
+    if (!token.startsWith("xoxb-")) {
+        return "Slack bot token must start with xoxb-.";
+    }
+    return undefined;
+}
+export function validateSlackAppToken(token) {
+    if (!token) {
+        return "Slack app token is required.";
+    }
+    if (!token.startsWith("xapp-")) {
+        return "Slack app token must start with xapp-.";
+    }
+    return undefined;
+}
+export function validateSlackConfigToken(token) {
+    if (!token) {
+        return "Slack config token is required.";
+    }
+    if (!token.startsWith("xoxe")) {
+        return "Slack config token should start with xoxe.";
+    }
+    return undefined;
+}
+/** Live-check a saved bot token via auth.test. Returns workspace/bot identity when valid. */
+export async function testSlackBotToken(token) {
+    try {
+        const res = await callSlackApi("auth.test", token, {});
+        if (res.ok) {
+            const r = res;
+            return { ok: true, team: r.team, botUser: r.user };
+        }
+        return { ok: false };
+    }
+    catch {
+        return { ok: false };
+    }
+}
+//# sourceMappingURL=slack-onboarding.js.map

package/dist/utils/slack-onboarding.js.map

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

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@lawrencehui/citio",
+  "version": "0.2.0",
+  "description": "Self-hosted AI coding agents that live in Slack \u2014 run Claude Code or Codex in your own infra, ship PRs, and keep every credential behind a controlled MCP tool layer.",
+  "keywords": [
+    "slack",
+    "ai-agent",
+    "claude-code",
+    "codex",
+    "mcp",
+    "devops",
+    "self-hosted",
+    "aws-ecs",
+    "coding-agent"
+  ],
+  "homepage": "https://github.com/lawrencehui/Citio#readme",
+  "bugs": {
+    "url": "https://github.com/lawrencehui/Citio/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lawrencehui/Citio.git"
+  },
+  "license": "MIT",
+  "author": "Lawrence Hui <hkc.lawrence@gmail.com>",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "citio": "./dist/cli/init.js"
+  },
+  "files": [
+    "dist",
+    "Dockerfile",
+    ".dockerignore",
+    "citio.example.yaml"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc && chmod +x dist/cli/init.js",
+    "init": "tsx src/cli/init.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx --test test/**/*.test.ts",
+    "prepublishOnly": "npm run build",
+    "status": "tsx src/cli/init.ts status",
+    "destroy": "tsx src/cli/init.ts destroy",
+    "manifest": "tsx src/cli/init.ts manifest"
+  },
+  "dependencies": {
+    "@aws-sdk/client-ec2": "^3.1019.0",
+    "@aws-sdk/client-ecr": "^3.1019.0",
+    "@aws-sdk/client-ecs": "^3.1019.0",
+    "@aws-sdk/client-efs": "^3.1019.0",
+    "@aws-sdk/client-iam": "^3.1019.0",
+    "@aws-sdk/client-sts": "^3.1019.0",
+    "@clack/prompts": "^1.1.0",
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "@slack/bolt": "^4.6.0",
+    "dotenv": "^17.3.1",
+    "keytar": "^7.9.0",
+    "picocolors": "^1.1.1",
+    "yaml": "^2.8.3",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2"
+  }
+}