@springbrand/agent-runtime 0.3.0-alpha.1 → 0.3.0-alpha.10

package/src/tools/schedule.ts

@@ -1,261 +0,0 @@
-import type {
-  AgentTool,
-  AgentToolResult,
-} from "@earendil-works/pi-agent-core";
-import { Type, type TSchema } from "@earendil-works/pi-ai";
-import type {
-  RuntimeSchedulePort,
-  RuntimeScheduleUpdate,
-} from "../config/ports";
-import type { ScheduleSpec } from "../submission/contracts";
-import { serializeOutput } from "../lib/artifacts";
-import type { PiToolCandidate } from "./compiler";
-
-const scheduleTriggerParameters = Type.Union([
-  Type.Object({
-    kind: Type.Literal("once-in"),
-    seconds: Type.Integer({
-      minimum: 1,
-      description: "Fire once, this many seconds from now.",
-    }),
-  }, { additionalProperties: false }),
-  Type.Object({
-    kind: Type.Literal("once-at"),
-    at: Type.String({
-      description:
-        "Fire once at this absolute UTC ISO time, e.g. 2026-07-20T09:00:00Z.",
-    }),
-  }, { additionalProperties: false }),
-  Type.Object({
-    kind: Type.Literal("cron"),
-    cron: Type.String({
-      description:
-        "Repeat on a standard UTC cron, e.g. '0 9 * * *' = daily 09:00 UTC.",
-    }),
-  }, { additionalProperties: false }),
-  Type.Object({
-    kind: Type.Literal("interval"),
-    seconds: Type.Integer({
-      minimum: 1,
-      description: "Repeat every this many seconds.",
-    }),
-  }, { additionalProperties: false }),
-], { description: "When to fire." });
-
-const scheduleParameters = Type.Object({
-  prompt: Type.String({
-    description:
-      "The standalone instruction to run when the schedule fires. The future turn has no context from this chat, so make it self-contained.",
-  }),
-  trigger: scheduleTriggerParameters,
-  label: Type.String({
-    description:
-      "A short human-readable name for this task (e.g. '每日周报提醒'). Required — it is how the user recognises the task in their schedule list and how they will refer to it when asking you to cancel it later.",
-  }),
-  timezone: Type.Optional(Type.String({
-    description:
-      "IANA timezone the clock times in `trigger` should be interpreted in, e.g. 'Asia/Shanghai'. Pass the user's own timezone whenever they state a wall-clock time. Omit only for delays and intervals. Defaults to UTC.",
-  })),
-}, { additionalProperties: false });
-
-const noParameters = Type.Object({}, { additionalProperties: false });
-const scheduleIdParameters = Type.Object({
-  id: Type.String({
-    description: "The schedule id, as returned by `list_schedules`.",
-  }),
-}, { additionalProperties: false });
-const updateScheduleParameters = Type.Object({
-  id: Type.String({ description: "The exact id returned by `list_schedules`." }),
-  prompt: Type.Optional(Type.String()),
-  trigger: Type.Optional(scheduleTriggerParameters),
-  label: Type.Optional(Type.String()),
-  timezone: Type.Optional(Type.String()),
-}, { additionalProperties: false });
-const changeScheduleAgentParameters = Type.Object({
-  id: Type.String({
-    description: "The exact schedule id returned by `list_schedules`.",
-  }),
-  userAgentId: Type.String({
-    description: "The exact User Agent id selected by the user.",
-  }),
-}, { additionalProperties: false });
-
-function result<T>(details: T): AgentToolResult<T> {
-  return {
-    content: [{ type: "text", text: serializeOutput(details).text }],
-    details,
-  };
-}
-
-function candidate<T extends TSchema>(
-  tool: AgentTool<T>,
-  options: Partial<
-    Pick<
-      PiToolCandidate,
-      "alwaysRequiresApproval" | "exposureMode" | "owner" | "requiredExecutionLevel" | "retry" | "summary"
-    >
-  > = {},
-): PiToolCandidate {
-  return {
-    owner: options.owner ?? "runtime-base",
-    exposureMode: options.exposureMode ?? "direct",
-    requiredExecutionLevel: options.requiredExecutionLevel ?? "safe",
-    source: "action",
-    tool,
-    ...(options.alwaysRequiresApproval
-      ? { alwaysRequiresApproval: true }
-      : {}),
-    ...(options.summary ? { summary: options.summary } : {}),
-    ...(options.retry ? { retry: options.retry } : {}),
-  };
-}
-
-export function schedulePiToolCandidates(
-  schedule: RuntimeSchedulePort,
-): PiToolCandidate[] {
-  return [
-    candidate(
-      {
-        name: "schedule",
-        label: "Schedule prompt",
-        description:
-          "Schedule a prompt to run LATER, autonomously. Use when the user asks to be reminded, or to run something after a delay / at a time / on a recurring basis. The user always reviews the proposed schedule before it is created. The scheduled prompt runs in its own dedicated session at each trigger with NO memory of this conversation, so phrase `prompt` as a fully standalone instruction. After scheduling, tell the user what you set.",
-        parameters: scheduleParameters,
-        async execute(_toolCallId, input, signal) {
-          signal?.throwIfAborted();
-          const spec: ScheduleSpec = {
-            trigger: input.trigger,
-            job: { kind: "prompt", prompt: input.prompt },
-            label: input.label,
-            ...(input.timezone ? { tz: input.timezone } : {}),
-          };
-          const { id } = await schedule.create(spec);
-          return result({ scheduled: true, id });
-        },
-      },
-      {
-        alwaysRequiresApproval: true,
-        exposureMode: "direct",
-        summary: "Create a scheduled task",
-      },
-    ),
-    candidate(
-      {
-        name: "list_schedules",
-        label: "List schedules",
-        description:
-          "List the user's existing scheduled tasks. Call this when the user asks what they have scheduled, or before cancelling one — you need the id, and the user will refer to a task by what it does, not by its id.",
-        parameters: noParameters,
-        async execute(_toolCallId, _input, signal) {
-          signal?.throwIfAborted();
-          return result({ schedules: await schedule.list() });
-        },
-      },
-      { retry: "idempotent" },
-    ),
-    candidate({
-      name: "update_schedule",
-      label: "Update schedule",
-      description:
-        "Update one scheduled task without changing its id or history. Call `list_schedules` first and use an exact id. If multiple tasks plausibly match the user's wording, ask which one instead of guessing.",
-      parameters: updateScheduleParameters,
-      async execute(_toolCallId, input, signal) {
-        signal?.throwIfAborted();
-        const changes: RuntimeScheduleUpdate = {
-          ...(input.prompt !== undefined ? { prompt: input.prompt } : {}),
-          ...(input.trigger !== undefined ? { trigger: input.trigger } : {}),
-          ...(input.label !== undefined ? { label: input.label } : {}),
-          ...(input.timezone !== undefined ? { tz: input.timezone } : {}),
-        };
-        const { ok } = await schedule.update(input.id, changes);
-        return result({ updated: ok, id: input.id });
-      },
-    }),
-    candidate({
-      name: "pause_schedule",
-      label: "Pause schedule",
-      description:
-        "Pause one scheduled task. Call `list_schedules` first and use an exact id; ask the user if the target is ambiguous.",
-      parameters: scheduleIdParameters,
-      async execute(_toolCallId, input, signal) {
-        signal?.throwIfAborted();
-        const { ok } = await schedule.pause(input.id);
-        return result({ paused: ok, id: input.id });
-      },
-    }),
-    candidate({
-      name: "resume_schedule",
-      label: "Resume schedule",
-      description:
-        "Resume one paused scheduled task. Call `list_schedules` first and use an exact id; ask the user if the target is ambiguous.",
-      parameters: scheduleIdParameters,
-      async execute(_toolCallId, input, signal) {
-        signal?.throwIfAborted();
-        const { ok } = await schedule.resume(input.id);
-        return result({ resumed: ok, id: input.id });
-      },
-    }),
-    candidate(
-      {
-        name: "cancel_schedule",
-        label: "Cancel schedule",
-        description:
-          "Cancel a scheduled task by id. Call `list_schedules` first to find the id that matches what the user described. If more than one plausibly matches, ask the user which one instead of guessing — cancelling is not reversible.",
-        parameters: scheduleIdParameters,
-        async execute(_toolCallId, input, signal) {
-          signal?.throwIfAborted();
-          const { ok } = await schedule.cancel(input.id);
-          return result(ok
-            ? { cancelled: true, id: input.id }
-            : {
-              cancelled: false,
-              id: input.id,
-              reason: "no schedule with that id",
-            });
-        },
-      },
-      {
-        requiredExecutionLevel: "high",
-        summary: "Cancel a scheduled task",
-      },
-    ),
-    candidate(
-      {
-        name: "list_user_agents",
-        label: "List User Agents",
-        description:
-          "List the enabled User Agents available for scheduled tasks. " +
-          "Use this before changing a schedule Agent.",
-        parameters: noParameters,
-        async execute(_toolCallId, _input, signal) {
-          signal?.throwIfAborted();
-          return result({ agents: await schedule.listAgents() });
-        },
-      },
-      { owner: "schedule-host" },
-    ),
-    candidate(
-      {
-        name: "change_schedule_agent",
-        label: "Change schedule Agent",
-        description:
-          "Change which User Agent executes one scheduled task without " +
-          "changing its id or history. Call `list_schedules` and " +
-          "`list_user_agents` first and use exact ids; ask the user when " +
-          "the target is ambiguous.",
-        parameters: changeScheduleAgentParameters,
-        async execute(_toolCallId, input, signal) {
-          signal?.throwIfAborted();
-          const { ok } = await schedule.changeAgent(
-            input.id,
-            input.userAgentId,
-          );
-          return result({ updated: ok, id: input.id });
-        },
-      },
-      { owner: "schedule-host" },
-    ),
-  ];
-}
-
-/** 从 {@link RuntimeSchedulePort} 生成定时任务 Tool 集。 */