@suzuke/agend 0.0.1 → 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,153 @@
+export interface ContextStatus {
+    used_percentage: number;
+    remaining_percentage: number;
+    context_window_size: number;
+}
+export interface StatusLineData {
+    session_id: string;
+    model: {
+        id: string;
+        display_name: string;
+    };
+    context_window: {
+        total_input_tokens: number;
+        total_output_tokens: number;
+        context_window_size: number;
+        current_usage: number | null;
+        used_percentage: number | null;
+        remaining_percentage: number | null;
+    };
+    cost: {
+        total_cost_usd: number;
+        total_duration_ms: number;
+    };
+    rate_limits?: {
+        five_hour: {
+            used_percentage: number;
+            resets_at: string;
+        };
+        seven_day: {
+            used_percentage: number;
+            resets_at: string;
+        };
+    };
+}
+export interface AccessConfig {
+    mode: "pairing" | "locked";
+    allowed_users: number[];
+    max_pending_codes: number;
+    code_expiry_minutes: number;
+}
+export interface CostGuardConfig {
+    daily_limit_usd: number;
+    warn_at_percentage: number;
+    timezone: string;
+}
+export interface HangDetectorConfig {
+    enabled: boolean;
+    timeout_minutes: number;
+}
+export interface DailySummaryConfig {
+    enabled: boolean;
+    hour: number;
+    minute: number;
+}
+export interface ChannelConfig {
+    type: string;
+    mode: "topic";
+    bot_token_env: string;
+    group_id?: number;
+    access: AccessConfig;
+    options?: Record<string, unknown>;
+}
+export interface InstanceConfig {
+    working_directory: string;
+    /** Human-readable description of what this instance does */
+    description?: string;
+    /** Tags for capability discovery (e.g. ["code-reviewer", "researcher", "executor"]) */
+    tags?: string[];
+    topic_id?: number;
+    general_topic?: boolean;
+    restart_policy: {
+        max_retries: number;
+        backoff: "exponential" | "linear";
+        reset_after: number;
+    };
+    context_guardian: {
+        grace_period_ms: number;
+        max_age_hours: number;
+    };
+    log_level: "debug" | "info" | "warn" | "error";
+    /** CLI backend to use. Default: "claude-code" */
+    backend?: string;
+    /** Skip non-essential subsystems (transcript monitor, context guardian, approval server, prompt detector) */
+    lightweight?: boolean;
+    /** System prompt for the Claude instance */
+    systemPrompt?: string;
+    /** Skip permission checks (dangerously-skip-permissions) */
+    skipPermissions?: boolean;
+    /** Claude model to use (e.g. "sonnet", "opus", "haiku", or full model ID) */
+    model?: string;
+    /** Ordered fallback models when primary hits rate limit (e.g. ["opus", "sonnet"]) */
+    model_failover?: string[];
+    /** Per-instance cost guard (overrides fleet defaults) */
+    cost_guard?: CostGuardConfig;
+    /** Original repo path when this instance uses a git worktree */
+    worktree_source?: string;
+}
+export interface WebhookConfig {
+    url: string;
+    events: string[];
+    headers?: Record<string, string>;
+}
+export interface FleetDefaults extends Partial<InstanceConfig> {
+    scheduler?: {
+        max_schedules?: number;
+        default_timezone?: string;
+        retry_count?: number;
+        retry_interval_ms?: number;
+    };
+    cost_guard?: CostGuardConfig;
+    hang_detector?: HangDetectorConfig;
+    daily_summary?: DailySummaryConfig;
+    webhooks?: WebhookConfig[];
+}
+export type RotationSnapshotEvent = {
+    type: "tool_use";
+    name: string;
+    preview?: string;
+} | {
+    type: "tool_result";
+    name: string;
+    preview?: string;
+} | {
+    type: "assistant_text";
+    preview: string;
+};
+export interface RotationSnapshot {
+    instance: string;
+    reason: string;
+    created_at: string;
+    working_directory: string;
+    session_id?: string | null;
+    context_pct?: number | null;
+    recent_user_messages?: Array<{
+        text: string;
+        ts: string;
+    }>;
+    recent_events?: RotationSnapshotEvent[];
+    recent_tool_activity?: string[];
+    last_statusline?: {
+        model?: string;
+        cost_usd?: number;
+        five_hour_pct?: number;
+        seven_day_pct?: number;
+    };
+}
+export interface FleetConfig {
+    channel?: ChannelConfig;
+    project_roots?: string[];
+    defaults: FleetDefaults;
+    instances: Record<string, InstanceConfig>;
+    health_port?: number;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/webhook-emitter.d.ts

@@ -0,0 +1,15 @@
+import type { WebhookConfig } from "./types.js";
+import type { Logger } from "./logger.js";
+export interface WebhookPayload {
+    event: string;
+    instance: string;
+    timestamp: string;
+    data: Record<string, unknown>;
+}
+export declare class WebhookEmitter {
+    private configs;
+    private logger;
+    constructor(configs: WebhookConfig[], logger: Logger);
+    emit(event: string, instance: string, data?: Record<string, unknown>): void;
+    private post;
+}

package/dist/webhook-emitter.js

@@ -0,0 +1,41 @@
+export class WebhookEmitter {
+    configs;
+    logger;
+    constructor(configs, logger) {
+        this.configs = configs;
+        this.logger = logger;
+    }
+    emit(event, instance, data = {}) {
+        const payload = {
+            event,
+            instance,
+            timestamp: new Date().toISOString(),
+            data,
+        };
+        for (const config of this.configs) {
+            if (config.events.includes("*") || config.events.includes(event)) {
+                this.post(config, payload);
+            }
+        }
+    }
+    post(config, payload, retry = true) {
+        const headers = {
+            "Content-Type": "application/json",
+            ...config.headers,
+        };
+        fetch(config.url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(5000),
+        }).catch((err) => {
+            if (retry) {
+                setTimeout(() => this.post(config, payload, false), 1000);
+            }
+            else {
+                this.logger.warn({ err, url: config.url, event: payload.event }, "Webhook POST failed");
+            }
+        });
+    }
+}
+//# sourceMappingURL=webhook-emitter.js.map

package/dist/webhook-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-emitter.js","sourceRoot":"","sources":["../src/webhook-emitter.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,cAAc;IAEf;IACA;IAFV,YACU,OAAwB,EACxB,MAAc;QADd,YAAO,GAAP,OAAO,CAAiB;QACxB,WAAM,GAAN,MAAM,CAAQ;IACrB,CAAC;IAEJ,IAAI,CAAC,KAAa,EAAE,QAAgB,EAAE,OAAgC,EAAE;QACtE,MAAM,OAAO,GAAmB;YAC9B,KAAK;YACL,QAAQ;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,IAAI;SACL,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,MAAqB,EAAE,OAAuB,EAAE,KAAK,GAAG,IAAI;QACvE,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,GAAG,MAAM,CAAC,OAAO;SAClB,CAAC;QAEF,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE;YAChB,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC7B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACf,IAAI,KAAK,EAAE,CAAC;gBACV,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;YAC5D,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,qBAAqB,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/package.json

@@ -1,11 +1,67 @@
 {
   "name": "@suzuke/agend",
-  "version": "0.0.1",
-  "description": "AgEnD - Agent End",
-  "main": "index.js",
+  "version": "1.0.0",
+  "description": "Multi-agent fleet daemon — run any coding CLI (Claude, Gemini, Codex, OpenCode) from Telegram",
+  "type": "module",
+  "bin": {
+    "agend": "./dist/cli.js",
+    "ccd": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "cp -r src/plugin dist/ && cd dist/plugin/agend && ln -sf ../../channel/mcp-server.js server.js",
+    "start": "tsx src/cli.ts start",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/suzuke/AgEnD.git"
+    "url": "https://github.com/suzuke/agend.git"
+  },
+  "keywords": [
+    "agend",
+    "agent",
+    "fleet",
+    "telegram",
+    "claude",
+    "gemini",
+    "codex",
+    "opencode",
+    "multi-agent",
+    "daemon"
+  ],
+  "files": [
+    "dist/",
+    "templates/",
+    "README.md",
+    "README.zh-TW.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "better-sqlite3": "^12.8.0",
+    "commander": "^14.0.3",
+    "croner": "^10.0.1",
+    "discord.js": "^14.25.1",
+    "ejs": "^5.0.1",
+    "grammy": "^1.41.1",
+    "js-yaml": "^4.1.1",
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/ejs": "^3.1.5",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
   }
 }

package/templates/launchd.plist.ejs

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string><%= label %></string>
+    <key>ProgramArguments</key>
+    <array>
+        <string><%= execPath %></string>
+        <string>fleet</string>
+        <string>start</string>
+    </array>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string><%= path %></string>
+    </dict>
+    <key>WorkingDirectory</key>
+    <string><%= workingDirectory %></string>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string><%= logPath %></string>
+    <key>StandardErrorPath</key>
+    <string><%= logPath %></string>
+</dict>
+</plist>

package/templates/systemd.service.ejs

@@ -0,0 +1,15 @@
+[Unit]
+Description=Claude Channel Daemon
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=<%= execPath %> fleet start
+Environment=PATH=<%= path %>
+WorkingDirectory=<%= workingDirectory %>
+Restart=no
+StandardOutput=append:<%= logPath %>
+StandardError=append:<%= logPath %>
+
+[Install]
+WantedBy=default.target

package/index.js

@@ -1 +0,0 @@
-// AgEnD - Agent End