@songsid/agend 2.1.4-beta.17 → 2.1.4-beta.18

package/dist/fleet-context.d.ts

@@ -54,6 +54,8 @@ export interface FleetContext {
     readonly classicChannels: ClassicChannelManager | null;
     getSysInfo(): SysInfo;
     getInstanceStatus(name: string): "running" | "paused" | "stopped" | "crashed";
+    /** Current cancellation epoch stamped onto direct daemon IPC deliveries. */
+    getDeliveryEpoch?(name: string): number;
     /** Subscription provider IDs used by running or paused fleet/Classic instances. */
     getActiveUsageProviderIds?(): ReadonlySet<string>;
     toggleFleetCollab(instanceName: string): boolean;

package/dist/fleet-manager.d.ts

@@ -113,6 +113,13 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private warmCapEvicting;
     /** Per-instance tail keeps cross-instance and scheduled deliveries FIFO. */
     private idleGatedDeliveryTails;
+    /**
+     * Per-instance cancellation epoch for deliveries which have not reached the
+     * daemon yet. A cancel advances the epoch; queued work captures the old value
+     * and becomes a no-op, while messages arriving after the click capture the new
+     * value and remain deliverable.
+     */
+    private deliveryEpochs;
     /** Non-user work must observe a fresh idle snapshot after the latest delivery. */
     private lastDeliveryAt;
     /** State-cache updates wake event-driven idle waiters without busy polling. */
@@ -783,6 +790,10 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     private reactDone;
     /** Interrupt an instance's current generation (cancel button / /cancel). */
     cancelInstance(instanceName: string): boolean;
+    getDeliveryEpoch(instanceName: string): number;
+    private isDeliveryEpochCurrent;
+    /** Invalidate work queued before a user cancel and wake idle-gate waiters. */
+    private cancelPendingDeliveries;
     queueMirrorMessage(text: string): void;
     /** Push an SSE event to all connected Web UI clients. */
     emitSseEvent(event: string, data: unknown): void;

package/dist/fleet-manager.js

@@ -267,6 +267,13 @@ export class FleetManager {
     warmCapEvicting = new Set();
     /** Per-instance tail keeps cross-instance and scheduled deliveries FIFO. */
     idleGatedDeliveryTails = new Map();
+    /**
+     * Per-instance cancellation epoch for deliveries which have not reached the
+     * daemon yet. A cancel advances the epoch; queued work captures the old value
+     * and becomes a no-op, while messages arriving after the click capture the new
+     * value and remain deliverable.
+     */
+    deliveryEpochs = new Map();
     /** Non-user work must observe a fresh idle snapshot after the latest delivery. */
     lastDeliveryAt = new Map();
     /** State-cache updates wake event-driven idle waiters without busy polling. */
@@ -911,7 +918,7 @@ export class FleetManager {
                 .finally(() => this.warmCapEvicting.delete(victim));
         }
     }
-    waitForInstanceIdle(instanceName, timeoutMs, idleObservedAfter = 0) {
+    waitForInstanceIdle(instanceName, timeoutMs, idleObservedAfter = 0, cancelled) {
         const isReady = () => {
             const snapshot = this.instanceStateCache.get(instanceName);
             return snapshot?.state === "idle"
@@ -933,8 +940,12 @@ export class FleetManager {
                     this.instanceIdleWaiters.delete(instanceName);
                 resolve(idle);
             };
-            const check = () => { if (isReady())
-                finish(true); };
+            const check = () => {
+                if (cancelled?.())
+                    finish(false);
+                else if (isReady())
+                    finish(true);
+            };
             const query = () => {
                 const ipc = this.instanceIpcClients.get(instanceName);
                 if (ipc?.connected) {
@@ -992,22 +1003,32 @@ export class FleetManager {
                 finish(false);
         });
     }
-    async deliverWithIdleGate(instanceName, payload, timeoutMs) {
+    async deliverWithIdleGate(instanceName, payload, timeoutMs, deliveryEpoch) {
+        if (!this.isDeliveryEpochCurrent(instanceName, deliveryEpoch))
+            return;
         let idleObservedAfter = this.lastDeliveryAt.get(instanceName) ?? 0;
         if (this.lifecycle.isPaused(instanceName)) {
             const wakeStartedAt = Date.now();
             await this.lifecycle.wake(instanceName, 30_000);
+            if (!this.isDeliveryEpochCurrent(instanceName, deliveryEpoch))
+                return;
             // Waking added one to the warm count — make room by evicting a different
             // LRU idle instance (never this one; it's about to work).
             this.enforceWarmCap(instanceName);
             // Never satisfy a post-wake gate from a stale pre-pause cache entry.
             idleObservedAfter = Math.max(idleObservedAfter, wakeStartedAt);
         }
-        const idle = await this.waitForInstanceIdle(instanceName, timeoutMs, idleObservedAfter);
+        const idle = await this.waitForInstanceIdle(instanceName, timeoutMs, idleObservedAfter, () => !this.isDeliveryEpochCurrent(instanceName, deliveryEpoch));
+        if (!this.isDeliveryEpochCurrent(instanceName, deliveryEpoch)) {
+            this.logger.info({ instanceName }, "Pending delivery dropped by user cancel");
+            return;
+        }
         if (!idle) {
             this.logger.warn({ instanceName, timeoutMs }, "Idle gate timed out; forcing delivery");
         }
-        await this.sendWhenConnected(instanceName, payload);
+        await this.sendWhenConnected(instanceName, payload, deliveryEpoch);
+        if (!this.isDeliveryEpochCurrent(instanceName, deliveryEpoch))
+            return;
         this.lastDeliveryAt.set(instanceName, Date.now());
     }
     /**
@@ -1026,7 +1047,9 @@ export class FleetManager {
      * instance, *including* when the socket happens to be up: otherwise a message
      * arriving after the reconnect could overtake one that has been waiting for it.
      */
-    async sendWhenConnected(instanceName, payload) {
+    async sendWhenConnected(instanceName, payload, deliveryEpoch = this.getDeliveryEpoch(instanceName)) {
+        if (!this.isDeliveryEpochCurrent(instanceName, deliveryEpoch))
+            return;
         const queued = this.ipcWaitTails.get(instanceName);
         if (!queued) {
             const ipc = this.instanceIpcClients.get(instanceName);
@@ -1035,7 +1058,11 @@ export class FleetManager {
         }
         const attempt = (queued ?? Promise.resolve())
             .catch(() => { })
-            .then(() => this.sendAfterIpcReturns(instanceName, payload));
+            .then(() => {
+            if (!this.isDeliveryEpochCurrent(instanceName, deliveryEpoch))
+                return;
+            return this.sendAfterIpcReturns(instanceName, payload, deliveryEpoch);
+        });
         // The chain stores a settled-either-way promise so one failed delivery cannot
         // wedge every later one, and so `queued` above is safe to await unguarded.
         const tail = attempt.catch(() => { });
@@ -1052,10 +1079,12 @@ export class FleetManager {
         }
     }
     /** Poll for the instance's IPC to come back, then send. Throws if it does not. */
-    async sendAfterIpcReturns(instanceName, payload) {
+    async sendAfterIpcReturns(instanceName, payload, deliveryEpoch = this.getDeliveryEpoch(instanceName)) {
         const deadline = Date.now() + IPC_RECONNECT_GRACE_MS;
         let warned = false;
         for (;;) {
+            if (!this.isDeliveryEpochCurrent(instanceName, deliveryEpoch))
+                return;
             // Re-read every round: a reconnect replaces the IpcClient object entirely,
             // so a cached reference would stay dead forever.
             const ipc = this.instanceIpcClients.get(instanceName);
@@ -1073,6 +1102,8 @@ export class FleetManager {
     }
     /** Single delivery facade: wake paused CLIs and serialize non-user work behind idle. */
     async deliverToInstance(instanceName, payload, options = {}) {
+        const deliveryEpoch = this.getDeliveryEpoch(instanceName);
+        const deliveryPayload = { ...payload, delivery_epoch: deliveryEpoch };
         const meta = payload.meta && typeof payload.meta === "object"
             ? payload.meta
             : undefined;
@@ -1084,16 +1115,20 @@ export class FleetManager {
         if (!waitForIdle) {
             if (this.lifecycle.isPaused(instanceName)) {
                 await this.lifecycle.wake(instanceName, 30_000);
+                if (!this.isDeliveryEpochCurrent(instanceName, deliveryEpoch))
+                    return;
                 this.enforceWarmCap(instanceName); // woke one → evict a different LRU idle if over cap
             }
-            await this.sendWhenConnected(instanceName, payload);
+            await this.sendWhenConnected(instanceName, deliveryPayload, deliveryEpoch);
+            if (!this.isDeliveryEpochCurrent(instanceName, deliveryEpoch))
+                return;
             // A cross-instance item arriving before the daemon observes this turn as
             // working must not trust the stale idle snapshot from before the send.
             this.lastDeliveryAt.set(instanceName, Date.now());
             return;
         }
         const previous = this.idleGatedDeliveryTails.get(instanceName) ?? Promise.resolve();
-        const delivery = previous.catch(() => { }).then(() => this.deliverWithIdleGate(instanceName, payload, options.idleTimeoutMs ?? 60_000));
+        const delivery = previous.catch(() => { }).then(() => this.deliverWithIdleGate(instanceName, deliveryPayload, options.idleTimeoutMs ?? 60_000, deliveryEpoch));
         this.idleGatedDeliveryTails.set(instanceName, delivery);
         try {
             await delivery;
@@ -2354,6 +2389,23 @@ export class FleetManager {
                 });
                 await data.respond(result);
             }
+            else if (data.command === "btw") {
+                const name = this.resolveSlashTarget(data.channelId, adapterId);
+                if (!name) {
+                    await data.respond(t("classic.no_agent"));
+                    return;
+                }
+                const btwText = String(data.options?.message ?? "").trim();
+                if (!btwText) {
+                    await data.respond(t("btw.usage"));
+                    return;
+                }
+                const result = this.topicCommands.sendBtw(name, btwText, {
+                    chatId: "", messageId: "", username: data.username ?? "user",
+                    userId: data.userId ?? "", threadId: undefined, adapterId, source: "discord",
+                });
+                await data.respond(result);
+            }
             else if (data.command === "clear") {
                 await this.handleClearSlash(data, adapterId);
             }
@@ -2498,6 +2550,23 @@ export class FleetManager {
                 });
                 await data.respond(result);
             }
+            else if (data.command === "btw") {
+                const name = this.resolveSlashTarget(data.channelId, adapterId);
+                if (!name) {
+                    await data.respond(t("classic.no_agent"));
+                    return;
+                }
+                const btwText = String(data.options?.message ?? "").trim();
+                if (!btwText) {
+                    await data.respond(t("btw.usage"));
+                    return;
+                }
+                const result = this.topicCommands.sendBtw(name, btwText, {
+                    chatId: "", messageId: "", username: data.username ?? "user",
+                    userId: data.userId ?? "", threadId: undefined, adapterId, source: "discord",
+                });
+                await data.respond(result);
+            }
         }, this.logger, "adapter.slash_command"));
         await this.topicCommands.registerBotCommands().catch(e => this.logger.warn({ err: e }, "registerBotCommands failed (non-fatal)"));
         // Background-probe each backend's CLI env (version/models) → cli-env cache.
@@ -2800,6 +2869,23 @@ export class FleetManager {
                 });
                 await data.respond(result);
             }
+            else if (data.command === "btw") {
+                const name = this.resolveSlashTarget(data.channelId, adapterId);
+                if (!name) {
+                    await data.respond(t("classic.no_agent"));
+                    return;
+                }
+                const btwText = String(data.options?.message ?? "").trim();
+                if (!btwText) {
+                    await data.respond(t("btw.usage"));
+                    return;
+                }
+                const result = this.topicCommands.sendBtw(name, btwText, {
+                    chatId: "", messageId: "", username: data.username ?? "user",
+                    userId: data.userId ?? "", threadId: undefined, adapterId, source: "discord",
+                });
+                await data.respond(result);
+            }
         }, this.logger, `adapter[${adapterId}].slash_command`));
         await adapter.start();
         if (channelConfig.group_id) {
@@ -3385,6 +3471,24 @@ export class FleetManager {
                     await msgAdapter?.sendText(chatId, result);
                     return;
                 }
+                // /btw — Claude Code's native side-thread command. Like /steer it is
+                // not admin-gated, but it remains a distinct raw CLI command so Claude
+                // does not fold the question into the active task.
+                if (text === "/btw" || text.startsWith("/btw ") || text.startsWith("/btw@")) {
+                    const btwName = this.classicChannels.getInstanceByChannel(chatId, msg.adapterId);
+                    if (!btwName) {
+                        await msgAdapter?.sendText(chatId, t("classic.no_agent_start"));
+                        return;
+                    }
+                    const btwContent = text.replace(/^\/btw(@\S+)?/, "").trim();
+                    if (!btwContent) {
+                        await msgAdapter?.sendText(chatId, t("btw.usage"));
+                        return;
+                    }
+                    const result = this.topicCommands.sendBtw(btwName, btwContent, msg);
+                    await msgAdapter?.sendText(chatId, result);
+                    return;
+                }
                 // Handle /clear command (admin only) — unlike /compact this starts a
                 // fresh conversation and intentionally discards the current history.
                 if (text === "/clear" || text.startsWith("/clear@")) {
@@ -3831,7 +3935,11 @@ export class FleetManager {
         if (silent) {
             const ipc = this.instanceIpcClients.get(target);
             if (ipc) {
-                ipc.send({ type: "raw_paste", content: message });
+                ipc.send({
+                    type: "raw_paste",
+                    content: message,
+                    delivery_epoch: this.getDeliveryEpoch(target),
+                });
                 this.scheduler.recordRun(id, "delivered");
                 this.logger.info({ target, scheduleId: id, label }, "Silent schedule injected via raw_paste");
             }
@@ -3846,10 +3954,19 @@ export class FleetManager {
         const retryInterval = schedulerDefaults?.retry_interval_ms ?? 30_000;
         const deliver = async () => {
             try {
+                // A schedule has no live inbound adapter context. Seed the daemon with
+                // the target instance's configured world so replies use its persona
+                // after a fresh start instead of falling back to channels[0].
+                const adapterId = this.getInstanceAdapterId(target);
                 await this.deliverToInstance(target, {
                     type: "fleet_schedule_trigger",
                     payload: { schedule_id: id, message: `[Scheduled] ${message}`, label },
-                    meta: { chat_id: reply_chat_id, thread_id: reply_thread_id, user: "scheduler" },
+                    meta: {
+                        chat_id: reply_chat_id,
+                        thread_id: reply_thread_id,
+                        user: "scheduler",
+                        ...(adapterId ? { adapter_id: adapterId } : {}),
+                    },
                 }, { waitForIdle: true });
                 // A scheduled trigger also puts the instance to work — show a cancel button.
                 void this.sendCancelButton(target);
@@ -5731,11 +5848,27 @@ export class FleetManager {
         const daemon = this.daemons.get(instanceName);
         if (!daemon)
             return false;
+        const deliveryEpoch = this.cancelPendingDeliveries(instanceName);
+        daemon.clearPendingDeliveries?.(deliveryEpoch);
         daemon.sendEscape().catch(e => this.logger.warn({ err: e, instanceName }, "sendEscape failed"));
         this.lastInboundMsg.delete(instanceName);
         this.clearCancelButton(instanceName);
         return true;
     }
+    getDeliveryEpoch(instanceName) {
+        return this.deliveryEpochs.get(instanceName) ?? 0;
+    }
+    isDeliveryEpochCurrent(instanceName, deliveryEpoch) {
+        return deliveryEpoch === this.getDeliveryEpoch(instanceName);
+    }
+    /** Invalidate work queued before a user cancel and wake idle-gate waiters. */
+    cancelPendingDeliveries(instanceName) {
+        const next = this.getDeliveryEpoch(instanceName) + 1;
+        this.deliveryEpochs.set(instanceName, next);
+        for (const check of this.instanceIdleWaiters.get(instanceName) ?? [])
+            check();
+        return next;
+    }
     queueMirrorMessage(text) {
         const mirrorTopicId = this.fleetConfig?.channel?.mirror_topic_id;
         if (mirrorTopicId == null || !this.adapter)