@songsid/agend 0.0.1

package/dist/hang-detector.js

@@ -0,0 +1,53 @@
+import { EventEmitter } from "node:events";
+export class HangDetector extends EventEmitter {
+    lastActivityTs = 0;
+    lastStatuslineTs = 0;
+    lastInboundTs = 0;
+    hungEmitted = false;
+    checkTimer = null;
+    timeoutMs;
+    constructor(timeoutMinutes) {
+        super();
+        this.timeoutMs = timeoutMinutes * 60 * 1000;
+    }
+    recordActivity() {
+        this.lastActivityTs = Date.now();
+        if (this.hungEmitted) {
+            this.hungEmitted = false;
+        }
+    }
+    recordInbound() {
+        this.lastInboundTs = Date.now();
+    }
+    recordStatuslineUpdate() {
+        this.lastStatuslineTs = Date.now();
+    }
+    isHung() {
+        if (this.lastActivityTs === 0)
+            return false;
+        // Only detect hangs when the instance recently received a message
+        if (this.lastInboundTs === 0)
+            return false;
+        const now = Date.now();
+        if (now - this.lastInboundTs > this.timeoutMs * 2)
+            return false; // idle, not hung
+        const transcriptStale = now - this.lastActivityTs > this.timeoutMs;
+        const statuslineStale = this.lastStatuslineTs === 0 || now - this.lastStatuslineTs > this.timeoutMs;
+        return transcriptStale && statuslineStale;
+    }
+    start(intervalMs = 60_000) {
+        this.checkTimer = setInterval(() => {
+            if (this.isHung() && !this.hungEmitted) {
+                this.hungEmitted = true;
+                this.emit("hang");
+            }
+        }, intervalMs);
+    }
+    stop() {
+        if (this.checkTimer) {
+            clearInterval(this.checkTimer);
+            this.checkTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=hang-detector.js.map

package/dist/hang-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hang-detector.js","sourceRoot":"","sources":["../src/hang-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,OAAO,YAAa,SAAQ,YAAY;IACpC,cAAc,GAAG,CAAC,CAAC;IACnB,gBAAgB,GAAG,CAAC,CAAC;IACrB,aAAa,GAAG,CAAC,CAAC;IAClB,WAAW,GAAG,KAAK,CAAC;IACpB,UAAU,GAA0C,IAAI,CAAC;IACzD,SAAS,CAAS;IAE1B,YAAY,cAAsB;QAChC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC;IAC9C,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,aAAa;QACX,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAClC,CAAC;IAED,sBAAsB;QACpB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;IAED,MAAM;QACJ,IAAI,IAAI,CAAC,cAAc,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5C,kEAAkE;QAClE,IAAI,IAAI,CAAC,aAAa,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,iBAAiB;QAClF,MAAM,eAAe,GAAG,GAAG,GAAG,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC;QACnE,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,KAAK,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC;QACpG,OAAO,eAAe,IAAI,eAAe,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,UAAU,GAAG,MAAM;QACvB,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;gBACxB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,EAAE,UAAU,CAAC,CAAC;IACjB,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { TmuxManager } from "./tmux-manager.js";
+export { ContextGuardian } from "./context-guardian.js";
+export { loadFleetConfig, DEFAULT_INSTANCE_CONFIG } from "./config.js";
+export { createLogger } from "./logger.js";
+export { installService, detectPlatform } from "./service-installer.js";
+export type { ContextStatus, StatusLineData, InstanceConfig, ChannelConfig, AccessConfig } from "./types.js";
+export type { ChannelAdapter, SendOpts, SentMessage, InboundMessage, Attachment, PermissionPrompt, ApprovalHandle, ApprovalResponse, Choice, AlertData, InstanceStatusData, QueuedMessage, } from "./channel/types.js";
+export type { AdapterOpts, AdapterFactory } from "./channel/factory.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+export { TmuxManager } from "./tmux-manager.js";
+export { ContextGuardian } from "./context-guardian.js";
+export { loadFleetConfig, DEFAULT_INSTANCE_CONFIG } from "./config.js";
+export { createLogger } from "./logger.js";
+export { installService, detectPlatform } from "./service-installer.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/instance-lifecycle.d.ts

@@ -0,0 +1,90 @@
+import type { InstanceConfig, FleetConfig } from "./types.js";
+import { RoutingEngine } from "./routing-engine.js";
+import type { Logger } from "./logger.js";
+import type { IpcClient } from "./channel/ipc-bridge.js";
+import type { EventLog } from "./event-log.js";
+import type { TmuxControlClient } from "./tmux-control.js";
+/**
+ * Context interface for instance lifecycle operations.
+ * FleetManager implements this.
+ */
+export interface LifecycleContext {
+    readonly fleetConfig: FleetConfig | null;
+    readonly logger: Logger;
+    readonly dataDir: string;
+    readonly routing: RoutingEngine;
+    readonly instanceIpcClients: Map<string, IpcClient>;
+    readonly sessionRegistry: Map<string, string>;
+    readonly eventLog: EventLog | null;
+    readonly controlClient: TmuxControlClient | null;
+    getInstanceDir(name: string): string;
+    saveFleetConfig(): void;
+    connectIpcToInstance(name: string): Promise<void>;
+    createForumTopic(topicName: string, adapterId?: string): Promise<number | string>;
+    deleteForumTopic(topicId: number | string): Promise<void>;
+    setTopicIcon(name: string, state: "green" | "blue" | "red" | "remove"): void;
+    /** Remove instance with full cleanup (scheduler, IPC, routing, config). */
+    removeInstance(name: string): Promise<void>;
+    touchActivity(name: string): void;
+    sendHangNotification(name: string): Promise<void>;
+    notifyInstanceTopic(name: string, text: string): void;
+    /** List claimed tasks for an instance (from task board). Returns empty array if unavailable. */
+    listClaimedTasks(assignee: string): Array<{
+        id: string;
+        title: string;
+    }>;
+    webhookEmit(event: string, name: string, data?: Record<string, unknown>): void;
+    checkModelFailover(name: string, fiveHourPct: number): void;
+    startStatuslineWatcher(name: string): void;
+    reactMessageStatus(chatId: string, messageId: string, emoji: string): void;
+}
+/** Arguments accepted by handleCreate — mirrors CreateInstanceArgs in outbound-schemas.ts
+ *  plus internal-only fields forwarded by deploy_template (profile-derived). */
+export interface LifecycleCreateArgs {
+    directory?: string;
+    topic_name?: string;
+    description?: string;
+    model?: string;
+    backend?: string;
+    branch?: string;
+    detach?: boolean;
+    worktree_path?: string;
+    systemPrompt?: string;
+    tags?: string[];
+    workflow?: string | false;
+    model_failover?: string[];
+    tool_set?: string;
+    skipPermissions?: boolean;
+    lightweight?: boolean;
+    /** Internal: used by deploy_template when branch is specified to base a new branch off this ref. */
+    start_point?: string;
+    /** Preserve any other passthrough keys without loss. */
+    [key: string]: unknown;
+}
+export interface LifecycleDeleteArgs {
+    name: string;
+    delete_topic?: boolean;
+}
+export interface LifecycleReplaceArgs {
+    name: string;
+    reason?: string;
+}
+export declare class InstanceLifecycle {
+    private ctx;
+    /** Active daemon processes: instanceName → Daemon */
+    readonly daemons: Map<string, import("./daemon.js").Daemon>;
+    constructor(ctx: LifecycleContext);
+    start(name: string, config: InstanceConfig, topicMode: boolean): Promise<void>;
+    stop(name: string): Promise<void>;
+    remove(name: string): Promise<void>;
+    /** Handle create_instance tool call from a daemon. */
+    handleCreate(args: LifecycleCreateArgs, respond: (result: unknown, error?: string) => void, adapterId?: string): Promise<void>;
+    /** Handle delete_instance tool call from a daemon. */
+    handleDelete(args: LifecycleDeleteArgs, respond: (result: unknown, error?: string) => void): Promise<void>;
+    has(name: string): boolean;
+    /** Handle replace_instance tool call: handover → stop → create new → delete old config.
+     *  If the old instance has a worktree_source, ownership transfers to the new instance
+     *  implicitly via savedConfig — the worktree itself is not recreated or removed. */
+    handleReplace(args: LifecycleReplaceArgs, respond: (result: unknown, error?: string) => void): Promise<void>;
+    private findGeneralInstance;
+}