@rubytech/create-sitedesk-code 0.1.551 → 0.1.552

package/payload/platform/plugins/scheduling/mcp/dist/lib/connector-freebusy.js

@@ -0,0 +1,240 @@
+/**
+ * Task 2381 — reading the account's calendar free/busy without a model turn.
+ *
+ * The "Booking calendar connector sync" routine spawned a model every 30 minutes
+ * to do two mechanical things: work out which connector the account had
+ * authorised, and read 15 days of free/busy from it. Neither is a decision. This
+ * module does both deterministically so the routine can run on the headless
+ * `action` rail.
+ *
+ * The provider is reached by SPAWNING its own MCP server, not by importing it. No
+ * plugin in this tree imports another plugin's source (the only cross-boundary
+ * imports are built artifacts under `platform/lib`), the provider owns the
+ * decryption of its own tokens, and `dispatchAction` in `check-due-events.ts`
+ * already reaches plugins exactly this way.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { detectCalendarConnectors } from "./connector-sync-provision.js";
+import { callPluginTool } from "./gate.js";
+/**
+ * The account's calendar connector, decided rather than chosen by a model.
+ *
+ * `detectCalendarConnectors` returns a sorted list, so google precedes m365 and
+ * the pick is deterministic. The stored `connector` is a single enum; an account
+ * holding both is real, and the skipped one is named on the resolution line so an
+ * ignored calendar is visible rather than silent.
+ */
+export function resolveConnector(accountDir) {
+    const found = detectCalendarConnectors(accountDir);
+    if (found.length === 0)
+        return { connector: "none", skipped: null };
+    return { connector: found[0], skipped: found[1] ?? null };
+}
+/**
+ * The environment a provider MCP needs, assembled for the action rail.
+ *
+ * The heartbeat's cron line sets only `PLATFORM_ROOT`, `NEO4J_URI` and
+ * `MAXY_UI_INTERNAL_PORT` (create-maxy-code/src/cron-registration.ts), so a child
+ * spawned from it inherits none of the per-plugin credentials a session-manager
+ * spawn would stamp from the `PLUGIN.md` `mcp.env` block. They are read from
+ * `brand.json` instead, which is the same source those placeholders resolve from.
+ *
+ * A missing client id throws. Returning an env without one would let the provider
+ * boot, refuse the call for want of a vendor app, and be indistinguishable
+ * downstream from an account whose calendar is genuinely empty.
+ */
+export function providerEnv(platformRoot, accountId, connector) {
+    const brandPath = join(platformRoot, "config", "brand.json");
+    let brand;
+    try {
+        brand = JSON.parse(readFileSync(brandPath, "utf-8"));
+    }
+    catch (err) {
+        throw new Error(`cannot read ${brandPath}: ${err.message}`);
+    }
+    const str = (v) => (typeof v === "string" ? v : "");
+    const env = { PLATFORM_ROOT: platformRoot, ACCOUNT_ID: accountId };
+    if (connector === "google") {
+        const id = str(brand.googleClientId);
+        const secret = str(brand.googleClientSecret);
+        if (!id || !secret) {
+            throw new Error("this brand ships no Google vendor app (client id and secret must both be present)");
+        }
+        env.GOOGLE_CLIENT_ID = id;
+        env.GOOGLE_CLIENT_SECRET = secret;
+        return env;
+    }
+    const id = str(brand.outlookClientId);
+    if (!id)
+        throw new Error("this brand ships no Outlook vendor app (outlookClientId is empty)");
+    env.OUTLOOK_CLIENT_ID = id;
+    env.OUTLOOK_TENANT_ID = str(brand.outlookTenantId) || "common";
+    return env;
+}
+function isInterval(v) {
+    const o = v;
+    return !!o && typeof o.start === "string" && typeof o.end === "string";
+}
+/** Google returns one busy list per requested calendar; with no `calendars`
+ *  argument that is the account's primary calendar alone. Every list is
+ *  flattened: the booking page blocks on any busy time, whichever calendar it
+ *  came from. */
+async function readGoogleBusy(opts) {
+    const raw = await opts.call("google", "google-calendar-freebusy", {
+        start: opts.from,
+        end: opts.to,
+    });
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error(`unexpected google-calendar-freebusy payload: ${JSON.stringify(raw).slice(0, 200)}`);
+    }
+    const out = [];
+    for (const slots of Object.values(raw)) {
+        if (!Array.isArray(slots)) {
+            throw new Error("unexpected google-calendar-freebusy payload: calendar value is not an array");
+        }
+        for (const s of slots) {
+            if (!isInterval(s)) {
+                throw new Error("unexpected google-calendar-freebusy payload: busy entry has no start/end");
+            }
+            out.push({ start: s.start, end: s.end });
+        }
+    }
+    return out;
+}
+/**
+ * Graph returns `scheduleItems[].start.dateTime` with a sibling `timeZone` field
+ * that the outlook plugin's tool drops, so what arrives here carries no zone
+ * designator. The window is requested in UTC, so a zone-less instant is UTC and
+ * is stamped as such. A string already carrying `Z` or an offset is left alone —
+ * re-stamping it would move the interval.
+ */
+export function normaliseGraphInstant(dateTime) {
+    if (/(Z|[+-]\d{2}:?\d{2})$/.test(dateTime))
+        return dateTime;
+    return `${dateTime}Z`;
+}
+/**
+ * The one mailbox whose schedule this account's busy sync reads.
+ *
+ * The mailbox directory name under `secrets/outlook/mailboxes/` is a sanitised
+ * `graphUserId` and the address lives inside the encrypted token blob, so it
+ * cannot be read off disk by a process that is not the outlook plugin. Zero or
+ * two-or-more addressable mailboxes both throw, mirroring the outlook plugin's
+ * own sole-mailbox rule: guessing one would publish the wrong person's free time.
+ */
+async function resolveM365Address(opts) {
+    const raw = await opts.call("outlook", "outlook-mailbox-list", {});
+    const rows = raw?.mailboxes;
+    const addressable = (Array.isArray(rows) ? rows : [])
+        .filter((m) => m.status === "ok" && typeof m.mail === "string" && m.mail.length > 0)
+        .map((m) => m.mail);
+    if (addressable.length === 0) {
+        throw new Error("no addressable Outlook mailbox for this account; run outlook-account-register");
+    }
+    if (addressable.length > 1) {
+        throw new Error(`two or more Outlook mailboxes are addressable (${addressable.join(", ")}); the busy sync cannot choose between them`);
+    }
+    return addressable[0];
+}
+async function readM365Busy(opts) {
+    const address = await resolveM365Address(opts);
+    const raw = await opts.call("outlook", "outlook-calendar-freebusy", {
+        schedules: [address],
+        start: { dateTime: opts.from, timeZone: "UTC" },
+        end: { dateTime: opts.to, timeZone: "UTC" },
+    });
+    const availability = raw?.availability;
+    if (!Array.isArray(availability)) {
+        throw new Error(`unexpected outlook-calendar-freebusy payload: ${JSON.stringify(raw).slice(0, 200)}`);
+    }
+    const out = [];
+    let loggedRaw = false;
+    for (const entry of availability) {
+        // An address Graph could not resolve comes back with an error and an EMPTY
+        // busy list, which is byte-identical to a free calendar. Reading it as free
+        // would publish the operator's booked time as available.
+        if (entry.error) {
+            throw new Error(`Graph could not resolve the mailbox schedule: ${String(entry.error)}`);
+        }
+        for (const b of Array.isArray(entry.busy) ? entry.busy : []) {
+            if (!isInterval(b)) {
+                throw new Error("unexpected outlook-calendar-freebusy payload: busy entry has no start/end");
+            }
+            if (!loggedRaw) {
+                // One raw line per read. The UTC reading above is an assumption about a
+                // Graph response this tree holds no fixture for; the unparsed value makes
+                // a wrong assumption visible in the log rather than silently shifting
+                // every slot on the booking page by the account's offset.
+                console.error(`[connector-busy-sync] op=m365-raw-interval start=${JSON.stringify(b.start)} end=${JSON.stringify(b.end)}`);
+                loggedRaw = true;
+            }
+            out.push({ start: normaliseGraphInstant(b.start), end: normaliseGraphInstant(b.end) });
+        }
+    }
+    return out;
+}
+/**
+ * The account's busy intervals over the window, read from its own connector.
+ *
+ * Every failure throws. Returning `[]` on a failed read would clear the stored
+ * busy set and publish the operator's booked time as free, and a booking page
+ * serving its last successful write looks correct either way — so an empty list
+ * must only ever mean the calendar is genuinely free.
+ */
+export async function readConnectorBusy(opts) {
+    if (opts.connector === "google")
+        return readGoogleBusy(opts);
+    return readM365Busy(opts);
+}
+// ---------------------------------------------------------------------------
+// The provider spawn
+// ---------------------------------------------------------------------------
+/**
+ * A `ProviderCall` that reaches the provider plugin's own MCP server.
+ *
+ * The transport is `callPluginTool`, the one Task 2378 extracted from
+ * `dispatchAction`. Sharing it rather than writing a second one is the point:
+ * this call is spawned from the same heartbeat, so it needs the same timeout,
+ * the same `ACCOUNT_ID` scoping, the same captured child stderr, and above all
+ * the same `PLATFORM_PORT` bridge — the cron line does not export that name and
+ * every plugin resolves its loopback base URL from it, so a transport without it
+ * throws on port resolution before the tool runs.
+ *
+ * It is a spawn rather than an import because no plugin in this tree imports
+ * another plugin's source, and because the provider owns the decryption of its
+ * own tokens.
+ */
+export function spawnProviderCall(platformRoot, accountId, connector) {
+    // Resolved once, outside the returned closure: a brand shipping no vendor app
+    // for this connector must fail before any child is spawned.
+    const credentials = providerEnv(platformRoot, accountId, connector);
+    return async (plugin, tool, args) => {
+        let call;
+        try {
+            call = await callPluginTool(plugin, tool, JSON.stringify(args), accountId, credentials);
+        }
+        catch (err) {
+            // A transport failure carries the child's stderr, which is where a
+            // provider's own refusal reason (an expired refresh token, a missing
+            // vendor app) is written. Dropping it would leave `op=read-failed`
+            // reporting only that something went wrong.
+            const e = err;
+            const detail = e.childStderr ? `${e.message} — child stderr: ${e.childStderr.trim()}` : String(e.message);
+            throw new Error(`${tool} failed: ${detail}`);
+        }
+        const text = (Array.isArray(call.result.content) ? call.result.content : [])
+            .filter((c) => c.type === "text")
+            .map((c) => String(c.text))
+            .join("\n");
+        if (call.result.isError === true)
+            throw new Error(`${tool} returned an error: ${text}`);
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new Error(`${tool} returned a non-JSON payload: ${text.slice(0, 200)}`);
+        }
+    };
+}
+//# sourceMappingURL=connector-freebusy.js.map

package/payload/platform/plugins/scheduling/mcp/dist/lib/connector-freebusy.js.map

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

package/payload/platform/plugins/scheduling/mcp/dist/lib/gate.d.ts

@@ -0,0 +1,92 @@
+import type { EventGate } from "../scripts/agent-turn-dispatch.js";
+/**
+ * The 10-minute ceiling `dispatchAction` has always used. Re-exported here
+ * because `callPluginTool` now owns the timeout for both callers, so a gate and
+ * an action cannot drift apart on how long a plugin tool may run.
+ */
+export declare const DISPATCH_TIMEOUT_MS = 600000;
+/**
+ * A tool call's outcome, structurally typed rather than imported from the MCP
+ * SDK. The SDK ships dual ESM/CJS packages with conditional exports and the
+ * plugin workspaces pin their own copies, so importing its result type here
+ * would couple this module's compilation to the consumer's resolution mode —
+ * the same constraint `lib/mcp-eager/src/index.ts` records for `ZodRawShape`.
+ * Only three members are read anywhere in this plugin.
+ */
+export interface ToolCallResult {
+    isError?: boolean;
+    content?: unknown;
+    structuredContent?: Record<string, unknown>;
+}
+export interface PluginToolCall {
+    result: ToolCallResult;
+    /** Child stderr, capped at 4KB. Captured on every call, read on failure. */
+    childStderr: string;
+}
+/**
+ * A transport-level failure, distinct from a tool that ran and returned
+ * `isError`. `kind` separates the timeout from every other failure because the
+ * two are recorded differently: `dispatchAction` writes `timeout` rather than
+ * `error` to `lastDispatchResult`, and the gate's fail-open line names which of
+ * the two it was.
+ */
+export declare class PluginToolError extends Error {
+    readonly kind: "timeout" | "error";
+    readonly childStderr: string;
+    constructor(message: string, kind: "timeout" | "error", childStderr: string);
+}
+/**
+ * Spawn a plugin's MCP server over stdio, call one tool, close.
+ *
+ * Extracted from `dispatchAction` so the gate inherits the whole of its
+ * transport contract unchanged: the dispatch timeout, `ACCOUNT_ID` env scoping,
+ * and captured child stderr. Two callers sharing one body is the point — a gate
+ * that connected differently from an action would be a second transport to keep
+ * correct.
+ *
+ * Returns the raw result, including a result carrying `isError: true`. Deciding
+ * what an errored tool means belongs to the caller: an action treats it as a
+ * failed dispatch, a gate treats it as fail-open.
+ */
+export declare function callPluginTool(plugin: string, tool: string, args: string | null, accountId: string, extraEnv?: Record<string, string>): Promise<PluginToolCall>;
+/**
+ * What the dispatcher does about this fire.
+ *
+ * `has-work` and every `fail-open` variant dispatch; only `no-work` skips. They
+ * are separate cases rather than one boolean because the log line differs and
+ * because a fail-open must never be readable as a gate that returned false —
+ * that confusion is exactly how a silently muted routine would be missed.
+ */
+export type GateVerdict = {
+    kind: "has-work";
+} | {
+    kind: "no-work";
+} | {
+    kind: "fail-open";
+    reason: "error" | "timeout" | "no-structured-result";
+    detail: string;
+};
+/** Injectable for tests; production passes `callPluginTool`. */
+export type PluginToolCaller = (plugin: string, tool: string, args: string | null, accountId: string) => Promise<PluginToolCall>;
+/**
+ * Evaluate one gate and say whether this fire reaches the model.
+ *
+ * Reads `structuredContent.hasWork` and nothing else. `content[]` is prose and
+ * is never consulted for control flow: parsing a third-party tool's wording to
+ * decide whether to spend a model turn is the failure mode the plugin doctrine
+ * names outright.
+ *
+ * Fails OPEN on every unreadable outcome — a throw, a timeout, an errored
+ * result, an absent `structuredContent`, a `hasWork` that is not a boolean.
+ * Failing closed would silently mute a routine and produce the Task 2313
+ * "looks live and delivers nothing" class with no alarm; failing open costs at
+ * worst the fires that were already happening before this task.
+ *
+ * Emits exactly one line, `op=evaluated` or `op=fail-open`, never both and never
+ * neither. `op=skipped` is the caller's, because only the caller knows the skip
+ * actually happened.
+ *
+ * Never throws — the sweep's contract. One broken gate must not abort the tick.
+ */
+export declare function evaluateGate(gate: EventGate, eventId: string, accountId: string, call?: PluginToolCaller): Promise<GateVerdict>;
+//# sourceMappingURL=gate.d.ts.map

package/payload/platform/plugins/scheduling/mcp/dist/lib/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/lib/gate.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAGtC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,SAAS,GAAG,OAAO,EACzB,WAAW,EAAE,MAAM;CAK/B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,SAAS,EAAE,MAAM,EAOjB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACpC,OAAO,CAAC,cAAc,CAAC,CAoFzB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,sBAAsB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhG,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,gBAAiC,GACtC,OAAO,CAAC,WAAW,CAAC,CA4CtB"}

package/payload/platform/plugins/scheduling/mcp/dist/lib/gate.js

@@ -0,0 +1,193 @@
+/**
+ * Task 2378 — the precondition gate: a headless MCP call that decides whether a
+ * due agent-bearing routine reaches the model at all.
+ *
+ * Before this, an agent-bearing `:Event` fired because `nextRun` was due and
+ * nothing else was consulted. On the one routine measured in depth, 535 of 564
+ * fires (95%) sent nothing and still cost a median 24,830 output tokens each,
+ * because the operator's "only message me if something is new" rule lives inside
+ * the `agentPrompt` and is therefore read AFTER the spawn and after the sweep.
+ * It gates the outbound message, never the invocation.
+ *
+ * This module lives outside `check-due-events.ts` for the reason
+ * `dispatchGapReason` and `targetOf` already do: that module calls `main()` at
+ * import time and so cannot be imported by a test. The task's Touches list names
+ * `check-due-events.ts` for `callPluginTool`; putting it there would make the
+ * fail-open branches — the ones most likely to be inverted by a later edit —
+ * untestable, which is the opposite of what the task asks for.
+ */
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+/**
+ * The 10-minute ceiling `dispatchAction` has always used. Re-exported here
+ * because `callPluginTool` now owns the timeout for both callers, so a gate and
+ * an action cannot drift apart on how long a plugin tool may run.
+ */
+export const DISPATCH_TIMEOUT_MS = 600_000;
+/**
+ * A transport-level failure, distinct from a tool that ran and returned
+ * `isError`. `kind` separates the timeout from every other failure because the
+ * two are recorded differently: `dispatchAction` writes `timeout` rather than
+ * `error` to `lastDispatchResult`, and the gate's fail-open line names which of
+ * the two it was.
+ */
+export class PluginToolError extends Error {
+    kind;
+    childStderr;
+    constructor(message, kind, childStderr) {
+        super(message);
+        this.kind = kind;
+        this.childStderr = childStderr;
+        this.name = "PluginToolError";
+    }
+}
+/**
+ * Spawn a plugin's MCP server over stdio, call one tool, close.
+ *
+ * Extracted from `dispatchAction` so the gate inherits the whole of its
+ * transport contract unchanged: the dispatch timeout, `ACCOUNT_ID` env scoping,
+ * and captured child stderr. Two callers sharing one body is the point — a gate
+ * that connected differently from an action would be a second transport to keep
+ * correct.
+ *
+ * Returns the raw result, including a result carrying `isError: true`. Deciding
+ * what an errored tool means belongs to the caller: an action treats it as a
+ * failed dispatch, a gate treats it as fail-open.
+ */
+export async function callPluginTool(plugin, tool, args, accountId, 
+// Task 2381 — per-plugin credentials the caller already resolved, overlaid
+// last. The connector busy sync reaches the google and outlook plugins from
+// this same heartbeat, and those need a client id and secret that only their
+// own PLUGIN.md mcp.env block would otherwise stamp. A second transport that
+// differed on the timeout, on ACCOUNT_ID scoping or on the PLATFORM_PORT
+// bridge below is exactly what this function exists to prevent.
+extraEnv = {}) {
+    const platformRoot = process.env.PLATFORM_ROOT;
+    const serverPath = resolve(platformRoot, "plugins", plugin, "mcp", "dist", "index.js");
+    if (!existsSync(serverPath)) {
+        throw new PluginToolError(`MCP server not found: ${serverPath}`, "error", "");
+    }
+    // Dynamic import — the MCP SDK Client is only needed when actually calling.
+    const { Client } = await import("@modelcontextprotocol/sdk/client/index.js");
+    const { StdioClientTransport } = await import("@modelcontextprotocol/sdk/client/stdio.js");
+    // Build env: inherit parent env (for NEO4J_*, OLLAMA_*, etc.) + set ACCOUNT_ID
+    const env = {};
+    for (const [k, v] of Object.entries(process.env)) {
+        if (v !== undefined)
+            env[k] = v;
+    }
+    env.PLATFORM_ROOT = platformRoot;
+    env.ACCOUNT_ID = accountId;
+    // Task 2378 — the cron heartbeat exports PLATFORM_ROOT, NEO4J_URI and
+    // MAXY_UI_INTERNAL_PORT and nothing else (create-maxy-code/src/cron-registration.ts),
+    // while every plugin resolves its loopback base URL from PLATFORM_PORT
+    // (storage-broker/mcp/src/index.ts:28). A plugin tool spawned from the
+    // heartbeat therefore threw on port resolution before it could run a single
+    // check. The systemd/launchd unit already sets both names to the same value
+    // (create-maxy-code/src/port-resolution.ts:350-351), so this makes the cron
+    // env match the unit rather than inventing a port. Never overwrites a
+    // PLATFORM_PORT that is already present.
+    if (!env.PLATFORM_PORT && env.MAXY_UI_INTERNAL_PORT) {
+        env.PLATFORM_PORT = env.MAXY_UI_INTERNAL_PORT;
+    }
+    Object.assign(env, extraEnv);
+    const transport = new StdioClientTransport({
+        command: process.execPath,
+        args: [serverPath],
+        env,
+        stderr: "pipe",
+    });
+    // Collect child stderr for diagnostics on failure
+    let childStderr = "";
+    const stderrStream = transport.stderr;
+    if (stderrStream) {
+        stderrStream.on("data", (chunk) => {
+            // Cap at 4KB to avoid unbounded memory
+            if (childStderr.length < 4096) {
+                childStderr += chunk.toString("utf-8").slice(0, 4096 - childStderr.length);
+            }
+        });
+    }
+    const client = new Client({ name: "event-dispatcher", version: "1.0.0" });
+    let timedOut = false;
+    // The timeout kills the child process via client.close(), which causes
+    // the pending callTool() promise to reject — unlike AbortController,
+    // this actually stops the work.
+    const timeout = setTimeout(() => {
+        timedOut = true;
+        client.close().catch(() => { });
+    }, DISPATCH_TIMEOUT_MS);
+    try {
+        await client.connect(transport);
+        const parsed = args ? JSON.parse(args) : {};
+        const result = (await client.callTool({ name: tool, arguments: parsed }));
+        return { result, childStderr };
+    }
+    catch (err) {
+        throw new PluginToolError(err instanceof Error ? err.message : String(err), timedOut ? "timeout" : "error", childStderr);
+    }
+    finally {
+        clearTimeout(timeout);
+        if (!timedOut) {
+            try {
+                await client.close();
+            }
+            catch {
+                // Best-effort cleanup
+            }
+        }
+    }
+}
+/**
+ * Evaluate one gate and say whether this fire reaches the model.
+ *
+ * Reads `structuredContent.hasWork` and nothing else. `content[]` is prose and
+ * is never consulted for control flow: parsing a third-party tool's wording to
+ * decide whether to spend a model turn is the failure mode the plugin doctrine
+ * names outright.
+ *
+ * Fails OPEN on every unreadable outcome — a throw, a timeout, an errored
+ * result, an absent `structuredContent`, a `hasWork` that is not a boolean.
+ * Failing closed would silently mute a routine and produce the Task 2313
+ * "looks live and delivers nothing" class with no alarm; failing open costs at
+ * worst the fires that were already happening before this task.
+ *
+ * Emits exactly one line, `op=evaluated` or `op=fail-open`, never both and never
+ * neither. `op=skipped` is the caller's, because only the caller knows the skip
+ * actually happened.
+ *
+ * Never throws — the sweep's contract. One broken gate must not abort the tick.
+ */
+export async function evaluateGate(gate, eventId, accountId, call = callPluginTool) {
+    const started = Date.now();
+    const id8 = eventId.slice(0, 8);
+    const failOpen = (reason, detail) => {
+        console.error(`[schedule-gate] op=fail-open eventId=${id8} reason=${reason} detail=${detail}`);
+        return { kind: "fail-open", reason, detail };
+    };
+    let call_;
+    try {
+        call_ = await call(gate.plugin, gate.tool, gate.args, accountId);
+    }
+    catch (err) {
+        const kind = err instanceof PluginToolError ? err.kind : "error";
+        return failOpen(kind, err instanceof Error ? err.message : String(err));
+    }
+    // A tool that ran and reported failure is as unreadable as one that threw.
+    if (call_.result.isError === true) {
+        return failOpen("error", "tool returned isError");
+    }
+    const hasWork = call_.result.structuredContent?.hasWork;
+    if (typeof hasWork !== "boolean") {
+        // Names both the absent case and the wrong-type case, because a gate
+        // returning `hasWork: "false"` is exactly as unusable as one returning
+        // nothing, and a truthiness read of that string would skip every fire.
+        return failOpen("no-structured-result", call_.result.structuredContent === undefined
+            ? "no structuredContent"
+            : `hasWork is ${typeof hasWork}`);
+    }
+    console.error(`[schedule-gate] op=evaluated eventId=${id8} plugin=${gate.plugin} tool=${gate.tool} ` +
+        `hasWork=${hasWork} ms=${Date.now() - started}`);
+    return hasWork ? { kind: "has-work" } : { kind: "no-work" };
+}
+//# sourceMappingURL=gate.js.map

package/payload/platform/plugins/scheduling/mcp/dist/lib/gate.js.map

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

package/payload/platform/plugins/scheduling/mcp/dist/lib/routine-run.d.ts

@@ -12,8 +12,15 @@ export type RunMode = "agent" | "action" | "none";
  * (ui/server/routes/channel/schedule-inject.ts), so `finished` can never be
  * established here. It is reached only by `promoteRoutineRuns` on the reconcile
  * tick, from evidence in the transcript.
+ *
+ * Task 2378 — `gated` is the fourth: the routine was due, its `nextRun` was
+ * advanced, and its precondition reported no work, so no turn was injected. It
+ * is a distinct outcome rather than a variety of `no-destination` because the
+ * two mean opposite things — `no-destination` is a routine that cannot deliver,
+ * `gated` is one working exactly as configured — and `auditGateAlwaysSkipping`
+ * counts this value to find a gate stuck on false.
  */
-export type RunOutcome = "accepted" | "failed" | "no-destination";
+export type RunOutcome = "accepted" | "failed" | "no-destination" | "gated";
 /** Records are kept for 30 days. A quarter-hourly routine settles at ~2,900 per account. */
 export declare const RETENTION_DAYS = 30;
 /**

package/payload/platform/plugins/scheduling/mcp/dist/lib/routine-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routine-run.d.ts","sourceRoot":"","sources":["../../src/lib/routine-run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"routine-run.d.ts","sourceRoot":"","sources":["../../src/lib/routine-run.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,6CAA6C;AAC7C,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;AAE/C,iEAAiE;AACjE,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAE5E,4FAA4F;AAC5F,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;;GAIG;AACH,eAAO,MAAM,eAAe,SAAU,CAAC;AAEvC,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAYlD;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,kGAAkG;IAClG,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoDhG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAGpG;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,UAAU,CAAC;IACpB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uFAAuF;IACvF,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAwCD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,GAAG,IAAI,CAsBtG;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAKpG;AAED;;8CAE8C;AAC9C,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAuBvC;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBlE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IACJ,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5E,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAClD,GACL,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAkGhD;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,aAAa,GAAE,MAAuB,GACrC,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BrG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,MAAM,CAAC,CAwCjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B7F;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BrF"}