@comchatx/cx-schedule 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ComChatX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,9 @@
-# Temporary Holding Version
+Ask cx to do something at set times, such as checking your listings' Buy Box every hour, and cx keeps it as a scheduled job, which stays after cx's computer switches off.
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+## When jobs run
+
+Jobs run only while cx's computer is on, that is, while you use cx or after you ask cx to keep it on. If cx's computer is off when a job falls due, the job doesn't run and doesn't switch it on.
+
+## What it costs
+
+You pay for the time cx's computer is kept on, and a job that runs often keeps it on.

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@comchatx/cx-schedule",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "Lets cx do things for you at the times you set.",
+  "license": "MIT",
+  "author": "ComChatX",
+  "comchatx": {
+    "about": "让 cx 在你设定的时间替你做事。",
+    "description": "让 cx 在设定的时间做某件事，比如每小时检查一次 listing 的 Buy Box，cx 会把它存为定时任务，cx 的电脑关机后任务也不会丢失。\n\n## 什么时候运行\n\n任务只在 cx 的电脑开机时运行，即你正在使用 cx，或已让 cx 保持开机时。到点时如果 cx 的电脑已关机，任务不会运行，也不会让它开机。\n\n## 费用\n\n保持开机的时长需要付费，运行频繁的任务也会让 cx 的电脑保持开机。",
+    "mark": {
+      "line": "clock"
+    },
+    "section": "extensions",
+    "order": 30,
+    "builds": [
+      "@amaster.ai/pi-task-scheduler"
+    ]
+  },
+  "homepage": "https://github.com/comchatx/cx-schedule#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/comchatx/cx-schedule.git"
+  },
+  "bugs": "https://github.com/comchatx/cx-schedule/issues",
+  "keywords": [
+    "pi-package"
+  ],
+  "type": "module",
+  "pi": {
+    "skills": [
+      "./skills"
+    ]
+  },
+  "files": [
+    "skills"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "1.3.0",
+    "@types/node": "26.2.0",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11"
+  },
+  "overrides": {
+    "@earendil-works/pi-ai": "1.3.0",
+    "@earendil-works/pi-mcp": "1.3.0",
+    "@earendil-works/pi-tui": "1.3.0",
+    "@earendil-works/pi-codemode": "1.3.0",
+    "@earendil-works/pi-agent-core": "1.3.0",
+    "@earendil-works/pi-telemetry": "1.3.0"
+  }
+}

package/skills/cx-schedule/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: cx-schedule
+description: "Scheduled tasks in a ComChatX box - a recurring check, a task at a time - run by `@amaster.ai/pi-task-scheduler`, which cx-schedule needs, and its `scheduler_*` tools; what the tools' own words miss here. cx-schedule needs `@amaster.ai/pi-task-scheduler`: where no `scheduler_*` tool is there, the scheduler is not installed, and the seller installs it in Plugins, which installs it with cx-schedule. cx-schedule installs from Plugins, or with `pi install -l npm:@comchatx/cx-schedule` run in /tenant (without -l it is gone at the box's next start)."
+---
+
+## When a task runs
+
+- A task runs only while the box is awake: in use, or kept up by `keep_awake` in `/tenant/settings.json`. A sleeping box runs no task, and no task wakes it. Awake time is billed.
+- A task whose time falls while the box sleeps does not run, and does not wake the box: a `cron` task runs at its next time after the box opens, an `interval` task counts its interval again from the open, and a `once` task whose time passed is marked `error` and never runs.
+- A task that runs more often than the box's idle threshold keeps the box awake, and that time is billed.
+- The box's clock is UTC: a `cron` schedule is read in UTC.
+
+## Where a task lands
+
+- A task belongs to the conversation it was made in. It runs as a follow-up turn there, after any turn under way, and only while that conversation is the open one; in another conversation it neither runs nor shows in `scheduler_list`.
+- A run's `success` means pi took the turn, not that the work in it succeeded.
+- A task runs on the conversation's own model: the `model` a task records is not used.
+- The tasks live in `/tenant/.pi/pi-scheduler/`, where the box points the scheduler, so they outlast the box's stops.