@qilin-agent/schedule 3.1.5 → 3.1.7

package/lib/types/domain.d.ts

@@ -31,17 +31,17 @@ export declare class ScheduleLogError extends Error {
      */
     constructor(message: string);
 }
-/** Error from a model-supplied Schedule rule that cannot become a record. */
+/** Error from a model-supplied Schedule rule or target Session that cannot become a record. */
 export declare class ScheduleInputError extends Error {
     /** Stable public Schedule input code. */
-    readonly code: 'invalid_prompt' | 'invalid_selector' | 'invalid_rule' | 'invalid_time_zone' | 'not_future' | 'time_out_of_range' | 'frequency_too_high';
+    readonly code: 'invalid_prompt' | 'invalid_selector' | 'invalid_rule' | 'invalid_time_zone' | 'not_future' | 'time_out_of_range' | 'frequency_too_high' | 'subagent_session';
     /**
      * Construct a stable input failure.
      * @param code - Public Schedule error discriminator.
      * @param message - Stable public diagnostic.
      * @param options - Optional contained implementation cause.
      */
-    constructor(code: 'invalid_prompt' | 'invalid_selector' | 'invalid_rule' | 'invalid_time_zone' | 'not_future' | 'time_out_of_range' | 'frequency_too_high', message: string, options?: ErrorOptions);
+    constructor(code: 'invalid_prompt' | 'invalid_selector' | 'invalid_rule' | 'invalid_time_zone' | 'not_future' | 'time_out_of_range' | 'frequency_too_high' | 'subagent_session', message: string, options?: ErrorOptions);
 }
 /** Pure replay result, retaining active create order and every used id. */
 export interface FoldedSchedules {

package/lib/types/domain.js

@@ -44,7 +44,7 @@ export class ScheduleLogError extends Error {
         this.name = 'ScheduleLogError';
     }
 }
-/** Error from a model-supplied Schedule rule that cannot become a record. */
+/** Error from a model-supplied Schedule rule or target Session that cannot become a record. */
 export class ScheduleInputError extends Error {
     /** Stable public Schedule input code. */
     code;

package/lib/types/index.d.ts

@@ -56,6 +56,8 @@ export declare class ScheduleService extends TypertRemoteService {
      *
      * The request must supply a title; a missing, blank-after-trim, or over-long
      * title rejects with `invalid_prompt` instead of deriving one from the prompt.
+     * A Session a delegated child owns rejects with `subagent_session`, because delivery
+     * can never reach it: the child is one whose delegation depth is above zero.
      * The record is built from the clock reading taken before the request joins the
      * serialized queue, so a create that waits behind a longer operation keeps its
      * request-time anchor and may already be due when the queue reaches it.
@@ -90,7 +92,9 @@ export declare class ScheduleService extends TypertRemoteService {
      * Delete one task belonging to the selected Session, leaving queued messages intact.
      *
      * The row is removed: the task no longer schedules, leaves `list` and `catalog`, and its
-     * saved delivery records go with it.
+     * saved delivery records go with it. A task bound to a Session a delegated child owns
+     * stays deletable even though creation and timing edits refuse that binding, so a task
+     * stored before that rule existed remains removable.
      * @param request - Session and exact task identity.
      * @param signal - Optional cancellation checked before persistence begins, including after FIFO waits.
      * @returns Whether that Session owned a deleted task. Cancellation does not roll back an in-flight write.
@@ -101,10 +105,13 @@ export declare class ScheduleService extends TypertRemoteService {
      * binding without activating the Session or changing saved deliveries.
      *
      * Each supplied field replaces its stored value; an omitted field keeps it. A name or
-     * instruction change alone does not reset the committed target.
+     * instruction change alone does not reset the committed target. A Session a delegated
+     * child owns returns the non-mutating `subagent_session` result, so an edit cannot
+     * re-arm a task bound to a Session delivery can never reach, and the Web editor can
+     * explain the refusal through the ordinary result it already renders.
      * @param request - Task binding, complete observed record, and any combination of timing, name, and instruction.
      * @param signal - Cancellation checked after domain readiness and FIFO waits, before persistence begins.
-     * @returns The committed record, unchanged record for a no-op, or a non-mutating input/lookup/conflict result.
+     * @returns The committed record, unchanged record for a no-op, or a non-mutating input/lookup/conflict/refusal result.
      * Storage and lifecycle failures reject; cancellation after a write starts does not roll it back.
      */
     update(request: ScheduleUpdateRequest, signal?: AbortSignal): Promise<ScheduleUpdateResult>;
@@ -116,6 +123,19 @@ export declare class ScheduleService extends TypertRemoteService {
      */
     private emitChanged;
     private getDomain;
+    /**
+     * Refuse a Session no delivery can reach because a delegated child owns it.
+     *
+     * Delivery resolves the bound Session through `ctx.sessionController.resolveAgent`,
+     * which rejects the live Agent of a delegated child; a stored task for such a Session
+     * would stay permanently overdue and retry on every drive. Both operations that can
+     * arm a delivery read that same fact here instead of restating it: a delegated child
+     * is one whose {@link delegationDepthOf} is above zero, the accounting the delegation
+     * cap itself enforces, which survives a cold resume through the persisted header.
+     * @param sessionId - Session the task would be bound to.
+     * @returns The stable refusal for a delegated child's Session, or undefined when the Session is eligible.
+     */
+    private reminderTargetRefusal;
     /**
      * Remove every active task stored for one Session, inside the queue the tools
      * use.

package/lib/types/index.js

@@ -37,6 +37,7 @@ import { randomUUID } from 'node:crypto';
 import z from '@qilin-agent/schemastery';
 import { Service } from '@qilin-agent/kylin';
 import { TypertRemoteService, Remote } from '@qilin-agent/typert-protocol';
+import { delegationDepthOf } from '@qilin-agent/subagent';
 import { ScheduleRuntime } from "./runtime.js";
 import { scheduleDomain } from "./storage.js";
 import { deliveryHistoryPage } from "./delivery-history.js";
@@ -79,7 +80,7 @@ let ScheduleService = (() => {
             __esDecorate(this, null, _update_decorators, { kind: "method", name: "update", static: false, private: false, access: { has: obj => "update" in obj, get: obj => obj.update }, metadata: _metadata }, null, _instanceExtraInitializers);
             if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
-        static inject = ['agents', 'sessions', 'tools', 'storageDomain', 'sessionController', 'sessionPersistence'];
+        static inject = ['agents', 'sessions', 'storageDomain', 'sessionController', 'sessionPersistence'];
         static Config = z.object({
             deliveryHistoryDays: z.number().step(1).min(1).max(3650).default(DEFAULT_DELIVERY_HISTORY_DAYS),
             deliveryHistoryRecords: z.number().step(1).min(1).max(10_000).default(DEFAULT_DELIVERY_HISTORY_RECORDS),
@@ -193,6 +194,8 @@ let ScheduleService = (() => {
          *
          * The request must supply a title; a missing, blank-after-trim, or over-long
          * title rejects with `invalid_prompt` instead of deriving one from the prompt.
+         * A Session a delegated child owns rejects with `subagent_session`, because delivery
+         * can never reach it: the child is one whose delegation depth is above zero.
          * The record is built from the clock reading taken before the request joins the
          * serialized queue, so a create that waits behind a longer operation keeps its
          * request-time anchor and may already be due when the queue reaches it.
@@ -229,6 +232,9 @@ let ScheduleService = (() => {
             else
                 throw new ScheduleInputError('invalid_selector', 'Exactly one reminder selector is required.');
             return this.serialize(async () => {
+                const refusal = this.reminderTargetRefusal(sessionId);
+                if (refusal !== undefined)
+                    throw new ScheduleInputError('subagent_session', refusal.message);
                 const domain = await this.getDomain();
                 signal?.throwIfAborted();
                 await domain.table('tasks').put(id, {
@@ -286,7 +292,9 @@ let ScheduleService = (() => {
          * Delete one task belonging to the selected Session, leaving queued messages intact.
          *
          * The row is removed: the task no longer schedules, leaves `list` and `catalog`, and its
-         * saved delivery records go with it.
+         * saved delivery records go with it. A task bound to a Session a delegated child owns
+         * stays deletable even though creation and timing edits refuse that binding, so a task
+         * stored before that rule existed remains removable.
          * @param request - Session and exact task identity.
          * @param signal - Optional cancellation checked before persistence begins, including after FIFO waits.
          * @returns Whether that Session owned a deleted task. Cancellation does not roll back an in-flight write.
@@ -310,14 +318,20 @@ let ScheduleService = (() => {
          * binding without activating the Session or changing saved deliveries.
          *
          * Each supplied field replaces its stored value; an omitted field keeps it. A name or
-         * instruction change alone does not reset the committed target.
+         * instruction change alone does not reset the committed target. A Session a delegated
+         * child owns returns the non-mutating `subagent_session` result, so an edit cannot
+         * re-arm a task bound to a Session delivery can never reach, and the Web editor can
+         * explain the refusal through the ordinary result it already renders.
          * @param request - Task binding, complete observed record, and any combination of timing, name, and instruction.
          * @param signal - Cancellation checked after domain readiness and FIFO waits, before persistence begins.
-         * @returns The committed record, unchanged record for a no-op, or a non-mutating input/lookup/conflict result.
+         * @returns The committed record, unchanged record for a no-op, or a non-mutating input/lookup/conflict/refusal result.
          * Storage and lifecycle failures reject; cancellation after a write starts does not roll it back.
          */
         async update(request, signal) {
             return this.serialize(async () => {
+                const refusal = this.reminderTargetRefusal(request.sessionId);
+                if (refusal !== undefined)
+                    return refusal;
                 const tasks = (await this.getDomain()).table('tasks');
                 signal?.throwIfAborted();
                 const current = tasks.get(request.id);
@@ -356,6 +370,27 @@ let ScheduleService = (() => {
             await this.initialized;
             return this.ready;
         }
+        /**
+         * Refuse a Session no delivery can reach because a delegated child owns it.
+         *
+         * Delivery resolves the bound Session through `ctx.sessionController.resolveAgent`,
+         * which rejects the live Agent of a delegated child; a stored task for such a Session
+         * would stay permanently overdue and retry on every drive. Both operations that can
+         * arm a delivery read that same fact here instead of restating it: a delegated child
+         * is one whose {@link delegationDepthOf} is above zero, the accounting the delegation
+         * cap itself enforces, which survives a cold resume through the persisted header.
+         * @param sessionId - Session the task would be bound to.
+         * @returns The stable refusal for a delegated child's Session, or undefined when the Session is eligible.
+         */
+        reminderTargetRefusal(sessionId) {
+            const agent = this.ctx.agents.get(sessionId);
+            if (agent === undefined || delegationDepthOf(agent) === 0)
+                return undefined;
+            return {
+                code: 'subagent_session',
+                message: 'This Session belongs to subagent routing, which never receives reminder delivery.',
+            };
+        }
         /**
          * Remove every active task stored for one Session, inside the queue the tools
          * use.

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Task scheduling",
+    "description": "Stores automation tasks, runs each in its original session when it is due, and gives the agent tools to manage them."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "任务调度",
+    "description": "保存自动化任务，到点后在原会话中执行，并为智能体提供管理任务的工具。"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/schedule",
   "description": "Host-wide durable reminders with shared management and original-Session delivery",
-  "version": "3.1.5",
+  "version": "3.1.7",
   "publishConfig": {
     "access": "public"
   },
@@ -34,9 +34,11 @@
     "./remote": {
       "types": "./lib/typert.remote-client.d.ts",
       "default": "./lib/typert.remote-client.js"
-    }
+    },
+    "./locale/*.json": "./locale/*.json"
   },
   "files": [
+    "locale/*.json",
     "lib/index.js",
     "lib/types/**/*.js",
     "lib/types/**/*.d.ts",
@@ -47,41 +49,43 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/agent": "3.1.5",
-    "@qilin-agent/brand": "3.1.5",
-    "@qilin-agent/api-session-controller": "3.1.5",
-    "@qilin-agent/llm": "3.1.5",
-    "@qilin-agent/session": "3.1.5",
-    "@qilin-agent/session-persistence": "3.1.5",
-    "@qilin-agent/session-projection": "3.1.5",
-    "@qilin-agent/typert-protocol": "3.1.5",
-    "@qilin-agent/storage-domain": "3.1.5",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/tools": "3.1.5"
+    "@qilin-agent/agent": "3.1.7",
+    "@qilin-agent/api-session-controller": "3.1.7",
+    "@qilin-agent/brand": "3.1.7",
+    "@qilin-agent/llm": "3.1.7",
+    "@qilin-agent/session": "3.1.7",
+    "@qilin-agent/storage-domain": "3.1.7",
+    "@qilin-agent/session-projection": "3.1.7",
+    "@qilin-agent/tools": "3.1.7",
+    "@qilin-agent/subagent": "3.1.7",
+    "@qilin-agent/typert-protocol": "3.1.7",
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/session-persistence": "3.1.7"
   },
   "dependencies": {
     "@js-temporal/polyfill": "0.5.1",
     "zod": "^4.4.3",
-    "@qilin-agent/schemastery": "~3.18.3"
+    "@qilin-agent/schemastery": "~3.18.5"
   },
   "devDependencies": {
-    "@qilin-agent/agent": "3.1.5",
-    "@qilin-agent/kylin-plugin-loader": "~1.0.4",
-    "@qilin-agent/agent-loop": "3.1.5",
-    "@qilin-agent/api-session-controller": "3.1.5",
-    "@qilin-agent/agent-loop-testkit": "3.1.5",
-    "@qilin-agent/llm": "3.1.5",
-    "@qilin-agent/session": "3.1.5",
-    "@qilin-agent/brand": "3.1.5",
-    "@qilin-agent/session-persistence": "3.1.5",
-    "@qilin-agent/session-persistence-jsonl": "3.1.5",
-    "@qilin-agent/session-projection": "3.1.5",
-    "@qilin-agent/storage-domain": "3.1.5",
-    "@qilin-agent/storage-json": "3.1.5",
-    "@qilin-agent/system-prompt": "3.1.5",
-    "@qilin-agent/storage": "3.1.5",
-    "@qilin-agent/tools": "3.1.5",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/typert-protocol": "3.1.5"
+    "@qilin-agent/kylin-plugin-loader": "~1.0.6",
+    "@qilin-agent/agent": "3.1.7",
+    "@qilin-agent/agent-loop-testkit": "3.1.7",
+    "@qilin-agent/agent-loop": "3.1.7",
+    "@qilin-agent/api-session-controller": "3.1.7",
+    "@qilin-agent/brand": "3.1.7",
+    "@qilin-agent/llm": "3.1.7",
+    "@qilin-agent/session-persistence": "3.1.7",
+    "@qilin-agent/session-projection": "3.1.7",
+    "@qilin-agent/session-persistence-jsonl": "3.1.7",
+    "@qilin-agent/storage-domain": "3.1.7",
+    "@qilin-agent/storage": "3.1.7",
+    "@qilin-agent/storage-json": "3.1.7",
+    "@qilin-agent/session": "3.1.7",
+    "@qilin-agent/subagent": "3.1.7",
+    "@qilin-agent/tools": "3.1.7",
+    "@qilin-agent/system-prompt": "3.1.7",
+    "@qilin-agent/typert-protocol": "3.1.7",
+    "@qilin-agent/kylin": "~4.0.5"
   }
 }