@sema-agent/core 1.279.0

package/dist/tools/gitea-issue.js

@@ -0,0 +1,74 @@
+import { Type } from "typebox";
+export function createGiteaIssueTool(opts) {
+    const doFetch = opts.fetchImpl ?? fetch;
+    const root = opts.baseUrl.replace(/\/+$/, "");
+    const url = `${root}/api/v1/repos/${encodeURIComponent(opts.owner)}/${encodeURIComponent(opts.repo)}/issues`;
+    const properties = {
+        title: Type.String({ description: "A concise, specific issue title." }),
+        body: Type.Optional(Type.String({ description: "Markdown body: what's wrong / what's wanted, steps, context, and any evidence." })),
+    };
+    if (opts.allowModelLabels) {
+        properties.labels = Type.Optional(Type.Array(Type.Integer(), { description: "Optional Gitea label IDs (numeric) to tag this issue." }));
+    }
+    return {
+        name: opts.name ?? "open_gitea_issue",
+        effect: "write",
+        egress: true,
+        description: opts.description ??
+            `Open an issue in the ${opts.owner}/${opts.repo} repository to report a bug or file a request ` +
+                `to the maintainer. Use it when something is broken or missing and you cannot fix it yourself. ` +
+                `Provide a clear title and a body with the problem, steps, and any evidence.`,
+        parameters: Type.Object(properties),
+        execute: async (args, ctx) => {
+            const a = args;
+            const title = String(a.title ?? "").trim();
+            if (!title) {
+                return { content: "Issue not created: a non-empty title is required.", details: { error: "empty title" } };
+            }
+            const modelLabels = opts.allowModelLabels && Array.isArray(a.labels) ? a.labels : [];
+            const labels = [...new Set([...(opts.defaultLabels ?? []), ...modelLabels])];
+            const payload = { title };
+            if (a.body !== undefined && a.body !== null)
+                payload.body = String(a.body);
+            if (labels.length > 0)
+                payload.labels = labels;
+            let res;
+            try {
+                res = await doFetch(url, {
+                    method: "POST",
+                    headers: { "content-type": "application/json", authorization: `token ${opts.token}` },
+                    body: JSON.stringify(payload),
+                    signal: ctx.signal,
+                });
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                return { content: `Issue not created: request failed (${msg}).`, details: { error: msg } };
+            }
+            if (!res.ok) {
+                const detail = await res.text().catch(() => "");
+                return {
+                    content: `Issue not created: Gitea returned HTTP ${res.status}. ${detail.slice(0, 300)}`,
+                    details: { status: res.status },
+                };
+            }
+            const PARSE_FAILED = Symbol("json-parse-failed");
+            const parsed = (await res.json().catch(() => PARSE_FAILED));
+            const number = parsed !== PARSE_FAILED && typeof parsed.number === "number" ? parsed.number : undefined;
+            if (number === undefined) {
+                return {
+                    content: `Issue request returned HTTP ${res.status} but the response body was not a valid issue ` +
+                        `(no number) — the issue may NOT have been created; verify before retrying.`,
+                    details: { status: res.status, parsed: parsed === PARSE_FAILED ? "unparseable" : "no-number" },
+                };
+            }
+            const issue = parsed;
+            const link = issue.html_url ? ` — ${issue.html_url}` : "";
+            return {
+                content: `Opened issue #${number} in ${opts.owner}/${opts.repo}${link}`,
+                details: { number, url: issue.html_url },
+            };
+        },
+    };
+}
+//# sourceMappingURL=gitea-issue.js.map

package/dist/tools/gitea-issue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitea-issue.js","sourceRoot":"","sources":["../../src/tools/gitea-issue.ts"],"names":[],"mappings":"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"}

package/dist/tools/monitor.d.ts

@@ -0,0 +1,20 @@
+import type { AgentTool, ExecutionEnv } from "../internal/harness.js";
+import { type MonitorTimers, type TaskRegistry } from "../core/task-registry.js";
+import type { TaskNotificationPayload } from "../core/task-notification.js";
+export interface MonitorToolOptions {
+    registry: TaskRegistry;
+    owner?: string;
+    scope?: string;
+    sessionId?: string;
+    onTaskNotification?: (n: TaskNotificationPayload, opts?: {
+        priority?: "now" | "next" | "later";
+    }) => void;
+    cwdRef?: {
+        current: string;
+    };
+    timers?: MonitorTimers;
+    batchWindowMs?: number;
+    maxBatchesPerMinute?: number;
+}
+export declare function createMonitorTool(env: ExecutionEnv, opts: MonitorToolOptions): AgentTool;
+//# sourceMappingURL=monitor.d.ts.map

package/dist/tools/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../src/tools/monitor.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtE,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,YAAY,CAAC;IAEvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,kBAAkB,CAAC,EAAE,CAAC,CAAC,EAAE,uBAAuB,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAE1G,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAE7B,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAmBD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,GAAG,SAAS,CAuFxF"}

package/dist/tools/monitor.js

@@ -0,0 +1,90 @@
+import { Type } from "typebox";
+import { defineTool } from "../core/tools.js";
+import { hasBackgroundShell } from "../core/background-shell.js";
+import { MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, } from "../core/task-registry.js";
+const MONITOR_DESCRIPTION = "Run a shell command in the background and watch its stdout as a stream of events.\n" +
+    "\n" +
+    "- Each line the command writes to stdout becomes a notification event delivered to you between turns; " +
+    "multiple lines arriving within a short window (~200ms) are batched into a single notification.\n" +
+    "- When the command exits, the watch ends and one final notification reports its exit code. A watch that " +
+    `exceeds its timeout is killed and reported (default ${MONITOR_DEFAULT_TIMEOUT_MS}ms, max ${MONITOR_MAX_TIMEOUT_MS}ms).\n` +
+    "- stderr does NOT trigger notifications, but it is captured — read it any time with TaskOutput(task_id), " +
+    "which also serves the full re-readable stdout spool.\n" +
+    "- A monitor that produces too many events is stopped automatically (the stop notification says why).\n" +
+    "- Set persistent: true for a session-resident watch with no timeout; stop it with TaskStop(task_id) or it " +
+    "ends when the session is released.\n" +
+    "- After starting a monitor you do not need to poll — end your turn if nothing else is pending; events will " +
+    "reach you as notifications.\n" +
+    "- Use this for logs, dev servers, build watchers, or any wait-for-a-condition loop (e.g. `tail -f app.log`, " +
+    "or a script that prints a line only when the condition it checks changes).";
+export function createMonitorTool(env, opts) {
+    return defineTool({
+        name: "Monitor",
+        description: MONITOR_DESCRIPTION,
+        parameters: Type.Object({
+            command: Type.String({
+                description: "The shell script to run and watch. Each line it writes to stdout becomes an event; when it exits, the watch ends and the exit code is reported.",
+            }),
+            description: Type.String({
+                description: "Short human-readable label for this watch, shown in every notification it produces.",
+            }),
+            timeout_ms: Type.Optional(Type.Number({
+                description: `How long the watch may run before it is killed, in milliseconds (default ${MONITOR_DEFAULT_TIMEOUT_MS}, max ${MONITOR_MAX_TIMEOUT_MS}). Ignored when persistent is true.`,
+            })),
+            persistent: Type.Optional(Type.Boolean({
+                description: "Set to true for a session-resident monitor with no timeout (default false). It keeps watching until you stop it with TaskStop or the session ends.",
+            })),
+        }),
+        effect: "write",
+        execute: async (args, ctx) => {
+            const { command, description, timeout_ms, persistent } = args;
+            if (!hasBackgroundShell(env)) {
+                return "Error (Monitor): this environment does not support background processes.";
+            }
+            const isPersistent = persistent === true;
+            const timeoutMs = Math.min(MONITOR_MAX_TIMEOUT_MS, Math.max(1, Math.floor(timeout_ms ?? MONITOR_DEFAULT_TIMEOUT_MS)));
+            const spawn = await env.spawnBackground(command, {
+                ...(opts.cwdRef !== undefined ? { cwd: opts.cwdRef.current } : {}),
+                ...(isPersistent ? {} : { timeout: Math.ceil(timeoutMs / 1000) + 5 }),
+            });
+            if (!spawn.ok)
+                return `Error (Monitor): ${spawn.error.message}`;
+            const sessionScoped = isPersistent && opts.sessionId !== undefined;
+            const owner = sessionScoped ? opts.sessionId : (ctx.taskId ?? opts.owner);
+            const scope = ctx.principal ?? opts.scope;
+            const onNotify = opts.onTaskNotification;
+            let taskId;
+            try {
+                taskId = opts.registry.registerMonitor({
+                    env,
+                    shellId: spawn.value.shellId,
+                    description,
+                    toolUseId: ctx.toolCallId,
+                    ...(owner !== undefined ? { owner } : {}),
+                    ...(scope !== undefined ? { scope } : {}),
+                    persistent: isPersistent,
+                    ...(sessionScoped ? { sessionScoped: true } : {}),
+                    ...(isPersistent ? {} : { timeoutMs }),
+                    ...(onNotify !== undefined ? { onEvent: (n) => onNotify(n, { priority: "later" }) } : {}),
+                    ...(opts.timers !== undefined ? { timers: opts.timers } : {}),
+                    ...(opts.batchWindowMs !== undefined ? { batchWindowMs: opts.batchWindowMs } : {}),
+                    ...(opts.maxBatchesPerMinute !== undefined ? { maxBatchesPerMinute: opts.maxBatchesPerMinute } : {}),
+                });
+            }
+            catch (e) {
+                await env.killBackground(spawn.value.shellId).catch(() => undefined);
+                return `Error (Monitor): the watch process was started but could not be registered (${e instanceof Error ? e.message : String(e)}); it has been terminated.`;
+            }
+            const lifetime = isPersistent
+                ? "It is persistent: no timeout — it runs until you stop it or the session ends."
+                : `It will be killed after ${timeoutMs}ms if still running.`;
+            return onNotify !== undefined
+                ? `Monitoring in background; task_id=${taskId}. Each stdout line becomes a notification event (lines within ` +
+                    `~200ms are batched); you'll get a final notification with the exit code when it ends — do not poll. ` +
+                    `${lifetime} TaskOutput("${taskId}") reads the full spool (stdout+stderr); TaskStop("${taskId}") stops the watch.`
+                : `Monitoring in background; task_id=${taskId}. No notification channel is wired in this mount — read output with ` +
+                    `TaskOutput("${taskId}") (re-readable spool, stdout+stderr) and stop with TaskStop("${taskId}"). ${lifetime}`;
+        },
+    });
+}
+//# sourceMappingURL=monitor.js.map

package/dist/tools/monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.js","sourceRoot":"","sources":["../../src/tools/monitor.ts"],"names":[],"mappings":"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"}

package/dist/tools/scheduler-tools.d.ts

@@ -0,0 +1,15 @@
+import type { AgentTool, ExecutionEnv } from "../internal/harness.js";
+export declare const SCHEDULE_WAKEUP_TOOL_NAME = "ScheduleWakeup";
+export declare const AUTONOMOUS_LOOP_SENTINEL = "<<autonomous-loop>>";
+export declare const AUTONOMOUS_LOOP_DYNAMIC_SENTINEL = "<<autonomous-loop-dynamic>>";
+export interface SchedulerToolContext {
+    scope: string;
+    principal?: string;
+    sessionId?: string;
+    taskConfig?: unknown;
+    requestStopAfterTurn?: () => void;
+}
+export declare function cronScheduleError(expr: string): string | null;
+export declare function cronToHuman(expr: string): string;
+export declare function createSchedulerTools(env: ExecutionEnv, ctx: SchedulerToolContext): AgentTool[];
+//# sourceMappingURL=scheduler-tools.d.ts.map

package/dist/tools/scheduler-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler-tools.d.ts","sourceRoot":"","sources":["../../src/tools/scheduler-tools.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAWtE,eAAO,MAAM,yBAAyB,mBAAmB,CAAC;AAE1D,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAE9D,eAAO,MAAM,gCAAgC,gCAAgC,CAAC;AA4C9E,MAAM,WAAW,oBAAoB;IAEnC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IAGrB,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;CACnC;AAuED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkC7D;AASD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BhD;AAKD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,oBAAoB,GAAG,SAAS,EAAE,CAkQ9F"}

package/dist/tools/scheduler-tools.js

@@ -0,0 +1,338 @@
+import { Type } from "typebox";
+import { defineTool } from "../core/tools.js";
+import { hasScheduler, isValidCronExpr, } from "../core/scheduler.js";
+export const SCHEDULE_WAKEUP_TOOL_NAME = "ScheduleWakeup";
+export const AUTONOMOUS_LOOP_SENTINEL = "<<autonomous-loop>>";
+export const AUTONOMOUS_LOOP_DYNAMIC_SENTINEL = "<<autonomous-loop-dynamic>>";
+const WAKEUP_LABEL = "loop-wakeup";
+const SCHEDULE_WAKEUP_PROMPT = `Schedule when to resume work in /loop dynamic mode — the user invoked /loop without an interval, asking you to self-pace iterations of a specific task.
+
+Do NOT schedule a short-interval wakeup to poll for background work you started — when harness-tracked work finishes, you are re-invoked automatically, so polling is wasted. Instead schedule a long fallback (1200s+) so the loop survives if the work hangs or never notifies. The exception is external work the harness cannot track (a CI run, a deploy, a remote queue) — there, pick a delay matched to how fast that state actually changes.
+
+Pass the same /loop prompt back via \`prompt\` each turn so the next firing repeats the task. For an autonomous /loop (no user prompt), pass the literal sentinel \`${AUTONOMOUS_LOOP_DYNAMIC_SENTINEL}\` as \`prompt\` instead — the runtime resolves it back to the autonomous-loop instructions at fire time. (There is a similar \`${AUTONOMOUS_LOOP_SENTINEL}\` sentinel for CronCreate-based autonomous loops; do not confuse the two — ${SCHEDULE_WAKEUP_TOOL_NAME} always uses the \`-dynamic\` variant.) To end the loop, call this tool with \`stop: true\` (omit every other field) — the loop ends immediately and no further wakeups fire.
+
+## Picking delaySeconds
+
+The provider prompt cache decides how expensive a wake-up is: waking inside the cache TTL re-reads your conversation context cached (fast, cheap); waking past it re-reads everything uncached. The TTL depends on the provider route this session uses — Anthropic-family routes default to about 5 minutes (1-hour optional), while some routes (e.g. DeepSeek) typically retain unused prefixes for hours, with no guaranteed TTL.
+
+In either regime: never schedule extra wakeups just to keep the cache warm — they cost more than the cache miss they avoid. Match the delay to what you're actually waiting for: when actively polling external state the harness can't notify you about (a CI run, a deploy, a remote queue), pick the delay from how fast that state actually changes; for idle ticks with no specific signal to watch, default to **1200s–1800s** (20–30 min) — the user can always interrupt if they need you sooner.
+
+If this session's route uses a short (~5-minute) cache TTL, two refinements: under 300s (60s–270s) the cache stays warm, so prefer 270s over 300s when actively polling (300s is the worst-of-both — you pay the miss without amortizing it); and commit to 1200s+ rather than repeated ~300s waits, so one cache miss buys a long wait. On routes with hours-long cache retention, skip these refinements — any delay in the clamp range re-reads your context cached, so pick purely from the signal you're waiting for.
+
+The runtime clamps to [60, 3600], so you don't need to clamp yourself.
+
+## The reason field
+
+One short sentence on what you chose and why. Goes to telemetry and is shown back to the user. "watching CI run" beats "waiting." The user reads this to understand what you're doing without having to predict your cadence in advance — make it specific.
+`;
+function toSchedulerContext(c) {
+    return {
+        scope: c.scope,
+        ...(c.principal !== undefined ? { principal: c.principal } : {}),
+        ...(c.sessionId !== undefined ? { sessionId: c.sessionId } : {}),
+        ...(c.taskConfig !== undefined ? { taskConfig: c.taskConfig } : {}),
+    };
+}
+const CRON_FIELD_RANGES = [
+    { min: 0, max: 59 },
+    { min: 0, max: 23 },
+    { min: 1, max: 31 },
+    { min: 1, max: 12 },
+    { min: 0, max: 6 },
+];
+const CRON_FIELD_NAMES = ["minute", "hour", "day-of-month", "month", "day-of-week"];
+const MAX_DAYS_IN_MONTH = [31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+function expandCronField(field, { min, max }) {
+    const out = new Set();
+    const isDow = min === 0 && max === 6;
+    for (const part of field.split(",")) {
+        const step = part.match(/^\*(?:\/(\d+))?$/);
+        if (step) {
+            const n = step[1] ? parseInt(step[1], 10) : 1;
+            if (n < 1)
+                return null;
+            for (let i = min; i <= max; i += n)
+                out.add(i);
+            continue;
+        }
+        const range = part.match(/^(\d+)-(\d+)(?:\/(\d+))?$/);
+        if (range) {
+            const lo = parseInt(range[1] ?? "", 10);
+            const hi = parseInt(range[2] ?? "", 10);
+            const n = range[3] ? parseInt(range[3], 10) : 1;
+            const effMax = isDow ? 7 : max;
+            if (lo > hi || n < 1 || lo < min || hi > effMax)
+                return null;
+            for (let i = lo; i <= hi; i += n)
+                out.add(isDow && i === 7 ? 0 : i);
+            continue;
+        }
+        if (/^\d+$/.test(part)) {
+            let n = parseInt(part, 10);
+            if (isDow && n === 7)
+                n = 0;
+            if (n < min || n > max)
+                return null;
+            out.add(n);
+            continue;
+        }
+        return null;
+    }
+    return out.size > 0 ? [...out].sort((a, b) => a - b) : null;
+}
+export function cronScheduleError(expr) {
+    const parts = expr.trim().split(/\s+/);
+    let std = parts;
+    if (parts.length === 6) {
+        if (!expandCronField(parts[0] ?? "", { min: 0, max: 59 })) {
+            return `invalid seconds field "${parts[0]}" — allowed 0-59 (syntax: N, N-M, */N, comma lists).`;
+        }
+        std = parts.slice(1);
+    }
+    else if (parts.length !== 5) {
+        return `expected 5 fields (minute hour day-of-month month day-of-week) or 6 with leading seconds, got ${parts.length}.`;
+    }
+    const expanded = [];
+    for (let i = 0; i < 5; i++) {
+        const r = CRON_FIELD_RANGES[i];
+        const vals = expandCronField(std[i] ?? "", r);
+        if (!vals)
+            return `invalid ${CRON_FIELD_NAMES[i]} field "${std[i]}" — allowed ${r.min}-${r.max} (syntax: N, N-M, */N, comma lists).`;
+        expanded.push(vals);
+    }
+    const dom = expanded[2];
+    const month = expanded[3];
+    const dow = expanded[4];
+    const domWild = dom.length === 31;
+    const dowWild = dow.length === 7;
+    if (!domWild && dowWild) {
+        const fires = month.some((mo) => dom.some((d) => d <= (MAX_DAYS_IN_MONTH[mo - 1] ?? 31)));
+        if (!fires) {
+            return (`it never fires — day-of-month ${dom.join(",")} does not exist in month(s) ${month.join(",")} ` +
+                `(e.g. February has at most 29 days). Pick a real calendar date.`);
+        }
+    }
+    return null;
+}
+const DAY_NAMES = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+export function cronToHuman(expr) {
+    const parts = expr.trim().split(/\s+/);
+    const std = parts.length === 6 ? parts.slice(1) : parts;
+    if (std.length !== 5)
+        return expr;
+    const [minute = "", hour = "", dom = "", month = "", dow = ""] = std;
+    if (dom !== "*" || month !== "*")
+        return expr;
+    const everyMin = minute.match(/^\*\/(\d+)$/);
+    if (everyMin && hour === "*" && dow === "*") {
+        const n = parseInt(everyMin[1] ?? "", 10);
+        return n === 1 ? "every minute" : `every ${n} minutes`;
+    }
+    if (!/^\d+$/.test(minute))
+        return expr;
+    const m = parseInt(minute, 10);
+    const mm = `:${m.toString().padStart(2, "0")}`;
+    if (hour === "*" && dow === "*")
+        return m === 0 ? "every hour" : `every hour at ${mm}`;
+    const everyHour = hour.match(/^\*\/(\d+)$/);
+    if (everyHour && dow === "*") {
+        const n = parseInt(everyHour[1] ?? "", 10);
+        const suffix = m === 0 ? "" : ` at ${mm}`;
+        return n === 1 ? `every hour${suffix}` : `every ${n} hours${suffix}`;
+    }
+    if (!/^\d+$/.test(hour))
+        return expr;
+    const time = `${parseInt(hour, 10)}${mm}`;
+    if (dow === "*")
+        return `daily at ${time}`;
+    if (/^\d$/.test(dow))
+        return `weekly on ${DAY_NAMES[parseInt(dow, 10) % 7]} at ${time}`;
+    if (dow === "1-5")
+        return `weekdays at ${time}`;
+    return expr;
+}
+export function createSchedulerTools(env, ctx) {
+    if (!hasScheduler(env))
+        return [];
+    const sched = env;
+    const schedCtx = toSchedulerContext(ctx);
+    const cronCreateDescription = `Schedule a prompt to be enqueued at a future time. Use for both recurring schedules and one-shot reminders. The task runs UNATTENDED when it fires, so write a fully self-contained \`prompt\` (it will not see this conversation). Use CronList to see what you've scheduled, CronDelete to remove one.
+
+## One-shot tasks (schedule kind "delay" or "at")
+For "remind me at X" / "in N minutes, do Y" — fire once:
+- "check the deploy in 30 minutes" → schedule: { "kind": "delay", "delaySec": 1800 }
+- "tomorrow at 8:57am, run the smoke test" → schedule: { "kind": "at", "atMs": <epoch ms of that local time> }
+
+## Recurring jobs (schedule kind "cron")
+Uses standard 5-field cron in the user's local timezone: minute hour day-of-month month day-of-week. "0 9 * * *" means 9am local — no timezone conversion needed:
+- "every 5 minutes" → schedule: { "kind": "cron", "expr": "*/5 * * * *" }
+- "hourly" → { "kind": "cron", "expr": "7 * * * *" }
+- "weekdays around 9am" → { "kind": "cron", "expr": "57 8 * * 1-5" }
+
+## Avoid the :00 and :30 minute marks when the task allows it
+Every user who asks for "9am" gets \`0 9\`, and every user who asks for "hourly" gets \`0 *\` — which means requests from across the planet land at the same instant. When the user's request is approximate, pick a minute that is NOT 0 or 30:
+- "every morning around 9" → "57 8 * * *" or "3 9 * * *" (not "0 9 * * *")
+- "hourly" → "7 * * * *" (not "0 * * * *")
+- "in an hour or so, remind me to..." → pick whatever delaySec you land on, don't round
+Only use minute 0 or 30 when the user names that exact time and clearly means it ("at 9:00 sharp", "at half past", coordinating with a meeting). When in doubt, nudge a few minutes early or late — the user will not notice, and the fleet will.`;
+    const cronCreate = defineTool({
+        name: "CronCreate",
+        description: cronCreateDescription,
+        parameters: Type.Object({
+            prompt: Type.String({ description: "Self-contained instructions for the future task (it runs unattended)." }),
+            schedule: Type.Union([
+                Type.Object({ kind: Type.Literal("cron"), expr: Type.String({ description: "5- or 6-field cron expression." }) }),
+                Type.Object({ kind: Type.Literal("at"), atMs: Type.Number({ description: "Absolute epoch ms to fire once." }) }),
+                Type.Object({ kind: Type.Literal("delay"), delaySec: Type.Number({ description: "Seconds from now to fire once." }) }),
+            ], { description: "When to fire." }),
+            label: Type.Optional(Type.String({ description: "Short label (also a dedup key with the schedule)." })),
+        }),
+        effect: "write",
+        execute: async (args) => {
+            const a = args;
+            if (a.schedule.kind === "cron") {
+                if (!isValidCronExpr(a.schedule.expr)) {
+                    return `Error (CronCreate): invalid cron expression "${a.schedule.expr}" — only 5/6 space-separated cron fields (digits and * / , -) are allowed.`;
+                }
+                const deepErr = cronScheduleError(a.schedule.expr);
+                if (deepErr)
+                    return `Error (CronCreate): cron expression "${a.schedule.expr}" — ${deepErr}`;
+            }
+            const intent = {
+                prompt: a.prompt,
+                when: a.schedule,
+                ...(a.label !== undefined ? { label: a.label } : {}),
+            };
+            const r = await sched.schedule(intent, schedCtx);
+            if (!r.ok)
+                return `Error (CronCreate): ${r.error.message}`;
+            const humanSchedule = a.schedule.kind === "cron"
+                ? cronToHuman(a.schedule.expr)
+                : a.schedule.kind === "delay"
+                    ? `once in ${a.schedule.delaySec}s`
+                    : `once at ${new Date(a.schedule.atMs).toISOString()}`;
+            return {
+                content: `Scheduled task ${r.value.id}${a.label ? ` (${a.label})` : ""}.`,
+                details: { type: "cron-create", id: r.value.id, humanSchedule, recurring: a.schedule.kind === "cron" },
+            };
+        },
+    });
+    const cronCancel = defineTool({
+        name: "CronDelete",
+        description: "Cancel a cron job previously scheduled with CronCreate. Idempotent; ids also appear in CronList.",
+        parameters: Type.Object({ id: Type.String({ description: "Job ID returned by CronCreate." }) }),
+        effect: "idempotent",
+        execute: async (args) => {
+            const { id } = args;
+            const r = await sched.cancel(id, schedCtx);
+            if (!r.ok) {
+                if (r.error.code === "not_found")
+                    return `CronDelete: no scheduled task "${id}" (already gone or not yours).`;
+                return `Error (CronDelete): ${r.error.message}`;
+            }
+            return { content: `Cancelled scheduled task ${id}.`, details: { type: "cron-delete", id } };
+        },
+    });
+    const cronList = defineTool({
+        name: "CronList",
+        description: "List all cron jobs scheduled via CronCreate (id, when, label).",
+        parameters: Type.Object({}),
+        effect: "read",
+        execute: async () => {
+            const r = await sched.list(schedCtx);
+            if (!r.ok)
+                return `Error (CronList): ${r.error.message}`;
+            if (r.value.length === 0) {
+                return { content: "No scheduled tasks.", details: { type: "cron-list", jobs: [] } };
+            }
+            const content = r.value
+                .map((s) => {
+                const human = cronToHuman(s.when);
+                return `- ${s.id}: ${s.when}${human !== s.when ? ` — ${human}` : ""}${s.label ? ` (${s.label})` : ""}`;
+            })
+                .join("\n");
+            const jobs = r.value.map((s) => {
+                const human = cronToHuman(s.when);
+                return { id: s.id, cron: s.when, humanSchedule: human !== s.when ? human : s.when, ...(s.label !== undefined ? { label: s.label } : {}) };
+            });
+            return { content, details: { type: "cron-list", jobs } };
+        },
+    });
+    const listPendingWakeups = async () => {
+        const r = await sched.list(schedCtx);
+        if (!r.ok)
+            return { err: r.error.message };
+        return {
+            ids: r.value
+                .filter((s) => s.mode === "session-wakeup" || (s.mode === undefined && s.label === WAKEUP_LABEL))
+                .map((s) => s.id),
+        };
+    };
+    const cancelWakeups = async (ids) => {
+        let n = 0;
+        for (const id of ids) {
+            const r = await sched.cancel(id, schedCtx);
+            if (r.ok)
+                n += 1;
+        }
+        return n;
+    };
+    let wakeupChain = Promise.resolve();
+    const serializedWakeupOp = (fn) => {
+        const next = wakeupChain.then(fn, fn);
+        wakeupChain = next.then(() => undefined, () => undefined);
+        return next;
+    };
+    const scheduleWakeup = defineTool({
+        name: SCHEDULE_WAKEUP_TOOL_NAME,
+        description: SCHEDULE_WAKEUP_PROMPT,
+        parameters: Type.Object({
+            delaySeconds: Type.Optional(Type.Number({
+                description: "Seconds from now to wake up. Clamped to [60, 3600] by the runtime. Required unless `stop` is true.",
+            })),
+            reason: Type.Optional(Type.String({
+                description: "One short sentence explaining the chosen delay. Goes to telemetry and is shown to the user. Be specific. Required unless `stop` is true.",
+            })),
+            prompt: Type.Optional(Type.String({
+                description: `The /loop input to fire on wake-up. Pass the same /loop input verbatim each turn so the next firing re-enters the skill and continues the loop. For autonomous /loop (no user prompt), pass the literal sentinel \`${AUTONOMOUS_LOOP_DYNAMIC_SENTINEL}\` instead (the dynamic-pacing variant, not the CronCreate-mode \`${AUTONOMOUS_LOOP_SENTINEL}\`). Required unless \`stop\` is true.`,
+            })),
+            stop: Type.Optional(Type.Boolean({
+                description: "Immediately end the dynamic loop: cancel this session's pending wakeup(s) and schedule nothing. All other fields are ignored when true.",
+            })),
+        }),
+        effect: "write",
+        execute: async (args) => serializedWakeupOp(async () => {
+            const a = args;
+            if (a.stop === true) {
+                const pending = await listPendingWakeups();
+                if ("err" in pending)
+                    return `Error (${SCHEDULE_WAKEUP_TOOL_NAME}): ${pending.err}`;
+                const cancelledWakeups = await cancelWakeups(pending.ids);
+                return {
+                    content: `Loop stopped. Cancelled ${cancelledWakeups} pending wakeup(s); recurring cron tasks are unaffected.`,
+                    details: { type: "schedule-wakeup", stopped: true, cancelledWakeups, scheduledFor: 0, clampedDelaySeconds: 0, wasClamped: false },
+                };
+            }
+            if (a.delaySeconds === undefined || a.reason === undefined || a.prompt === undefined) {
+                return `Error (${SCHEDULE_WAKEUP_TOOL_NAME}): delaySeconds, reason and prompt are required unless \`stop\` is true.`;
+            }
+            const clampedDelaySeconds = Math.min(3600, Math.max(60, Math.round(a.delaySeconds)));
+            const wasClamped = clampedDelaySeconds !== a.delaySeconds;
+            const pending = await listPendingWakeups();
+            if (!("err" in pending))
+                await cancelWakeups(pending.ids);
+            const r = await sched.schedule({ prompt: a.prompt, when: { kind: "delay", delaySec: clampedDelaySeconds }, label: WAKEUP_LABEL, mode: "session-wakeup" }, schedCtx);
+            if (!r.ok)
+                return `Error (${SCHEDULE_WAKEUP_TOOL_NAME}): ${r.error.message}`;
+            const scheduledFor = Date.now() + clampedDelaySeconds * 1000;
+            const hhmmss = new Date(scheduledFor).toTimeString().slice(0, 8);
+            const clampNote = wasClamped ? ` (clamped to ${clampedDelaySeconds}s from your requested value)` : "";
+            return {
+                content: `Next wakeup scheduled for ${hhmmss} (in ${clampedDelaySeconds}s)${clampNote}. Nothing more to do this turn — the harness re-invokes you when the wakeup fires or a task-notification arrives.`,
+                details: { type: "schedule-wakeup", stopped: false, scheduledFor, clampedDelaySeconds, wasClamped },
+            };
+        }),
+    });
+    return ctx.sessionId !== undefined ? [cronCreate, cronCancel, cronList, scheduleWakeup] : [cronCreate, cronCancel, cronList];
+}
+//# sourceMappingURL=scheduler-tools.js.map

package/dist/tools/scheduler-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler-tools.js","sourceRoot":"","sources":["../../src/tools/scheduler-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/sql-adapters.d.ts

@@ -0,0 +1,14 @@
+export declare function pgQuery(pool: {
+    query: (text: string) => Promise<{
+        rows: unknown[];
+    }>;
+}): (sql: string) => Promise<unknown[]>;
+export declare function mysqlQuery(conn: {
+    query: (sql: string) => Promise<[unknown, unknown]>;
+}): (sql: string) => Promise<unknown[]>;
+export declare function sqliteQuery(db: {
+    prepare: (sql: string) => {
+        all: () => unknown[];
+    };
+}): (sql: string) => Promise<unknown[]>;
+//# sourceMappingURL=sql-adapters.d.ts.map

package/dist/tools/sql-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-adapters.d.ts","sourceRoot":"","sources":["../../src/tools/sql-adapters.ts"],"names":[],"mappings":"AAaA,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAC5B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;CACvD,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAEtC;AAOD,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAKtC;AAGD,wBAAgB,WAAW,CAAC,EAAE,EAAE;IAC9B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK;QAAE,GAAG,EAAE,MAAM,OAAO,EAAE,CAAA;KAAE,CAAC;CACpD,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAEtC"}

package/dist/tools/sql-adapters.js

@@ -0,0 +1,13 @@
+export function pgQuery(pool) {
+    return async (sql) => (await pool.query(sql)).rows;
+}
+export function mysqlQuery(conn) {
+    return async (sql) => {
+        const [rows] = await conn.query(sql);
+        return rows;
+    };
+}
+export function sqliteQuery(db) {
+    return async (sql) => db.prepare(sql).all();
+}
+//# sourceMappingURL=sql-adapters.js.map