@tea-agent/loop-agent 0.28.2-beta.1 → 0.28.3

package/dist/shared/operator/capabilities.js

@@ -286,6 +286,38 @@ const OFFICIAL_ACTIONS = [
             "read",
             "model-callable",
         ],
+        // Night Scheduler (Phase 5) — read surfaces via official CLI coverage;
+        // mutations use dedicated capability entries below (mutation-gate).
+        [
+            "workerAdmissionShow",
+            "agent-worker admission show",
+            "read",
+            "model-callable",
+        ],
+        [
+            "workerSchedulerList",
+            "agent-worker scheduler list",
+            "read",
+            "model-callable",
+        ],
+        [
+            "workerSchedulerStatus",
+            "agent-worker scheduler status",
+            "read",
+            "model-callable",
+        ],
+        [
+            "workerSchedulerLedger",
+            "agent-worker scheduler ledger",
+            "read",
+            "model-callable",
+        ],
+        [
+            "workerSchedulerDoctor",
+            "agent-worker scheduler doctor",
+            "read",
+            "model-callable",
+        ],
     ],
 ].map(([action, cli, kind, coverage]) => officialAction(action, cli, kind, coverage));
 /** Shared constants so dag + dagSpecVersions cannot diverge. */
@@ -955,13 +987,13 @@ export function buildOperatorCapabilitiesDocument() {
             resultSchemaVersion: 1,
             envelopeSchemaVersion: 1,
             requiredErrorCodes: ["INVALID_INPUT", "NOT_FOUND"],
-            description: "Prepare a one-shot Human Gate receipt for standaloneTaskRerun / workerTaskRetry. Model may prepare; only the browser mutation gate may consume.",
+            description: "Prepare a one-shot Human Gate receipt for standaloneTaskRerun / workerTaskRetry / Night Scheduler mutations. Model may prepare; only the browser mutation gate may consume.",
             inputParams: [
                 {
                     name: "action",
                     type: "string",
                     required: true,
-                    description: "target action: standaloneTaskRerun | workerTaskRetry",
+                    description: "target action: standaloneTaskRerun | workerTaskRetry | workerAdmissionPrepare | workerSchedulerAdd | workerSchedulerCancel | workerSchedulerHarvest | workerSchedulerDiscard",
                 },
                 {
                     name: "actionParams",
@@ -973,6 +1005,234 @@ export function buildOperatorCapabilitiesDocument() {
             modelCallable: "always",
             humanConfirmation: "none",
         },
+        {
+            action: "workerAdmissionPrepare",
+            cli: 'agent-worker admission prepare --repo . --feature-dir <path> --task-id <id> --at "YYYY-MM-DD HH:mm" [--tz Asia/Shanghai] [--task-card <ref>]',
+            kind: "long-running",
+            inputSchemaVersion: 1,
+            resultSchemaVersion: 1,
+            envelopeSchemaVersion: 1,
+            requiredErrorCodes: [
+                ...COMMON_MUTATION_ERRORS,
+                "INVALID_INPUT",
+                "HUMAN_CONFIRMATION_REQUIRED",
+            ],
+            description: "Daytime Night Scheduler admission prepare: freeze worktree + DAG writeSet gate receipt (no execute).",
+            inputParams: [
+                {
+                    name: "featureDir",
+                    type: "string",
+                    required: true,
+                    description: "feature directory path",
+                },
+                {
+                    name: "taskId",
+                    type: "string",
+                    required: true,
+                    description: "task id",
+                },
+                {
+                    name: "at",
+                    type: "string",
+                    required: true,
+                    description: 'local execute time "YYYY-MM-DD HH:mm"',
+                },
+                {
+                    name: "tz",
+                    type: "string",
+                    required: false,
+                    description: "IANA timezone (default Asia/Shanghai)",
+                },
+                {
+                    name: "taskCard",
+                    type: "string",
+                    required: false,
+                    description: "company task card / work item ref",
+                },
+                {
+                    name: "confirmationId",
+                    type: "string",
+                    required: true,
+                    description: "mutation-gate receipt id from prepareMutationGate",
+                },
+                {
+                    name: "humanGateToken",
+                    type: "object",
+                    required: true,
+                    description: "server-signed human-gate token from prepareMutationGate",
+                },
+            ],
+            modelCallable: "prepare-only",
+            humanConfirmation: "required",
+        },
+        {
+            action: "workerSchedulerAdd",
+            cli: "agent-worker scheduler add <schedule-id> --repo . --approve-gate <token>",
+            kind: "mutation",
+            inputSchemaVersion: 1,
+            resultSchemaVersion: 1,
+            envelopeSchemaVersion: 1,
+            requiredErrorCodes: [
+                ...COMMON_MUTATION_ERRORS,
+                "INVALID_INPUT",
+                "HUMAN_CONFIRMATION_REQUIRED",
+            ],
+            description: "Approve frozen night admission gate and reserve Task Pool Queued (no DAG execute).",
+            inputParams: [
+                {
+                    name: "scheduleId",
+                    type: "string",
+                    required: true,
+                    description: "schedule id",
+                },
+                {
+                    name: "approveGate",
+                    type: "string",
+                    required: true,
+                    description: "gate token from admission prepare review packet",
+                },
+                {
+                    name: "confirmationId",
+                    type: "string",
+                    required: true,
+                    description: "mutation-gate receipt id from prepareMutationGate",
+                },
+                {
+                    name: "humanGateToken",
+                    type: "object",
+                    required: true,
+                    description: "server-signed human-gate token from prepareMutationGate",
+                },
+            ],
+            modelCallable: "prepare-only",
+            humanConfirmation: "required",
+        },
+        {
+            action: "workerSchedulerCancel",
+            cli: "agent-worker scheduler cancel <schedule-id> --repo . [--reason <text>]",
+            kind: "mutation",
+            inputSchemaVersion: 1,
+            resultSchemaVersion: 1,
+            envelopeSchemaVersion: 1,
+            requiredErrorCodes: [
+                ...COMMON_MUTATION_ERRORS,
+                "INVALID_INPUT",
+                "HUMAN_CONFIRMATION_REQUIRED",
+            ],
+            description: "Cancel a non-dispatched night schedule and release Task Pool Queued reservation when bound.",
+            inputParams: [
+                {
+                    name: "scheduleId",
+                    type: "string",
+                    required: true,
+                    description: "schedule id",
+                },
+                {
+                    name: "reason",
+                    type: "string",
+                    required: false,
+                    description: "cancel reason",
+                },
+                {
+                    name: "confirmationId",
+                    type: "string",
+                    required: true,
+                    description: "mutation-gate receipt id from prepareMutationGate",
+                },
+                {
+                    name: "humanGateToken",
+                    type: "object",
+                    required: true,
+                    description: "server-signed human-gate token from prepareMutationGate",
+                },
+            ],
+            modelCallable: "prepare-only",
+            humanConfirmation: "required",
+        },
+        {
+            action: "workerSchedulerHarvest",
+            cli: "agent-worker scheduler harvest <schedule-id> --repo .",
+            kind: "mutation",
+            inputSchemaVersion: 1,
+            resultSchemaVersion: 1,
+            envelopeSchemaVersion: 1,
+            requiredErrorCodes: [
+                ...COMMON_MUTATION_ERRORS,
+                "INVALID_INPUT",
+                "HUMAN_CONFIRMATION_REQUIRED",
+            ],
+            description: "Morning harvest of a succeeded night branch via exact-base fast-forward only.",
+            inputParams: [
+                {
+                    name: "scheduleId",
+                    type: "string",
+                    required: true,
+                    description: "schedule id",
+                },
+                {
+                    name: "confirmationId",
+                    type: "string",
+                    required: true,
+                    description: "mutation-gate receipt id from prepareMutationGate",
+                },
+                {
+                    name: "humanGateToken",
+                    type: "object",
+                    required: true,
+                    description: "server-signed human-gate token from prepareMutationGate",
+                },
+            ],
+            modelCallable: "prepare-only",
+            humanConfirmation: "required",
+        },
+        {
+            action: "workerSchedulerDiscard",
+            cli: 'agent-worker scheduler discard <schedule-id> --repo . --reason "..." [--force]',
+            kind: "mutation",
+            inputSchemaVersion: 1,
+            resultSchemaVersion: 1,
+            envelopeSchemaVersion: 1,
+            requiredErrorCodes: [
+                ...COMMON_MUTATION_ERRORS,
+                "INVALID_INPUT",
+                "HUMAN_CONFIRMATION_REQUIRED",
+            ],
+            description: "Discard night worktree/branch after retaining evidence; --force required for failed/human_required.",
+            inputParams: [
+                {
+                    name: "scheduleId",
+                    type: "string",
+                    required: true,
+                    description: "schedule id",
+                },
+                {
+                    name: "reason",
+                    type: "string",
+                    required: true,
+                    description: "discard reason",
+                },
+                {
+                    name: "force",
+                    type: "boolean",
+                    required: false,
+                    description: "force discard for failed/human_required",
+                },
+                {
+                    name: "confirmationId",
+                    type: "string",
+                    required: true,
+                    description: "mutation-gate receipt id from prepareMutationGate",
+                },
+                {
+                    name: "humanGateToken",
+                    type: "object",
+                    required: true,
+                    description: "server-signed human-gate token from prepareMutationGate",
+                },
+            ],
+            modelCallable: "prepare-only",
+            humanConfirmation: "required",
+        },
         {
             action: "standaloneTaskRerun",
             cli: "loop-agent dag rerun-task --run-id <id> --reason <text> --request-id <id> [--profile auto] [--task-id <id>] --json",
@@ -1216,6 +1476,13 @@ export const OPERATOR_COMMAND_COVERAGE = Object.freeze([
         source: "loop-agent",
         exclusionReason: "Not exposed to Operator Chat in M5.",
     },
+    {
+        command: "loop-agent init upgrade",
+        coverage: "excluded",
+        action: null,
+        source: "loop-agent",
+        exclusionReason: "Not exposed to Operator Chat in M5.",
+    },
     {
         command: "loop-agent examples list",
         coverage: "excluded",
@@ -1841,6 +2108,87 @@ export const OPERATOR_COMMAND_COVERAGE = Object.freeze([
         action: "workerReportMetrics",
         source: "agent-worker",
     },
+    {
+        command: "agent-worker admission prepare",
+        coverage: "human-gated-required",
+        action: "workerAdmissionPrepare",
+        source: "agent-worker",
+    },
+    {
+        command: "agent-worker admission show",
+        coverage: "model-callable",
+        action: "workerAdmissionShow",
+        source: "agent-worker",
+    },
+    {
+        command: "agent-worker scheduler list",
+        coverage: "model-callable",
+        action: "workerSchedulerList",
+        source: "agent-worker",
+    },
+    {
+        command: "agent-worker scheduler status",
+        coverage: "model-callable",
+        action: "workerSchedulerStatus",
+        source: "agent-worker",
+    },
+    {
+        command: "agent-worker scheduler ledger",
+        coverage: "model-callable",
+        action: "workerSchedulerLedger",
+        source: "agent-worker",
+    },
+    {
+        command: "agent-worker scheduler doctor",
+        coverage: "model-callable",
+        action: "workerSchedulerDoctor",
+        source: "agent-worker",
+    },
+    {
+        command: "agent-worker scheduler add",
+        coverage: "human-gated-required",
+        action: "workerSchedulerAdd",
+        source: "agent-worker",
+    },
+    {
+        command: "agent-worker scheduler cancel",
+        coverage: "human-gated-required",
+        action: "workerSchedulerCancel",
+        source: "agent-worker",
+    },
+    {
+        command: "agent-worker scheduler harvest",
+        coverage: "human-gated-required",
+        action: "workerSchedulerHarvest",
+        source: "agent-worker",
+    },
+    {
+        command: "agent-worker scheduler discard",
+        coverage: "human-gated-required",
+        action: "workerSchedulerDiscard",
+        source: "agent-worker",
+    },
+    {
+        command: "agent-worker scheduler tick",
+        coverage: "excluded",
+        action: null,
+        source: "agent-worker",
+        exclusionReason: "Daemon/clock path; not exposed to Operator Chat (use CLI/cron).",
+    },
+    {
+        command: "agent-worker scheduler submit",
+        coverage: "excluded",
+        action: null,
+        source: "agent-worker",
+        exclusionReason: "Low-level planning fact; use admission prepare.",
+    },
+    {
+        command: "agent-worker scheduler transition",
+        coverage: "excluded",
+        action: null,
+        source: "agent-worker",
+        exclusionReason: "Internal lifecycle mutation; not Operator-facing.",
+    },
     {
         command: "agent-worker observe serve",
         coverage: "excluded",