@yijiancaotang/cli 1.0.0 → 1.2.0

package/dist/reviewed-managed-bundle-baseline.js

@@ -0,0 +1,356 @@
+// Exact runtime bytes from reviewed CLI tgz 8ce64d4ae13656763b913da10637cd20da85b6763fb7a5c02757a1417b7f8d9b.
+// One full-content baseline only; version/receipt/directory self-reports are not evidence.
+export const REVIEWED_MANAGED_BUNDLE_1_1_0 = {
+    "version": "1.1.0",
+    "sha": "ed87c23c98d57cd990a5212a05788cc95136b6bc810e61f30c1fbac7026c212a",
+    "files": [
+        {
+            "path": "bin/caotang.cjs",
+            "mode": 448,
+            "bytes": 861,
+            "sha256": "b1047ea22a774718e377edcb4a18e3c16ce2b101ad40c5d39721894d652f37c5"
+        },
+        {
+            "path": "dist/agent-identity.js",
+            "mode": 384,
+            "bytes": 1417,
+            "sha256": "e217376060e8c5a46c6c58f596f198750c3154eca561be757fee7151e3e1c86c"
+        },
+        {
+            "path": "dist/auth.js",
+            "mode": 384,
+            "bytes": 20770,
+            "sha256": "5c0917ae4b212b47091ca205d40427f8dd580bd494ccc6b5c586177bbfded0e0"
+        },
+        {
+            "path": "dist/calendar-contract.js",
+            "mode": 384,
+            "bytes": 24328,
+            "sha256": "3124493cea046a0f0dc6841f52610cb4e1aae78f3375de7090e378010f953807"
+        },
+        {
+            "path": "dist/calendar-help.js",
+            "mode": 384,
+            "bytes": 4578,
+            "sha256": "224c5eeb5376358593e04501c4d92d39174a6ca23e1d4bc46729e8f84058c37a"
+        },
+        {
+            "path": "dist/calendar.js",
+            "mode": 384,
+            "bytes": 3748,
+            "sha256": "b10c9135617e9c9fe6530fef32c6679ff9e6c497967308a33ddd2013469e7a6f"
+        },
+        {
+            "path": "dist/capability-result.js",
+            "mode": 384,
+            "bytes": 3829,
+            "sha256": "09d398275dfeb82c18bcfa0b9abe6341607678e3248eb543d944fed390a0466d"
+        },
+        {
+            "path": "dist/cli.js",
+            "mode": 384,
+            "bytes": 22177,
+            "sha256": "71eff64b32306430fd9c35a2ecc633dda195eec7064c3b700822de3b76940af8"
+        },
+        {
+            "path": "dist/command-help.js",
+            "mode": 384,
+            "bytes": 14071,
+            "sha256": "556be79209c89eef690f18866cd27803aef671279b411f73383c115a82a41cc6"
+        },
+        {
+            "path": "dist/commands.js",
+            "mode": 384,
+            "bytes": 23262,
+            "sha256": "cfc95b14372a105c917b588e4574458196b58bf30967591361f8bdec0493b989"
+        },
+        {
+            "path": "dist/config.js",
+            "mode": 384,
+            "bytes": 1289,
+            "sha256": "7a99ac4696d06db5bcecef3a9c9e406ef079ace724101bf720bf916e319bef0a"
+        },
+        {
+            "path": "dist/connection-copy.js",
+            "mode": 384,
+            "bytes": 2284,
+            "sha256": "5617453b07fe39ebf1fa20a4a4f64729adbfb2f93a51f9754330b2be60bb6078"
+        },
+        {
+            "path": "dist/context.js",
+            "mode": 384,
+            "bytes": 1885,
+            "sha256": "6c92b7c7f7d11674bebb0f6f9981794ac64a8c94f45393a9a4e5b6e92bd87616"
+        },
+        {
+            "path": "dist/contracts.js",
+            "mode": 384,
+            "bytes": 11,
+            "sha256": "8e609bb71c20b858c77f0e9f90bb1319db8477b13f9f965f1a1e18524bf50881"
+        },
+        {
+            "path": "dist/create-bundle.js",
+            "mode": 384,
+            "bytes": 9646,
+            "sha256": "043713b3e9d435268634aab72dc6f8a15017b5be1ecf4760bde2d788f31e95f5"
+        },
+        {
+            "path": "dist/create-file-failure.js",
+            "mode": 384,
+            "bytes": 1555,
+            "sha256": "690a59a4fc47b624260d753bbf79b88ecb8a83d6ee846341e3c9133779dff045"
+        },
+        {
+            "path": "dist/credential-store.js",
+            "mode": 384,
+            "bytes": 27762,
+            "sha256": "2bf9b031eec6cf984af30822e5fa7b5e8f8888f58d09084e723feeaf49c291a2"
+        },
+        {
+            "path": "dist/doctor.js",
+            "mode": 384,
+            "bytes": 17642,
+            "sha256": "c0438daeab4483a483051f9bd94beb40d5cedd11f20155506f09bbb3d5ec00c2"
+        },
+        {
+            "path": "dist/errors.js",
+            "mode": 384,
+            "bytes": 17485,
+            "sha256": "0634831524769f8c348aea43f8b2b90f1e5eab74f66bdf3c0ef77057c8a3e9d7"
+        },
+        {
+            "path": "dist/generated/knowledge-growth.js",
+            "mode": 384,
+            "bytes": 1324,
+            "sha256": "3fefbb5bd04dfef4548b21bb91b739bbdcc4f565cfd34d8cf08bdcb598d069b9"
+        },
+        {
+            "path": "dist/habit-day.js",
+            "mode": 384,
+            "bytes": 2697,
+            "sha256": "23bbcd87ae6af1d874c57e5601b2ac6a6d27982f94a84490fdce0a5fb565b237"
+        },
+        {
+            "path": "dist/habit-read.js",
+            "mode": 384,
+            "bytes": 2134,
+            "sha256": "db69e3a7ba00887367d86e101dd451efe4b993138cee6704fb96031dcbcf965f"
+        },
+        {
+            "path": "dist/habit-wire.js",
+            "mode": 384,
+            "bytes": 7188,
+            "sha256": "ce414a79b8e444f97a641eb048e52397bf2d5b3e162121f2f349ebfeb0d0b8f7"
+        },
+        {
+            "path": "dist/http.js",
+            "mode": 384,
+            "bytes": 10029,
+            "sha256": "8bdb9bede2b928037e882a9b375d0a1959d53f599b969d83fa2081248e051f67"
+        },
+        {
+            "path": "dist/input-validation.js",
+            "mode": 384,
+            "bytes": 4135,
+            "sha256": "c5382d9287b1f330a5468d2c3abad33903bc560182f45d69f121a132ac15e28b"
+        },
+        {
+            "path": "dist/installation.js",
+            "mode": 384,
+            "bytes": 39276,
+            "sha256": "4e371462d83abc0e440906cdc802a3a3713e6f62cf59c3e2e0519492a5cd08db"
+        },
+        {
+            "path": "dist/knowledge-growth.js",
+            "mode": 384,
+            "bytes": 4257,
+            "sha256": "18187fb1100faf0d79e32fc1bf0455ad35d59ffe94d35040b9a765d89674c12b"
+        },
+        {
+            "path": "dist/local-commands.js",
+            "mode": 384,
+            "bytes": 17710,
+            "sha256": "0ddde63bb06d84acce0072be202384e550c070cfddb7befb7477eb3fd6ad1e36"
+        },
+        {
+            "path": "dist/local-lock.js",
+            "mode": 384,
+            "bytes": 9362,
+            "sha256": "3ee54676ebb20a177bb22726ff6d08d329a511b25500e59cd969e5a27c5e417a"
+        },
+        {
+            "path": "dist/local-records.js",
+            "mode": 384,
+            "bytes": 8122,
+            "sha256": "a2304b1ad0ddc3107265a61faf3935b3a3f14436be275906dd9a306338fa6b77"
+        },
+        {
+            "path": "dist/local-types.js",
+            "mode": 384,
+            "bytes": 358,
+            "sha256": "d43abb2a72ecb33f501e5c16bf624fd971f33f3541153937060f4320d54d956f"
+        },
+        {
+            "path": "dist/managed-skill-baseline.js",
+            "mode": 384,
+            "bytes": 2142,
+            "sha256": "63f869e057d2bc41405facc9a4883c136955255bef2abc2c443c85e204ed8d97"
+        },
+        {
+            "path": "dist/missing-sections.js",
+            "mode": 384,
+            "bytes": 4216,
+            "sha256": "9ce6d37478ebc813ce9d2ee1a8372bdc8170a7867274a7bf5f817052972b88b7"
+        },
+        {
+            "path": "dist/onboarding.js",
+            "mode": 384,
+            "bytes": 2768,
+            "sha256": "f48693b69edadba01dc34fd4949bcd617bc3130451c4ea6c158860bc85e2aaaf"
+        },
+        {
+            "path": "dist/output.js",
+            "mode": 384,
+            "bytes": 3970,
+            "sha256": "0f8cdd45522f2990d77d5078820d7a6897a4e4e1c969fc729480ce14017276fc"
+        },
+        {
+            "path": "dist/pending-requests.js",
+            "mode": 384,
+            "bytes": 3697,
+            "sha256": "29ba9aa0af625fde56dd7d3da708d2a283d2a0aef40118f1ce16304e9ee01195"
+        },
+        {
+            "path": "dist/platforms.js",
+            "mode": 384,
+            "bytes": 10224,
+            "sha256": "5660acdd8f1471c7ff2df19e02ce23ebfbb5124846b2e04882a1670158ad7392"
+        },
+        {
+            "path": "dist/query-daily.js",
+            "mode": 384,
+            "bytes": 6188,
+            "sha256": "5648b0322f72c8296df9d3beac7a788cd94f7af9c902c46539a9ae4f36834b67"
+        },
+        {
+            "path": "dist/query-search.js",
+            "mode": 384,
+            "bytes": 4015,
+            "sha256": "eeb4b76665489edd57e2ab757ce585cdf91941c08cbc088758ed88b35f130332"
+        },
+        {
+            "path": "dist/query-validation.js",
+            "mode": 384,
+            "bytes": 3439,
+            "sha256": "0aa2123725ca27720eb86cfbe59cb1f6771ee2db2991150eae783db9c4c9cd79"
+        },
+        {
+            "path": "dist/schedule-contract.js",
+            "mode": 384,
+            "bytes": 16879,
+            "sha256": "d5f5a43e4ac33274ddf275d00dd5b3696fe125c773e117979643830b5294da6e"
+        },
+        {
+            "path": "dist/schedule-help.js",
+            "mode": 384,
+            "bytes": 4821,
+            "sha256": "cc86c38e16e8660fca343dc95d2dfc9af525b41296c67db2ccd1b969f7da82f4"
+        },
+        {
+            "path": "dist/schedule-start-wire.js",
+            "mode": 384,
+            "bytes": 3634,
+            "sha256": "6b6b6843dd41053c3b334c0785100de90ef3f4e5af130fb839911897100161ce"
+        },
+        {
+            "path": "dist/schedule.js",
+            "mode": 384,
+            "bytes": 4030,
+            "sha256": "ee234a5744aa0cef9afcbd0b2ac9cb4336e7226069a148c39858fa439a25202e"
+        },
+        {
+            "path": "dist/skill-assets.js",
+            "mode": 384,
+            "bytes": 6960,
+            "sha256": "962171172db20f2ecc1cc0eaa9863e2f27e414b7cf1399fb224cade57b09613d"
+        },
+        {
+            "path": "dist/upload.js",
+            "mode": 384,
+            "bytes": 7625,
+            "sha256": "59c862ea1d31f90e48a746f8d26fb0903c8bedd3af0f0b4624c744280359afff"
+        },
+        {
+            "path": "dist/web-citations.js",
+            "mode": 384,
+            "bytes": 4509,
+            "sha256": "58cd8275f992f88a030f30239bb78eb301948e40e24d9c2c0e9b4fe27aa3d00a"
+        },
+        {
+            "path": "dist/write-permissions.js",
+            "mode": 384,
+            "bytes": 2497,
+            "sha256": "ecaf3009ee061d246d85aef69036815c5ae778617578be7e4f3513426045cc1b"
+        },
+        {
+            "path": "dist/write-routing.js",
+            "mode": 384,
+            "bytes": 2629,
+            "sha256": "4acff0b485ee0c8a394adf5142122f82ca14c6d03fdaf81fd7c46aa80fe8f39c"
+        },
+        {
+            "path": "package.json",
+            "mode": 384,
+            "bytes": 140,
+            "sha256": "ecddc8f82d17dec46897ed0d324b24f5465451dc413a90b1e0ba7a8b0e259889"
+        },
+        {
+            "path": "skills/caotang-context/SKILL.md",
+            "mode": 384,
+            "bytes": 7260,
+            "sha256": "0580c8513de3f91c9a12cf94290200e90d1a0ee5dc2610e0654ccc3146832732"
+        },
+        {
+            "path": "skills/caotang-first-connect/SKILL.md",
+            "mode": 384,
+            "bytes": 11277,
+            "sha256": "cbbe660f4a058214ff6fbc320f999f7342457384ba9a38ce493f1dbc8eda7692"
+        },
+        {
+            "path": "skills/caotang-project-progress/SKILL.md",
+            "mode": 384,
+            "bytes": 9829,
+            "sha256": "1a5a2c4849aca52237a1e18f6c70bbddd2a9815260c87ce6fb26872736120c94"
+        },
+        {
+            "path": "skills/caotang-save-knowledge/SKILL.md",
+            "mode": 384,
+            "bytes": 6779,
+            "sha256": "002dd420b32851b1b0a97175baaf270c44c327900c1f9ae40197673d415e10fa"
+        },
+        {
+            "path": "skills/caotang-schedule/SKILL.md",
+            "mode": 384,
+            "bytes": 5365,
+            "sha256": "e2f3689412b39cc1475ba56d6e6082380ed9bbc195f6fb44ed9b5e9992a787a4"
+        },
+        {
+            "path": "skills/caotang-search/SKILL.md",
+            "mode": 384,
+            "bytes": 9895,
+            "sha256": "d69f9e6dae707c163139ddb64eef787bd9ae1d3ca0328079353f206085edf0a2"
+        },
+        {
+            "path": "skills/caotang-workday/SKILL.md",
+            "mode": 384,
+            "bytes": 7233,
+            "sha256": "b20b3592e2d9d61d1d42638b51fdcd34bbe113b6655ec353e342e45aa7dd65cb"
+        },
+        {
+            "path": "skills/manifest.json",
+            "mode": 384,
+            "bytes": 1438,
+            "sha256": "9bdbf8e82510fd51036704e8de6830a4d53bc8a6d97aad3c3a20c883c50c9939"
+        }
+    ]
+};

package/dist/schedule-contract.js

@@ -0,0 +1,289 @@
+export const scheduleRoot = "/api/v1/agent";
+export const scheduleKeyPattern = /^[A-Za-z0-9._:-]{16,128}(?![\s\S])/;
+export const scheduleUUID = (value) => typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}(?![\s\S])/i.test(value);
+const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const scalarText = (value) => ![...value].some(char => { const n = char.codePointAt(0); return n >= 0xd800 && n <= 0xdfff; });
+const trim = (value) => value.replace(/^\p{White_Space}+|\p{White_Space}+$/gu, "");
+export const validScheduleRevision = (value) => typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+export function validScheduleDate(value) {
+    if (typeof value !== "string" || !/^(?!0000)\d{4}-\d{2}-\d{2}(?![\s\S])/.test(value))
+        return false;
+    const date = new Date(value + "T00:00:00Z");
+    return Number.isFinite(date.getTime()) && date.toISOString().slice(0, 10) === value;
+}
+export function validScheduleTime(value) {
+    if (typeof value !== "string" || !/^(?!0000)\d{4}-\d{2}-\d{2}T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d{1,9})?(Z|[+-]([01]\d|2[0-3]):[0-5]\d)(?![\s\S])/.test(value))
+        return false;
+    return validScheduleDate(value.slice(0, 10)) && Number.isFinite(Date.parse(value));
+}
+export class ScheduleProblem extends Error {
+    code;
+    humanMessage;
+    nextAction;
+    exitCode;
+    details;
+    constructor(code, humanMessage, nextAction, exitCode = 2, details = {}) {
+        super(JSON.stringify({ code, message: humanMessage, next_action: nextAction, ...details }));
+        this.code = code;
+        this.humanMessage = humanMessage;
+        this.nextAction = nextAction;
+        this.exitCode = exitCode;
+        this.details = details;
+    }
+}
+export function scheduleInvalid() {
+    throw new ScheduleProblem("invalid_arguments", "日程命令或参数无效。", "请查看本命令帮助，只提交本人确认的字段；日期用 YYYY-MM-DD，精确时间用带时区偏移的 RFC3339。");
+}
+export function scheduleKey(value) {
+    if (typeof value !== "string" || !scheduleKeyPattern.test(value))
+        return scheduleInvalid();
+    return value;
+}
+export function scheduleID(value) {
+    return scheduleUUID(value) ? value : scheduleInvalid();
+}
+export function scheduleQuery(input) {
+    const allowed = ["view", "status", "group_by", "project_id", "q", "start_date", "end_date", "limit", "offset"];
+    const out = {};
+    for (const [name, value] of Object.entries(input)) {
+        if (!allowed.includes(name))
+            scheduleInvalid();
+        if (value === undefined)
+            continue;
+        if (name === "limit" || name === "offset") {
+            if (typeof value !== "number" || !Number.isSafeInteger(value) || value < (name === "limit" ? 1 : 0) || (name === "limit" && value > 100))
+                scheduleInvalid();
+        }
+        else {
+            if (typeof value !== "string" || value === "" || !scalarText(value) || value.includes("\0"))
+                scheduleInvalid();
+            if (name === "view" && !["pending", "workbench", "recent_completed", "history"].includes(value))
+                scheduleInvalid();
+            if (name === "status" && (!["all", "completed", "cancelled"].includes(value) || input.view !== "history"))
+                scheduleInvalid();
+            if (name === "group_by" && !["date", "project"].includes(value))
+                scheduleInvalid();
+            if (name === "project_id" && value !== "none" && !scheduleUUID(value))
+                scheduleInvalid();
+            if ((name === "start_date" || name === "end_date") && !validScheduleDate(value))
+                scheduleInvalid();
+            if (name === "q" && [...trim(value)].length > 200)
+                scheduleInvalid();
+        }
+        out[name] = value;
+    }
+    if (typeof input.start_date === "string" && typeof input.end_date === "string" && input.start_date > input.end_date)
+        scheduleInvalid();
+    return out;
+}
+export function scheduleBody(operation, value) {
+    if (!record(value))
+        return scheduleInvalid();
+    const fields = operation === "create" || operation === "update" ? ["title", "due_date", "due_at", "project_id", "confirmed"] : ["confirmed"];
+    if (Object.keys(value).some(name => !fields.includes(name)) || value.confirmed !== true)
+        return scheduleInvalid();
+    if (operation === "create" && !Object.hasOwn(value, "title"))
+        scheduleInvalid();
+    if (operation === "update" && !["title", "due_date", "due_at", "project_id"].some(name => Object.hasOwn(value, name)))
+        scheduleInvalid();
+    const out = { ...value };
+    if (Object.hasOwn(value, "title")) {
+        if (typeof value.title !== "string" || !scalarText(value.title))
+            scheduleInvalid();
+        const title = trim(value.title);
+        if (!title || [...title].length > 200 || /[\p{Cc}\u2028\u2029]/u.test(title))
+            scheduleInvalid();
+        out.title = title;
+    }
+    for (const name of ["due_date", "due_at", "project_id"]) {
+        if (!Object.hasOwn(value, name))
+            continue;
+        const item = value[name];
+        if (item === null || item === "")
+            continue;
+        if (name === "due_date" ? !validScheduleDate(item) : name === "due_at" ? !validScheduleTime(item) : !scheduleUUID(item))
+            scheduleInvalid();
+    }
+    if (value.due_date && value.due_at)
+        scheduleInvalid();
+    return out;
+}
+export function scheduleUnknown(key, status) {
+    return new ScheduleProblem("write_outcome_unknown", "日程写入结果未确认，不能视为成功。", "保留原幂等键，用 schedule status 或 get_schedule_write_status 核对同一连接的回执；不要换键、自动重试或执行依赖写入。", 6, { write_status: "unknown", idempotency_key: key, ...(status === undefined ? {} : { http_status: status }) });
+}
+export function scheduleFailure(status, body, capabilities, key) {
+    if (key && (status === 202 || status >= 500))
+        return scheduleUnknown(key, status);
+    const raw = record(body) ? body.code ?? body.error : undefined;
+    const consistent = record(body) && (body.code === undefined || body.code === raw) && (body.error === undefined || body.error === raw);
+    const codes = {
+        400: ["invalid_schedule_query", "invalid_schedule_id", "invalid_idempotency_key", "invalid_schedule_revision", "invalid_schedule_input", "schedule_confirmation_required"],
+        401: ["not_authenticated"], 403: ["token_scope_insufficient", "capability_disabled", "second_confirmation_required", "legal_consent_required", "account_unavailable"],
+        404: ["schedule_not_found"], 409: ["schedule_revision_conflict", "idempotency_conflict", "schedule_closed", "schedule_undo_expired"],
+        415: ["invalid_content_type"], 429: ["rate_limited"], 503: ["schedule_unavailable"]
+    };
+    const code = consistent && typeof raw === "string" && codes[status]?.includes(raw) ? raw : "request_rejected";
+    const details = { http_status: status, ...(key ? { idempotency_key: key } : {}) };
+    if (code === "capability_disabled" && record(body) && typeof body.required_capability === "string" && capabilities.includes(body.required_capability)
+        && (!Object.hasOwn(body, "missing_sections") || Array.isArray(body.missing_sections) && body.missing_sections.length === 0))
+        details.required_capability = body.required_capability;
+    const next = status === 403 ? "请本人在网页核对账号能力、设备只读/读写范围或协议确认；不要重新授权或换入口绕过限制。"
+        : status === 409 ? "请先读取当前版本或到网页核对；撤销只在完成后的约 5 秒内有效，不自动重试或换键。"
+            : "请核对命令输入、服务版本和实际状态，不把失败或权限缺口解释为没有日程，不自动重试写入。";
+    return new ScheduleProblem(code, status === 403 ? "日程操作权限不足。" : status === 409 ? "日程状态或版本冲突，本次未确认写入。" : "日程请求未完成。", next, status === 401 ? 3 : status === 403 ? 4 : status >= 500 ? 7 : 2, details);
+}
+const buckets = ["overdue", "today", "tomorrow", "this_week", "later", "undated"];
+const countNames = [...buckets, "completed", "cancelled"];
+const natural = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+const safeText = (value) => typeof value === "string" && scalarText(value) && !/[\p{Cc}\u2028\u2029]/u.test(value);
+const projectText = (value) => typeof value === "string" && scalarText(value) && [...value].length >= 1 && [...value].length <= 80;
+function readInvalid() {
+    throw new ScheduleProblem("invalid_response", "日程读取回执无法核实。", "请核对服务版本和访问范围，不把异常响应解释为没有日程。", 7);
+}
+function projectItem(value) {
+    if (!record(value) || !scheduleUUID(value.id) || !validScheduleRevision(value.revision)
+        || !safeText(value.title) || !trim(value.title) || [...value.title].length > 200
+        || typeof value.status !== "string" || !["pending", "completed", "cancelled"].includes(value.status)
+        || !validScheduleTime(value.created_at) || !validScheduleTime(value.updated_at))
+        return readInvalid();
+    const out = { id: value.id, title: value.title, status: value.status, revision: value.revision, created_at: value.created_at, updated_at: value.updated_at };
+    for (const name of ["due_date", "due_at", "project_id", "project_title", "project_unavailable_reason", "completed_at", "cancelled_at", "undo_until", "bucket", "closed_actor_kind", "closed_actor_name"]) {
+        if (!Object.hasOwn(value, name))
+            continue;
+        const field = value[name];
+        if (name === "project_title" ? !projectText(field) : !safeText(field) || !field)
+            readInvalid();
+        if (name === "due_date" && !validScheduleDate(field) || name === "project_id" && !scheduleUUID(field)
+            || ["due_at", "completed_at", "cancelled_at", "undo_until"].includes(name) && !validScheduleTime(field)
+            || name === "bucket" && !buckets.includes(field)
+            || name === "project_unavailable_reason" && field !== "project_unavailable")
+            readInvalid();
+        out[name] = field;
+    }
+    if (out.due_date && out.due_at)
+        readInvalid();
+    if (out.project_unavailable_reason) {
+        delete out.project_id;
+        delete out.project_title;
+    }
+    else if (out.project_title && !out.project_id)
+        readInvalid();
+    return out;
+}
+export function scheduleReadResult(status, value, detail) {
+    if (status !== 200 || !record(value) || value.timezone !== "Asia/Shanghai")
+        return readInvalid();
+    if (detail)
+        return { schedule_item: projectItem(value.schedule_item), timezone: "Asia/Shanghai" };
+    if (!Array.isArray(value.items) || !Array.isArray(value.groups) || !record(value.counts)
+        || !natural(value.total) || !natural(value.offset) || !natural(value.limit) || value.limit < 1 || value.limit > 100
+        || typeof value.has_more !== "boolean")
+        return readInvalid();
+    const total = value.total, offset = value.offset, limit = value.limit;
+    const items = value.items.map(projectItem);
+    if (items.length !== Math.min(limit, Math.max(0, total - offset)) || value.has_more !== (offset < total && items.length < total - offset))
+        readInvalid();
+    const counts = {};
+    for (const name of countNames) {
+        if (!natural(value.counts[name]))
+            readInvalid();
+        counts[name] = value.counts[name];
+    }
+    if (Object.values(counts).reduce((sum, count) => sum + count, 0) !== total)
+        readInvalid();
+    const itemMap = new Map(), shownCounts = {};
+    for (const item of items) {
+        if (itemMap.has(item.id) || typeof item.bucket !== "string")
+            readInvalid();
+        itemMap.set(item.id, item);
+        const name = item.status === "pending" ? item.bucket : item.status;
+        shownCounts[name] = (shownCounts[name] ?? 0) + 1;
+        if (shownCounts[name] > counts[name])
+            readInvalid();
+    }
+    const groupKeys = new Set(), groupedIDs = new Set();
+    let groupTotal = 0;
+    const groups = value.groups.map(raw => {
+        if (!record(raw) || !safeText(raw.key) || !raw.key || groupKeys.has(raw.key)
+            || !natural(raw.total) || !natural(raw.shown) || raw.shown < 1 || raw.total < raw.shown || raw.total > total
+            || typeof raw.has_more !== "boolean" || raw.has_more !== (raw.shown < raw.total)
+            || !Array.isArray(raw.items) || raw.items.length !== raw.shown)
+            return readInvalid();
+        groupKeys.add(raw.key);
+        groupTotal += raw.total;
+        const groupItems = raw.items.map(projectItem);
+        for (const item of groupItems) {
+            const id = item.id;
+            if (groupedIDs.has(id) || !itemMap.has(id) || JSON.stringify(itemMap.get(id)) !== JSON.stringify(item))
+                readInvalid();
+            groupedIDs.add(id);
+        }
+        const group = { key: raw.key, total: raw.total, shown: raw.shown, has_more: raw.has_more, items: groupItems };
+        if (Object.hasOwn(raw, "title")) {
+            if (!projectText(raw.title))
+                readInvalid();
+            group.title = raw.title;
+        }
+        if (Object.hasOwn(raw, "project_id")) {
+            if (!scheduleUUID(raw.project_id) || raw.key !== raw.project_id)
+                readInvalid();
+            group.project_id = raw.project_id;
+        }
+        return group;
+    });
+    if (groupedIDs.size !== items.length || groupTotal > total)
+        readInvalid();
+    return { items, groups, counts, total, limit, offset, has_more: value.has_more, timezone: "Asia/Shanghai" };
+}
+export function scheduleReceipt(status, value, key) {
+    if (![200, 201].includes(status) || !record(value) || !scheduleUUID(value.id) || value.write_status !== "confirmed" || typeof value.replayed !== "boolean"
+        || value.code !== undefined || value.error !== undefined
+        || value.read_permission_missing !== undefined && typeof value.read_permission_missing !== "boolean"
+        || value.read_unavailable !== undefined && typeof value.read_unavailable !== "boolean")
+        throw scheduleUnknown(key, status);
+    const out = { id: value.id, write_status: "confirmed", replayed: value.replayed };
+    const missing = value.missing_sections;
+    if (value.read_permission_missing === true || value.read_unavailable === true || Array.isArray(missing) && missing.length > 0) {
+        const unavailable = value.read_unavailable === true;
+        const reason = unavailable ? "read_failed" : "capability_disabled";
+        if (!Array.isArray(missing) || missing.length !== 1 || !record(missing[0]) || missing[0].section !== "schedule_items"
+            || missing[0].required_capability !== "read_workbench" || missing[0].reason !== reason
+            || unavailable && value.read_permission_missing === true)
+            throw scheduleUnknown(key, status);
+        out[unavailable ? "read_unavailable" : "read_permission_missing"] = true;
+        out.missing_sections = [{ section: "schedule_items", required_capability: "read_workbench", reason }];
+    }
+    else {
+        if (missing !== undefined && (!Array.isArray(missing) || missing.length !== 0))
+            throw scheduleUnknown(key, status);
+        try {
+            out.schedule_item = projectItem(value.schedule_item);
+        }
+        catch {
+            throw scheduleUnknown(key, status);
+        }
+        if (out.schedule_item.id !== value.id)
+            throw scheduleUnknown(key, status);
+    }
+    return out;
+}
+export function isScheduleHeaderPath(path, method) {
+    return method === "GET" && path === scheduleRoot + "/m1/schedule-write-status"
+        || method === "POST" && (path === scheduleRoot + "/m2/schedule-items" || /^\/api\/v1\/agent\/m2\/schedule-items\/[^/]+\/(complete|cancel|undo)$/.test(path))
+        || method === "PATCH" && /^\/api\/v1\/agent\/m2\/schedule-items\/[^/]+$/.test(path);
+}
+export function scheduleHeaders(path, method, value) {
+    if (!record(value) || Object.keys(value).some(name => !["Idempotency-Key", "If-Match"].includes(name)))
+        return scheduleInvalid();
+    const headers = { "Idempotency-Key": scheduleKey(value["Idempotency-Key"]) };
+    const revisionRequired = method !== "GET" && path !== scheduleRoot + "/m2/schedule-items";
+    if (revisionRequired) {
+        const revision = value["If-Match"];
+        if (typeof revision !== "string" || !/^"[1-9]\d*"(?![\s\S])/.test(revision) || !validScheduleRevision(Number(revision.slice(1, -1))))
+            return scheduleInvalid();
+        headers["If-Match"] = revision;
+    }
+    else if (value["If-Match"] !== undefined)
+        scheduleInvalid();
+    return headers;
+}