botmux 3.2.1 → 3.3.0

package/dist/core/deferred-schedule-settlement.d.ts

@@ -0,0 +1,20 @@
+import type { DaemonSession } from './types.js';
+export type DeferredScheduleSettlementResult = {
+    action: 'ignored';
+} | {
+    action: 'materialized';
+    rootMessageId: string;
+} | {
+    action: 'closed';
+};
+/** Execute the exact-turn lifecycle decision after a hidden schedule run
+ * reaches a terminal/idle edge. Timer debounce lives in daemon.ts; keeping the
+ * decision here makes the close-vs-retain contract independently testable. */
+export declare function settleDeferredScheduleRun(ds: DaemonSession, context: {
+    turnId: string;
+    source: 'terminal' | 'idle';
+}, deps: {
+    reconcile: (ds: DaemonSession) => string | undefined;
+    closeSession: (sessionId: string) => Promise<unknown>;
+}): Promise<DeferredScheduleSettlementResult>;
+//# sourceMappingURL=deferred-schedule-settlement.d.ts.map

package/dist/core/deferred-schedule-settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-schedule-settlement.d.ts","sourceRoot":"","sources":["../../src/core/deferred-schedule-settlement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,gCAAgC,GACxC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEzB;;8EAE8E;AAC9E,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,aAAa,EACjB,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAA;CAAE,EACxD,IAAI,EAAE;IACJ,SAAS,EAAE,CAAC,EAAE,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD,GACA,OAAO,CAAC,gCAAgC,CAAC,CAY3C"}

package/dist/core/deferred-schedule-settlement.js

@@ -0,0 +1,18 @@
+/** Execute the exact-turn lifecycle decision after a hidden schedule run
+ * reaches a terminal/idle edge. Timer debounce lives in daemon.ts; keeping the
+ * decision here makes the close-vs-retain contract independently testable. */
+export async function settleDeferredScheduleRun(ds, context, deps) {
+    const run = ds.session.deferredScheduleRun;
+    if (!run || run.turnId !== context.turnId || ds.session.status === 'closed') {
+        return { action: 'ignored' };
+    }
+    if (context.source === 'idle' && ds.lastScreenStatus !== 'idle') {
+        return { action: 'ignored' };
+    }
+    const rootMessageId = deps.reconcile(ds);
+    if (rootMessageId)
+        return { action: 'materialized', rootMessageId };
+    await deps.closeSession(ds.session.sessionId);
+    return { action: 'closed' };
+}
+//# sourceMappingURL=deferred-schedule-settlement.js.map

package/dist/core/deferred-schedule-settlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-schedule-settlement.js","sourceRoot":"","sources":["../../src/core/deferred-schedule-settlement.ts"],"names":[],"mappings":"AAOA;;8EAE8E;AAC9E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,EAAiB,EACjB,OAAwD,EACxD,IAGC;IAED,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC;IAC3C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC5E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,EAAE,CAAC,gBAAgB,KAAK,MAAM,EAAE,CAAC;QAChE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACzC,IAAI,aAAa;QAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;IACpE,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/core/deferred-topic-binding.d.ts

@@ -0,0 +1,19 @@
+export interface DeferredTopicBinding {
+    sessionId: string;
+    turnId: string;
+    chatId: string;
+    larkAppId: string;
+    routingAnchor: string;
+    rootMessageId: string;
+    createdAt: string;
+}
+export declare function deferredTopicBindingPath(dataDir: string, sessionId: string): string;
+export declare function readDeferredTopicBinding(dataDir: string, sessionId: string): DeferredTopicBinding | undefined;
+export declare function writeDeferredTopicBinding(dataDir: string, binding: DeferredTopicBinding): void;
+/** Serialize the first-message claim across concurrent `botmux send`
+ * processes. The callback may hold the lock across the Lark request: that is
+ * intentional, because releasing it before the provider returns would allow
+ * two callers to create two roots for the same deferred run. */
+export declare function withDeferredTopicBindingLock<T>(dataDir: string, sessionId: string, fn: () => Promise<T>): Promise<T>;
+export declare function removeDeferredTopicBinding(dataDir: string, sessionId: string): void;
+//# sourceMappingURL=deferred-topic-binding.d.ts.map

package/dist/core/deferred-topic-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-topic-binding.d.ts","sourceRoot":"","sources":["../../src/core/deferred-topic-binding.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,oBAAoB,GAAG,SAAS,CAmBlC;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAMN;AAED;;;gEAGgE;AAChE,wBAAgB,4BAA4B,CAAC,CAAC,EAC5C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAIZ;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAGnF"}

package/dist/core/deferred-topic-binding.js

@@ -0,0 +1,55 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { withFileLock } from '../utils/file-lock.js';
+function bindingDir(dataDir) {
+    return join(dataDir, 'deferred-topics');
+}
+export function deferredTopicBindingPath(dataDir, sessionId) {
+    return join(bindingDir(dataDir), `${sessionId}.json`);
+}
+export function readDeferredTopicBinding(dataDir, sessionId) {
+    const path = deferredTopicBindingPath(dataDir, sessionId);
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        if (parsed.sessionId !== sessionId
+            || typeof parsed.turnId !== 'string'
+            || typeof parsed.chatId !== 'string'
+            || typeof parsed.larkAppId !== 'string'
+            || typeof parsed.routingAnchor !== 'string'
+            || typeof parsed.rootMessageId !== 'string'
+            || !parsed.rootMessageId.startsWith('om_')
+            || typeof parsed.createdAt !== 'string')
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function writeDeferredTopicBinding(dataDir, binding) {
+    const path = deferredTopicBindingPath(dataDir, binding.sessionId);
+    mkdirSync(dirname(path), { recursive: true });
+    const tmp = `${path}.${process.pid}.${randomUUID()}.tmp`;
+    writeFileSync(tmp, JSON.stringify(binding, null, 2), 'utf8');
+    renameSync(tmp, path);
+}
+/** Serialize the first-message claim across concurrent `botmux send`
+ * processes. The callback may hold the lock across the Lark request: that is
+ * intentional, because releasing it before the provider returns would allow
+ * two callers to create two roots for the same deferred run. */
+export function withDeferredTopicBindingLock(dataDir, sessionId, fn) {
+    const path = deferredTopicBindingPath(dataDir, sessionId);
+    mkdirSync(dirname(path), { recursive: true });
+    return withFileLock(path, fn, { maxWaitMs: 30_000 });
+}
+export function removeDeferredTopicBinding(dataDir, sessionId) {
+    const path = deferredTopicBindingPath(dataDir, sessionId);
+    try {
+        rmSync(path, { force: true });
+    }
+    catch { /* best-effort lifecycle cleanup */ }
+}
+//# sourceMappingURL=deferred-topic-binding.js.map

package/dist/core/deferred-topic-binding.js.map

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

package/dist/core/scheduler.d.ts

@@ -1,4 +1,4 @@
-import type { ScheduledTask, ParsedSchedule } from '../types.js';
+import type { ScheduledTask, ParsedSchedule, ScheduleExecutionPosition } from '../types.js';
 export declare function setExecuteCallback(cb: (task: ScheduledTask) => Promise<void>): void;
 /**
  * Bind the scheduler to a specific bot (larkAppId).  In multi-bot setups every
@@ -33,13 +33,8 @@ interface ParseNLResult {
  * handler where user types e.g. "/schedule 每日17:50 帮我看看AI新闻".
  */
 export declare function parseNaturalSchedule(input: string): ParseNLResult | null;
-/**
- * Detect a leading "new topic" delivery keyword in a /schedule prompt and strip
- * it.  Lets users write `/schedule 每日9:00 新话题 帮我看AI新闻` so every fire
- * opens a brand-new topic in the chat.  Returns the resolved delivery mode plus
- * the prompt with the keyword removed.  When no keyword is present (or nothing
- * follows it) the prompt is returned unchanged with deliver='origin'.
- */
+/** Backward-compatible parser; `deliver:new-topic` means a routing modifier
+ * was present. New callers should also read extractScheduleModifiers.position. */
 export declare function extractDeliveryMode(prompt: string): {
     deliver: 'origin' | 'new-topic';
     prompt: string;
@@ -57,12 +52,14 @@ export declare function extractSilentMode(prompt: string): {
     prompt: string;
 };
 /**
- * Extract both /schedule prompt modifiers (delivery + silent) regardless of
- * their order ("静默 新话题 …" / "新话题 静默 …").  The combination is NOT
- * validated here — callers reject silent+new-topic with a user-facing error.
+ * Extract both /schedule prompt modifiers regardless of their order.
+ * `deliver:new-topic` remains a compatibility token indicating that a position
+ * modifier was present. `executionPosition` carries the unambiguous modern
+ * value: group top level or a fresh topic on every run.
  */
 export declare function extractScheduleModifiers(prompt: string): {
     deliver: 'origin' | 'new-topic';
+    executionPosition?: Extract<ScheduleExecutionPosition, 'top-level' | 'new-topic'>;
     silent: boolean;
     prompt: string;
 };
@@ -90,6 +87,8 @@ export declare function addTask(params: {
     chatId: string;
     rootMessageId?: string;
     scope?: 'thread' | 'chat';
+    executionPosition?: ScheduleExecutionPosition;
+    topicTitle?: string;
     chatType?: 'group' | 'p2p' | 'topic_group';
     larkAppId?: string;
     creatorChatId?: string;
@@ -103,6 +102,8 @@ export declare function addTask(params: {
     deliver?: 'origin' | 'local' | 'new-topic';
     silent?: boolean;
 }): ScheduledTask;
+export declare function normalizeTopicTitle(value: string | undefined): string | undefined;
+export declare function resolveTaskExecutionPosition(task: Pick<ScheduledTask, 'executionPosition' | 'scope' | 'rootMessageId' | 'deliver'>): ScheduleExecutionPosition;
 export declare function removeTask(id: string): boolean;
 export declare function enableTask(id: string): boolean;
 export declare function disableTask(id: string): boolean;
@@ -127,22 +128,24 @@ export declare function setEnabled(id: string, enabled: boolean): {
     error?: string;
 };
 /**
- * Toggle a task's delivery mode between 'origin' and 'new-topic' and persist.
- * Only these two modes participate: 'new-topic' flips to 'origin', anything else
- * treated as origin flips to 'new-topic'. The 'local' (log-only, no delivery)
- * mode is REFUSED — toggling it would silently turn a "don't post" task into an
- * in-chat new-topic poster; 'local' is a CLI-only choice. Emits a
- * `schedule.updated` event so the dashboard reflects the change immediately.
+ * Cycle a task's execution position: retained topic → group top level → fresh
+ * topic per run → retained topic (or group top level when no root is retained).
+ * Silent tasks skip the fresh-topic state because that state needs a visible
+ * seed message. The `deliver` response remains for cached clients.
  */
 export declare function toggleDelivery(id: string): {
     ok: boolean;
     error?: string;
     deliver?: 'origin' | 'new-topic';
+    executionPosition?: ScheduleExecutionPosition;
 };
 /**
- * Update editable fields of a scheduled task (name, prompt, schedule, deliver,
- * silent). Re-parses the schedule expression and recomputes nextRunAt when the
- * schedule string changes. Enforces the silent↔new-topic mutual exclusion.
+ * Update editable fields of a scheduled task (name, prompt, schedule, silent,
+ * execution position and retained topic root).
+ * Re-parses the schedule expression and recomputes nextRunAt when the schedule
+ * string changes. A legacy `deliver` input is accepted and normalized to
+ * `origin` for normal writes. Legacy `deliver:new-topic` still maps to the
+ * explicit fresh-topic position for cached clients.
  * Emits a `schedule.updated` event so the dashboard reflects changes live.
  */
 export declare function updateTask(id: string, updates: {
@@ -151,6 +154,9 @@ export declare function updateTask(id: string, updates: {
     schedule?: string;
     deliver?: 'origin' | 'new-topic';
     silent?: boolean;
+    executionPosition?: ScheduleExecutionPosition;
+    rootMessageId?: string;
+    topicTitle?: string;
 }): {
     ok: boolean;
     error?: string;

package/dist/core/scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/core/scheduler.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAsCjE,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAEnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAG1E;AASD,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAE3D;AA4GD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAmD3D;AAWD,UAAU,aAAa;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAWxE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,QAAQ,GAAG,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWvG;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAMrF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG;IACxD,OAAO,EAAE,QAAQ,GAAG,WAAW,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAaA;AAID,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8BxF;AA4GD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,GAAE,CAAC,CAAC,EAAE,aAAa,KAAK,OAAoB,GAClD,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAS1C;AAcD,wBAAgB,cAAc,IAAI,IAAI,CAgCrC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,aAAa,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,aAAa,CA8BhB;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAM9C;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAK/C;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAU9C;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAIlD;AAOD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAmClE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAexF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAA;CAAE,CAgB5G;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAqCjC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CASlF"}
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/core/scheduler.ts"],"names":[],"mappings":"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"}

package/dist/core/scheduler.js

@@ -243,26 +243,28 @@ export function parseNaturalSchedule(input) {
     const name = prompt.length > 20 ? prompt.substring(0, 20) + '...' : prompt;
     return { parsed: zh.parsed, prompt, name };
 }
-/**
- * Detect a leading "new topic" delivery keyword in a /schedule prompt and strip
- * it.  Lets users write `/schedule 每日9:00 新话题 帮我看AI新闻` so every fire
- * opens a brand-new topic in the chat.  Returns the resolved delivery mode plus
- * the prompt with the keyword removed.  When no keyword is present (or nothing
- * follows it) the prompt is returned unchanged with deliver='origin'.
- */
-export function extractDeliveryMode(prompt) {
-    // Match a leading new-topic phrase: optional 每次/每回/每天/每日, then any run of
-    // 开/起/另/一/个/新/的/space fillers that MUST contain 新, immediately followed
-    // by 话题. `新` is mandatory so we don't match a normal prompt like
-    // "总结这个话题…" or "新闻话题…". Covers 新话题 / 新开话题 / 开新话题 /
-    // 每次开新话题 / 每次开一个新话题 / 新开一个话题 等变体。
+function extractExecutionPositionModifier(prompt) {
+    const topLevelZh = prompt.match(/^\s*(?:群消息顶层|群顶层|顶层)(?:执行|运行)?[\s,，、:：。-]+(.+)$/s);
+    if (topLevelZh && topLevelZh[1].trim())
+        return { executionPosition: 'top-level', prompt: topLevelZh[1].trim() };
+    const topLevelEn = prompt.match(/^\s*(?:group\s+)?top[\s-]?level[\s,:：-]+(.+)$/is);
+    if (topLevelEn && topLevelEn[1].trim())
+        return { executionPosition: 'top-level', prompt: topLevelEn[1].trim() };
     const zh = prompt.match(/^\s*(?:每次|每回|每天|每日)?\s*[开起另一个新的\s]*新[开起另一个新的\s]*话题[\s,，、:：。-]*(.+)$/s);
     if (zh && zh[1].trim())
-        return { deliver: 'new-topic', prompt: zh[1].trim() };
+        return { executionPosition: 'new-topic', prompt: zh[1].trim() };
     const en = prompt.match(/^\s*(?:every\s+run\s+in\s+a\s+)?new[\s-]?topic[\s,:：-]+(.+)$/is);
     if (en && en[1].trim())
-        return { deliver: 'new-topic', prompt: en[1].trim() };
-    return { deliver: 'origin', prompt };
+        return { executionPosition: 'new-topic', prompt: en[1].trim() };
+    return { prompt };
+}
+/** Backward-compatible parser; `deliver:new-topic` means a routing modifier
+ * was present. New callers should also read extractScheduleModifiers.position. */
+export function extractDeliveryMode(prompt) {
+    const parsed = extractExecutionPositionModifier(prompt);
+    return parsed.executionPosition
+        ? { deliver: 'new-topic', prompt: parsed.prompt }
+        : { deliver: 'origin', prompt };
 }
 /**
  * Detect a leading "silent" keyword in a /schedule prompt and strip it.  Lets
@@ -282,19 +284,22 @@ export function extractSilentMode(prompt) {
     return { silent: false, prompt };
 }
 /**
- * Extract both /schedule prompt modifiers (delivery + silent) regardless of
- * their order ("静默 新话题 …" / "新话题 静默 …").  The combination is NOT
- * validated here — callers reject silent+new-topic with a user-facing error.
+ * Extract both /schedule prompt modifiers regardless of their order.
+ * `deliver:new-topic` remains a compatibility token indicating that a position
+ * modifier was present. `executionPosition` carries the unambiguous modern
+ * value: group top level or a fresh topic on every run.
  */
 export function extractScheduleModifiers(prompt) {
     let deliver = 'origin';
+    let executionPosition;
     let silent = false;
     let rest = prompt;
     // Two keywords max — loop twice so either order is handled.
     for (let i = 0; i < 2; i++) {
-        const d = extractDeliveryMode(rest);
-        if (d.deliver === 'new-topic') {
+        const d = extractExecutionPositionModifier(rest);
+        if (d.executionPosition) {
             deliver = 'new-topic';
+            executionPosition = d.executionPosition;
             rest = d.prompt;
             continue;
         }
@@ -306,7 +311,7 @@ export function extractScheduleModifiers(prompt) {
         }
         break;
     }
-    return { deliver, silent, prompt: rest };
+    return { deliver, ...(executionPosition ? { executionPosition } : {}), silent, prompt: rest };
 }
 // ─── next-run computation ───────────────────────────────────────────────────
 /** Compute the next run time for a parsed schedule. Returns ISO string, or null if exhausted. */
@@ -513,14 +518,19 @@ export function stopScheduler() {
     logger.info('[scheduler] Stopped');
 }
 export function addTask(params) {
-    // Single choke point for the invalid combination — every creation entry
-    // (CLI/slash/dashboard/workflow) funnels through here. Entry points give
-    // friendlier errors first; this guard catches anything they miss.
-    if (params.silent && params.deliver === 'new-topic') {
-        throw new Error('silent schedules cannot use deliver:new-topic — a new topic requires a first message');
-    }
     const parsed = params.parsed ?? parseSchedule(params.schedule);
     const nextRunAt = computeNextRun(parsed) ?? undefined;
+    const executionPosition = params.executionPosition
+        ?? (params.deliver === 'new-topic'
+            ? 'new-topic'
+            : params.scope === 'chat'
+                ? 'top-level'
+                : params.rootMessageId ? 'topic' : 'top-level');
+    if (executionPosition === 'topic' && !params.rootMessageId) {
+        throw new Error('topic_root_required');
+    }
+    const topicTitle = normalizeTopicTitle(params.topicTitle);
+    const scope = executionPosition === 'topic' ? 'thread' : 'chat';
     const task = scheduleStore.createTask({
         name: params.name,
         schedule: params.schedule,
@@ -529,7 +539,9 @@ export function addTask(params) {
         workingDir: params.workingDir,
         chatId: params.chatId,
         rootMessageId: params.rootMessageId,
-        scope: params.scope,
+        scope,
+        executionPosition,
+        topicTitle,
         chatType: params.chatType,
         larkAppId: params.larkAppId,
         creatorChatId: params.creatorChatId,
@@ -537,12 +549,33 @@ export function addTask(params) {
         creatorLarkAppId: params.creatorLarkAppId,
         nextRunAt,
         repeat: params.repeat,
-        deliver: params.deliver ?? 'origin',
+        // Delivery shape is now expressed by scope/rootMessageId. Persist only the
+        // local-vs-chat distinction; schedule-store also normalizes legacy values.
+        deliver: params.deliver === 'local' ? 'local' : 'origin',
         silent: params.silent,
     });
     logger.info(`[scheduler] Added task "${task.name}" (${task.id}) — ${parsed.display}, next: ${nextRunAt ?? 'N/A'}`);
     return task;
 }
+export function normalizeTopicTitle(value) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        return undefined;
+    const chars = Array.from(trimmed);
+    if (chars.length > 200)
+        throw new Error('topic_title_too_long');
+    return trimmed;
+}
+export function resolveTaskExecutionPosition(task) {
+    if (task.executionPosition === 'top-level' || task.executionPosition === 'topic' || task.executionPosition === 'new-topic') {
+        return task.executionPosition === 'topic' && !task.rootMessageId ? 'top-level' : task.executionPosition;
+    }
+    if (task.deliver === 'new-topic')
+        return 'new-topic';
+    if (task.scope === 'chat')
+        return 'top-level';
+    return task.rootMessageId ? 'topic' : 'top-level';
+}
 export function removeTask(id) {
     return scheduleStore.removeTask(id);
 }
@@ -648,12 +681,10 @@ export function setEnabled(id, enabled) {
     return { ok: true };
 }
 /**
- * Toggle a task's delivery mode between 'origin' and 'new-topic' and persist.
- * Only these two modes participate: 'new-topic' flips to 'origin', anything else
- * treated as origin flips to 'new-topic'. The 'local' (log-only, no delivery)
- * mode is REFUSED — toggling it would silently turn a "don't post" task into an
- * in-chat new-topic poster; 'local' is a CLI-only choice. Emits a
- * `schedule.updated` event so the dashboard reflects the change immediately.
+ * Cycle a task's execution position: retained topic → group top level → fresh
+ * topic per run → retained topic (or group top level when no root is retained).
+ * Silent tasks skip the fresh-topic state because that state needs a visible
+ * seed message. The `deliver` response remains for cached clients.
  */
 export function toggleDelivery(id) {
     const task = scheduleStore.getTask(id);
@@ -661,44 +692,71 @@ export function toggleDelivery(id) {
         return { ok: false, error: 'not_found' };
     if (task.deliver === 'local')
         return { ok: false, error: 'local_not_toggleable' };
-    // Silent tasks must stay in-place: new-topic needs a first message to open
-    // the topic, which contradicts "post nothing on fire".
-    if (task.silent && task.deliver !== 'new-topic') {
-        return { ok: false, error: 'silent_task_origin_only' };
-    }
-    const next = task.deliver === 'new-topic' ? 'origin' : 'new-topic';
-    scheduleStore.updateTask(id, { deliver: next });
+    const current = resolveTaskExecutionPosition(task);
+    let executionPosition;
+    if (current === 'topic')
+        executionPosition = 'top-level';
+    else if (current === 'top-level')
+        executionPosition = 'new-topic';
+    else
+        executionPosition = task.rootMessageId ? 'topic' : 'top-level';
+    if (executionPosition === current)
+        return { ok: false, error: 'topic_root_required' };
+    const scope = executionPosition === 'topic' ? 'thread' : 'chat';
+    scheduleStore.updateTask(id, { scope, executionPosition });
+    const deliver = executionPosition === 'new-topic' ? 'new-topic' : 'origin';
     dashboardEventBus.publish({
         type: 'schedule.updated',
-        body: { id, patch: { deliver: next } },
+        body: { id, patch: { scope, executionPosition } },
     });
-    return { ok: true, deliver: next };
+    return { ok: true, deliver, executionPosition };
 }
 /**
- * Update editable fields of a scheduled task (name, prompt, schedule, deliver,
- * silent). Re-parses the schedule expression and recomputes nextRunAt when the
- * schedule string changes. Enforces the silent↔new-topic mutual exclusion.
+ * Update editable fields of a scheduled task (name, prompt, schedule, silent,
+ * execution position and retained topic root).
+ * Re-parses the schedule expression and recomputes nextRunAt when the schedule
+ * string changes. A legacy `deliver` input is accepted and normalized to
+ * `origin` for normal writes. Legacy `deliver:new-topic` still maps to the
+ * explicit fresh-topic position for cached clients.
  * Emits a `schedule.updated` event so the dashboard reflects changes live.
  */
 export function updateTask(id, updates) {
     const task = scheduleStore.getTask(id);
     if (!task)
         return { ok: false, error: 'not_found' };
-    // Enforce silent ↔ new-topic mutual exclusion (same rule as addTask).
-    const nextDeliver = updates.deliver ?? task.deliver ?? 'origin';
-    const nextSilent = updates.silent ?? task.silent === true;
-    if (nextSilent && nextDeliver === 'new-topic') {
-        return { ok: false, error: 'silent_new_topic_exclusive' };
-    }
     const patch = {};
     if (updates.name !== undefined)
         patch.name = updates.name;
     if (updates.prompt !== undefined)
         patch.prompt = updates.prompt;
-    if (updates.deliver !== undefined)
-        patch.deliver = updates.deliver;
     if (updates.silent !== undefined)
         patch.silent = updates.silent === true ? true : undefined;
+    const legacyPosition = updates.deliver === 'new-topic'
+        ? 'new-topic'
+        : undefined;
+    const executionPosition = updates.executionPosition ?? legacyPosition;
+    const nextRootMessageId = updates.rootMessageId ?? task.rootMessageId;
+    if (executionPosition === 'topic' && !nextRootMessageId) {
+        return { ok: false, error: 'topic_root_required' };
+    }
+    if (updates.topicTitle !== undefined) {
+        try {
+            patch.topicTitle = normalizeTopicTitle(updates.topicTitle);
+        }
+        catch (err) {
+            return { ok: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    if (updates.rootMessageId !== undefined)
+        patch.rootMessageId = updates.rootMessageId;
+    if (executionPosition !== undefined) {
+        patch.scope = executionPosition === 'topic' ? 'thread' : 'chat';
+        patch.executionPosition = executionPosition;
+        patch.deliver = 'origin';
+    }
+    else if (updates.deliver !== undefined) {
+        patch.deliver = 'origin';
+    }
     // Re-parse + recompute next run when the schedule expression changes.
     if (updates.schedule !== undefined && updates.schedule !== task.schedule) {
         let parsed;