@songsid/agend 0.0.1

package/dist/instructions.js

@@ -0,0 +1,90 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+export function buildFleetInstructions(params) {
+    const { instanceName, workingDirectory, displayName, description, customPrompt } = params;
+    const sections = [];
+    // ── Identity ──
+    sections.push(`# AgEnD Fleet Context\nYou are **${instanceName}**, an instance in an AgEnD fleet.\nYour working directory is \`${workingDirectory}\`.`);
+    if (displayName) {
+        sections.push(`Your display name is "${displayName}". Use this when introducing yourself.`);
+    }
+    else {
+        sections.push("You don't have a display name yet. Use set_display_name to choose one that reflects your personality.");
+    }
+    if (description) {
+        sections.push(`## Role\n${description}`);
+    }
+    // ── Message format & tool usage ──
+    if (params.cliInstructions) {
+        // CLI mode: inject CLI quick reference
+        sections.push(params.cliInstructions);
+    }
+    else {
+        // MCP mode: inject MCP tool usage instructions
+        sections.push([
+            "## Message Format",
+            "- `[user:name]` — from a Telegram/Discord user → reply with the `reply` tool.",
+            "- `[from:instance-name]` — from another fleet instance → reply with `send_to_instance`, NOT the reply tool.",
+            "",
+            "**Always use the `reply` tool for ALL responses to users.** Do not respond directly in the terminal.",
+            "",
+            "## Tool Usage",
+            "- reply: respond to users. react: emoji reactions. edit_message: update a sent message. download_attachment: fetch files.",
+            "- If the inbound message has image_path, Read that file — it is a photo.",
+            "- If the inbound message has attachment_file_id, call download_attachment then Read the returned path.",
+            "- If the inbound message has reply_to_text, the user is quoting a previous message.",
+            "- Use list_instances to discover fleet members. Use describe_instance for details.",
+            "- High-level collaboration: request_information (ask), delegate_task (assign), report_result (return results with correlation_id).",
+            "",
+            "## Collaboration Rules",
+            "1. Use fleet tools for cross-instance communication. Never assume direct file access to another instance's repo.",
+            "2. Cross-instance messages appear as `[from:instance-name]`. Reply via send_to_instance or report_result, NOT reply.",
+            "3. Use list_instances to discover available instances before sending messages.",
+            "4. You only have direct access to files under your own working directory.",
+            "5. Task flow: `delegate_task` → silent work → `report_result`. Zero messages in between. Never send ack/confirmation.",
+        ].join("\n"));
+    }
+    // ── Workflow template ──
+    if (params.workflow !== false) {
+        let workflowContent = null;
+        if (params.workflow) {
+            workflowContent = params.workflow;
+        }
+        else {
+            try {
+                const here = dirname(fileURLToPath(import.meta.url));
+                workflowContent = readFileSync(join(here, "workflow-templates/default.md"), "utf-8");
+            }
+            catch { /* template not found — skip */ }
+        }
+        if (workflowContent) {
+            const trimmed = workflowContent.trim();
+            if (trimmed.startsWith("#")) {
+                sections.push(trimmed);
+            }
+            else {
+                sections.push(`## Development Workflow\n\n${trimmed}`);
+            }
+        }
+    }
+    // ── Active decisions ──
+    const decisions = params.decisions;
+    if (decisions && decisions.length > 0) {
+        const MAX = 15;
+        const lines = decisions.slice(0, MAX).map(d => {
+            const firstLine = (d.content ?? "").split(/[.\n]/)[0].trim().slice(0, 120);
+            return `- **${d.title}**: ${firstLine}`;
+        });
+        if (decisions.length > MAX) {
+            lines.push(`- *(${decisions.length - MAX} more — use \`list_decisions\` to see all)*`);
+        }
+        sections.push(`## Active Decisions\n\n${lines.join("\n")}`);
+    }
+    // ── Custom user prompt ──
+    if (customPrompt) {
+        sections.push(customPrompt);
+    }
+    return sections.join("\n\n");
+}
+//# sourceMappingURL=instructions.js.map

package/dist/instructions.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,7 @@
+import pino from "pino";
+/** Truncate log to tail when it exceeds MAX_LOG_SIZE (no rotation/backup files) */
+export declare function truncateLogIfNeeded(logPath: string): void;
+/** Rotate a log file: foo.log → foo.log.1 → foo.log.2 → foo.log.3 (deleted) */
+export declare function rotateLogIfNeeded(logPath: string, maxSize?: number, maxFiles?: number): void;
+export declare function createLogger(level?: string): pino.Logger<never, boolean>;
+export type Logger = ReturnType<typeof createLogger>;

package/dist/logger.js

@@ -0,0 +1,84 @@
+import pino from "pino";
+import { join } from "node:path";
+import { mkdirSync, statSync, readFileSync, writeFileSync, renameSync, unlinkSync, existsSync } from "node:fs";
+import { getAgendHome } from "./paths.js";
+const DATA_DIR = getAgendHome();
+const LOG_FILE = join(DATA_DIR, "daemon.log");
+const MAX_LOG_SIZE = 10 * 1024 * 1024; // 10 MB
+const TRUNCATE_TO = 5 * 1024 * 1024; // keep last 5 MB
+const ROTATE_MAX_FILES = 3;
+/** Truncate log to tail when it exceeds MAX_LOG_SIZE (no rotation/backup files) */
+export function truncateLogIfNeeded(logPath) {
+    try {
+        const stat = statSync(logPath);
+        if (stat.size < MAX_LOG_SIZE)
+            return;
+        const buf = readFileSync(logPath);
+        const tail = buf.subarray(buf.length - TRUNCATE_TO);
+        const nl = tail.indexOf(0x0a);
+        writeFileSync(logPath, nl >= 0 ? tail.subarray(nl + 1) : tail);
+    }
+    catch { /* file may not exist yet */ }
+}
+/** Rotate a log file: foo.log → foo.log.1 → foo.log.2 → foo.log.3 (deleted) */
+export function rotateLogIfNeeded(logPath, maxSize = MAX_LOG_SIZE, maxFiles = ROTATE_MAX_FILES) {
+    try {
+        if (!existsSync(logPath))
+            return;
+        const stat = statSync(logPath);
+        if (stat.size < maxSize)
+            return;
+        // Shift existing rotated files
+        for (let i = maxFiles; i >= 1; i--) {
+            const src = i === 1 ? logPath : `${logPath}.${i - 1}`;
+            const dst = `${logPath}.${i}`;
+            if (i === maxFiles) {
+                try {
+                    unlinkSync(dst);
+                }
+                catch { }
+            }
+            if (existsSync(src)) {
+                try {
+                    renameSync(src, dst);
+                }
+                catch { }
+            }
+        }
+        // Truncate current log
+        writeFileSync(logPath, "");
+    }
+    catch { /* best effort */ }
+}
+export function createLogger(level = "info") {
+    mkdirSync(DATA_DIR, { recursive: true });
+    truncateLogIfNeeded(LOG_FILE);
+    return pino({
+        level,
+        transport: {
+            targets: [
+                {
+                    target: "pino-pretty",
+                    options: {
+                        destination: 1,
+                        colorize: true,
+                        translateTime: "SYS:HH:MM:ss",
+                        ignore: "pid,hostname",
+                    },
+                    level,
+                },
+                {
+                    target: "pino-pretty",
+                    options: {
+                        destination: LOG_FILE,
+                        colorize: false,
+                        translateTime: "SYS:HH:MM:ss",
+                        ignore: "pid,hostname",
+                    },
+                    level,
+                },
+            ],
+        },
+    });
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/outbound-handlers.d.ts

@@ -0,0 +1,51 @@
+import type { FleetConfig, InstanceConfig } from "./types.js";
+import type { ChannelAdapter } from "./channel/types.js";
+import type { IpcClient } from "./channel/ipc-bridge.js";
+import type { Logger } from "./logger.js";
+import type { RoutingEngine } from "./routing-engine.js";
+import type { InstanceLifecycle } from "./instance-lifecycle.js";
+import type { EventLog } from "./event-log.js";
+/** Shared context available to all outbound tool handlers. */
+export interface OutboundContext {
+    readonly fleetConfig: FleetConfig | null;
+    readonly adapter: ChannelAdapter | null;
+    readonly adapters?: Map<string, ChannelAdapter>;
+    readonly logger: Logger;
+    readonly routing: RoutingEngine;
+    readonly instanceIpcClients: Map<string, IpcClient>;
+    readonly lifecycle: InstanceLifecycle;
+    readonly sessionRegistry: Map<string, string>;
+    readonly eventLog: EventLog | null;
+    readonly classicChannels: {
+        getAll(): {
+            instanceName: string;
+            name: string;
+            backend?: string;
+            channelId: string;
+        }[];
+    } | null;
+    lastActivityMs(name: string): number;
+    startInstance(name: string, config: InstanceConfig, topicMode: boolean): Promise<void>;
+    restartSingleInstance(name: string): Promise<void>;
+    connectIpcToInstance(name: string): Promise<void>;
+    saveFleetConfig(): void;
+    queueMirrorMessage?(text: string): void;
+    getAdapterForInstance?(name: string): ChannelAdapter | null;
+    getChannelConfig?(adapterId?: string): import("./types.js").ChannelConfig | undefined;
+    getGroupIdForInstance?(name: string): string;
+    getWorldForInstance?(name: string): {
+        id: string;
+        adapter: ChannelAdapter;
+    } | undefined;
+}
+/** Metadata extracted from the raw outbound message. */
+export interface OutboundMeta {
+    instanceName: string;
+    requestId: number | undefined;
+    fleetRequestId: string | undefined;
+    senderSessionName: string | undefined;
+}
+type Respond = (result: unknown, error?: string) => void;
+type Handler = (ctx: OutboundContext, args: Record<string, unknown>, respond: Respond, meta: OutboundMeta) => Promise<void> | void;
+export declare const outboundHandlers: Map<string, Handler>;
+export {};