@rubytech/create-realagent-code 0.1.573 → 0.1.575

package/payload/platform/plugins/dispatch/mcp/dist/tools/intake.js

@@ -0,0 +1,194 @@
+import { newDraftId, newReqId } from "../lib/ids.js";
+import { readDraft, readDrafts, readNodeId } from "../lib/read.js";
+import { formatDecided, formatDrafted, formatReceived, missingRequired, } from "../lib/intake.js";
+import { jobCreate } from "./job-create.js";
+import { toolError, toolText } from "./result.js";
+const edgeTo = (type, targetNodeId) => targetNodeId === null ? [] : [{ type, direction: "outgoing", targetNodeId }];
+export async function intakeDraft(p) {
+    const reqId = newReqId();
+    // Before parsing, not after. A request that dies in validation is still a
+    // request that arrived, and this is the only line that says so.
+    p.emit(formatReceived(reqId, p.source, p.sourceRef));
+    const jobType = p.cfg.jobTypes.find((t) => t.name === p.type);
+    const siteNodeId = p.siteId
+        ? await readNodeId(p.session, p.accountId, "Site", "siteId", p.siteId)
+        : null;
+    const customerNodeId = p.customerId
+        ? await readNodeId(p.session, p.accountId, "Customer", "customerId", p.customerId)
+        : null;
+    if (siteNodeId === null && customerNodeId === null) {
+        return toolError(`No draft can be held: neither siteId nor customerId names anything on this account, so ` +
+            `there is nothing to attach the request to. Supply a siteId or a customerId that exists, ` +
+            `or create one first — this tool creates neither.`);
+    }
+    const missing = missingRequired({
+        type: jobType !== undefined,
+        siteId: siteNodeId !== null,
+        customerId: customerNodeId !== null,
+    });
+    const draftId = p.draftId ?? newDraftId();
+    // Only what resolved is stored. A supplied-but-unusable value written to the
+    // node would put a job type this account does not declare on the very row the
+    // reviewer is meant to trust.
+    const optional = {
+        ...(jobType === undefined ? {} : { jobType: jobType.name }),
+        ...(siteNodeId === null ? {} : { siteId: p.siteId }),
+        ...(customerNodeId === null ? {} : { customerId: p.customerId }),
+        ...(p.description === undefined ? {} : { description: p.description }),
+    };
+    await p.write({
+        session: p.session,
+        labels: ["IntakeDraft"],
+        props: {
+            accountId: p.accountId,
+            draftId,
+            receivedAt: new Date(p.now()).toISOString(),
+            source: p.source,
+            sourceRef: p.sourceRef,
+            ...optional,
+        },
+        relationships: [
+            ...edgeTo("AT_SITE", siteNodeId),
+            ...edgeTo("FOR_CUSTOMER", customerNodeId),
+        ],
+        createdBy: p.createdBy,
+        mergeOn: ["draftId"],
+    });
+    // The node property is `jobType`, matching `:Job`; the field NAME reported to
+    // the operator is `type`, matching this tool's argument and `missing=`. One
+    // line naming the same field two ways is two fields as far as any reader is
+    // concerned, and `missing=type fields=jobType` reads as a contradiction.
+    const fields = Object.keys(optional).map((k) => (k === "jobType" ? "type" : k));
+    p.emit(formatDrafted(reqId, draftId, fields, missing));
+    return toolText(JSON.stringify({ draftId, fields, missing, vocabulary: p.cfg.vocabulary }, null, 2));
+}
+/**
+ * Approve or reject. Approval goes through `jobCreate`, the one write path, so
+ * the job's opening status and its `slaTargetAt` come from the account's own
+ * config and `op=job-create` still appears. A second write path would let a job
+ * reach the graph by a route the census and the planner were never taught about.
+ *
+ * A decision is final and a second one is refused. Approving twice would turn
+ * one request into two jobs, with no line anywhere saying which was real.
+ */
+export async function intakeDecide(p) {
+    const draft = await readDraft(p.session, p.accountId, p.draftId);
+    if (draft === null) {
+        return toolError(`No draft "${p.draftId}" on this account.`);
+    }
+    if (draft.verdict !== null) {
+        return toolError(`Draft "${p.draftId}" was already decided: ${draft.verdict}. A decision is final, so this ` +
+            `call changed nothing. Raise a new request if the work is wanted again.`);
+    }
+    if (p.verdict === "reject" && (p.reason === undefined || p.reason.trim() === "")) {
+        return toolError(`A rejection needs a reason. Without one the draft records that somebody said no and nothing ` +
+            `about why, which reads exactly like the unreviewed queue it just left.`);
+    }
+    const by = p.by ?? "unknown";
+    const type = p.type ?? draft.jobType ?? undefined;
+    const siteId = p.siteId ?? draft.siteId ?? undefined;
+    const customerId = p.customerId ?? draft.customerId ?? undefined;
+    const description = p.description ?? draft.description ?? undefined;
+    // Re-resolved rather than trusted: the draft may be hours old and the site or
+    // customer it named may be gone. `writeNodeWithEdges` refuses a node with no
+    // relationship, so a draft whose only edge target has vanished is refused here
+    // with an instruction rather than surfacing as a stack trace from the write.
+    const siteNodeId = siteId
+        ? await readNodeId(p.session, p.accountId, "Site", "siteId", siteId)
+        : null;
+    const customerNodeId = customerId
+        ? await readNodeId(p.session, p.accountId, "Customer", "customerId", customerId)
+        : null;
+    if (siteNodeId === null && customerNodeId === null) {
+        return toolError(`Draft "${p.draftId}" no longer names a site or a customer that exists on this account, so ` +
+            `the decision has nothing to attach to. Supply a siteId or customerId that exists.`);
+    }
+    // The edges it already has, re-passed. They MERGE, so no duplicate appears,
+    // and the zero-relationship guard is satisfied without inventing an edge.
+    const keptEdges = [
+        ...edgeTo("AT_SITE", siteNodeId),
+        ...edgeTo("FOR_CUSTOMER", customerNodeId),
+    ];
+    const decidedAt = new Date(p.now()).toISOString();
+    if (p.verdict === "reject") {
+        await p.write({
+            session: p.session,
+            labels: ["IntakeDraft"],
+            props: {
+                accountId: p.accountId,
+                draftId: p.draftId,
+                verdict: "rejected",
+                decidedAt,
+                decidedBy: by,
+                reason: p.reason,
+            },
+            relationships: keptEdges,
+            createdBy: p.createdBy,
+            mergeOn: ["draftId"],
+        });
+        p.emit(formatDecided(p.draftId, "rejected", by, null, p.reason ?? null));
+        return toolText(JSON.stringify({ draftId: p.draftId, verdict: "rejected", reason: p.reason }, null, 2));
+    }
+    const missing = missingRequired({
+        type: type !== undefined && p.cfg.jobTypes.some((t) => t.name === type),
+        siteId: siteNodeId !== null,
+        customerId: customerNodeId !== null,
+    });
+    if (missing.length > 0) {
+        return toolError(`Draft "${p.draftId}" cannot be approved: ${missing.join(", ")} ` +
+            `${missing.length === 1 ? "is" : "are"} still missing. Supply the field on this call, or ` +
+            `reject the draft with a reason.`);
+    }
+    const created = await jobCreate({
+        session: p.session,
+        write: p.write,
+        accountId: p.accountId,
+        createdBy: p.createdBy,
+        cfg: p.cfg,
+        emit: p.emit,
+        now: p.now,
+        type: type,
+        siteId: siteId,
+        customerId: customerId,
+        description,
+    });
+    if (created.isError)
+        return created;
+    const jobId = JSON.parse(created.content[0].text).jobId;
+    const jobNodeId = await readNodeId(p.session, p.accountId, "Job", "jobId", jobId);
+    if (jobNodeId === null) {
+        // The job exists — `jobCreate` just wrote it — so refusing here would strand
+        // it. The draft still records `jobId`, so the link survives as a property.
+        // What is lost is the traversable edge, and an edge quietly not written is
+        // indistinguishable from one nobody asked for.
+        p.emit(`[dispatch] op=intake-edge-missing draftId=${p.draftId} jobId=${jobId} ` +
+            `edge=BECAME_JOB reason=job-node-unresolved`);
+    }
+    await p.write({
+        session: p.session,
+        labels: ["IntakeDraft"],
+        props: {
+            accountId: p.accountId,
+            draftId: p.draftId,
+            verdict: "approved",
+            decidedAt,
+            decidedBy: by,
+            jobId,
+        },
+        relationships: [...keptEdges, ...edgeTo("BECAME_JOB", jobNodeId)],
+        createdBy: p.createdBy,
+        mergeOn: ["draftId"],
+    });
+    p.emit(formatDecided(p.draftId, "approved", by, jobId, null));
+    return toolText(JSON.stringify({ draftId: p.draftId, verdict: "approved", jobId }, null, 2));
+}
+/**
+ * The queue. Without it a draftId is known only to the session that made it, so
+ * an office reviewing yesterday's requests would have the census count and no
+ * way to reach a row.
+ */
+export async function intakeList(p) {
+    const drafts = await readDrafts(p.session, p.accountId, p.verdict ?? null, Math.min(Math.max(p.limit ?? 50, 1), 200));
+    return toolText(JSON.stringify({ drafts, vocabulary: p.cfg.vocabulary }, null, 2));
+}
+//# sourceMappingURL=intake.js.map

package/payload/platform/plugins/dispatch/mcp/dist/tools/intake.js.map

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

package/payload/platform/plugins/dispatch/mcp/dist/tools/notify-worker.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Send a worker the card for one visit.
+ *
+ * This is the half Task 2501 had no counterpart for. A press is received,
+ * authorised, stored and answered, and until something puts a button on a card
+ * there is nothing to press. Every status change on the reference account is
+ * typed, and arrival time is a memory of when somebody got round to it.
+ *
+ * The public origin is a parameter, not a derivation. Nothing in this tree
+ * resolves an account's public host, and inventing a derivation here would be a
+ * second source of truth for it; `telegram-setup` and the job-sheet menu button
+ * both take theirs the same way.
+ */
+import type { Session } from "neo4j-driver";
+import { type VisitRow } from "../lib/read.js";
+import type { DispatchConfig } from "../lib/types.js";
+import { type ToolResult } from "./result.js";
+/** The Bot API's own keyboard shape, declared here rather than imported from the
+ *  telegram plugin: two independently versioned plugins must not couple. */
+export interface BotApiKeyboard {
+    inline_keyboard: Array<Array<{
+        text: string;
+        callback_data?: string;
+        web_app?: {
+            url: string;
+        };
+    }>>;
+}
+export type SendCardFn = (p: {
+    token: string;
+    chatId: string;
+    text: string;
+    keyboard: BotApiKeyboard;
+}) => Promise<{
+    ok: boolean;
+    messageId?: number;
+    error?: string;
+}>;
+export interface NotifyWorkerParams {
+    session: Session;
+    accountId: string;
+    cfg: DispatchConfig;
+    emit: (line: string) => void;
+    platformRoot: string;
+    visitId: string;
+    publicOrigin: string;
+    /** Which registered bot sends the card. Defaults to the account's admin bot. */
+    botId?: string;
+    send: SendCardFn;
+}
+/** The card's body. Every noun is the account's own. */
+export declare function buildCardText(p: {
+    cfg: DispatchConfig;
+    visit: VisitRow;
+    jobType: string | null;
+    siteName: string | null;
+}): string;
+/** The real transport. Injected as `send` so the tool is testable offline. */
+export declare const sendCardViaBotApi: SendCardFn;
+export declare function notifyWorker(p: NotifyWorkerParams): Promise<ToolResult>;
+//# sourceMappingURL=notify-worker.d.ts.map

package/payload/platform/plugins/dispatch/mcp/dist/tools/notify-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify-worker.d.ts","sourceRoot":"","sources":["../../src/tools/notify-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnE;4EAC4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,KAAK,CACpB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAC3E,CAAC;CACH;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;CAC1B,KAAK,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,CAAC,EAAE;IAC/B,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,GAAG,MAAM,CAQT;AAED,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,EAAE,UAsB/B,CAAC;AAEF,wBAAsB,YAAY,CAAC,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4H7E"}

package/payload/platform/plugins/dispatch/mcp/dist/tools/notify-worker.js

@@ -0,0 +1,130 @@
+import { buildVisitKeyboard } from "../lib/keyboard.js";
+import { readJob, readVisit } from "../lib/read.js";
+import { firstAdminBotId, resolveDispatchBotToken } from "../lib/bot-token.js";
+import { toolError, toolText } from "./result.js";
+/** The card's body. Every noun is the account's own. */
+export function buildCardText(p) {
+    const lines = [
+        `${p.cfg.vocabulary.visit}: ${p.jobType ?? p.visit.purpose ?? p.cfg.vocabulary.job}`,
+    ];
+    if (p.siteName)
+        lines.push(p.siteName);
+    if (p.visit.startDate)
+        lines.push(p.visit.startDate);
+    lines.push(`status: ${p.visit.status}`);
+    return lines.join("\n");
+}
+/** The real transport. Injected as `send` so the tool is testable offline. */
+export const sendCardViaBotApi = async (p) => {
+    try {
+        const res = await fetch(`https://api.telegram.org/bot${p.token}/sendMessage`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                chat_id: p.chatId,
+                text: p.text,
+                reply_markup: JSON.stringify(p.keyboard),
+            }),
+        });
+        const data = (await res.json());
+        return data.ok
+            ? { ok: true, messageId: data.result?.message_id }
+            : { ok: false, error: data.description ?? "send failed" };
+    }
+    catch (e) {
+        return { ok: false, error: e instanceof Error ? e.message : String(e) };
+    }
+};
+export async function notifyWorker(p) {
+    let origin;
+    try {
+        origin = new URL(p.publicOrigin);
+    }
+    catch {
+        return toolError(`"${p.publicOrigin}" is not a URL. Give the account's public origin, for example https://acme.example.com.`);
+    }
+    if (origin.protocol !== "https:") {
+        // Telegram opens Mini Apps over https only. An http URL fails inside the
+        // webview with nothing on our side to say why.
+        return toolError(`Telegram opens Mini Apps over https only; got "${p.publicOrigin}".`);
+    }
+    const visit = await readVisit(p.session, p.accountId, p.visitId);
+    if (!visit) {
+        return toolError(`No ${p.cfg.vocabulary.visit} "${p.visitId}" on this account.`);
+    }
+    if (!visit.workerId) {
+        return toolError(`That ${p.cfg.vocabulary.visit} has no ${p.cfg.vocabulary.worker} attending it. Allocate it first.`);
+    }
+    const worker = p.cfg.workers.find((w) => w.workerId === visit.workerId);
+    if (!worker) {
+        return toolError(`"${visit.workerId}" is not on this account's ${p.cfg.vocabulary.worker} roster.`);
+    }
+    if (!worker.telegramUserId) {
+        return toolError(`${p.cfg.vocabulary.worker} "${worker.workerId}" carries no telegramUserId, so there is nowhere to send the card. Add it to that worker in dispatch/config.json.`);
+    }
+    const botId = p.botId ?? firstAdminBotId(p.platformRoot, p.accountId);
+    if (!botId) {
+        return toolError(`This account has no admin Telegram bot registered, and no botId was given. Run telegram-setup first.`);
+    }
+    const token = resolveDispatchBotToken(p.platformRoot, p.accountId, botId);
+    if (!token) {
+        return toolError(`No Telegram bot "${botId}" is registered on this account.`);
+    }
+    const sheetUrl = new URL("/field", origin);
+    sheetUrl.searchParams.set("bot", botId);
+    const kb = buildVisitKeyboard({
+        cfg: p.cfg,
+        visitId: p.visitId,
+        status: visit.status,
+        sheetUrl: sheetUrl.toString(),
+    });
+    for (const d of kb.dropped) {
+        // Named, never silent. A dropped button is a worker who cannot make that
+        // move from his phone, and nothing else would ever say so.
+        p.emit(`[dispatch-tg] op=button-too-long visitId=${p.visitId} status=${d.status} bytes=${d.bytes}`);
+    }
+    const keyboard = {
+        inline_keyboard: kb.rows.map((row) => row.map((b) => ({
+            text: b.text,
+            ...(b.callbackData !== undefined ? { callback_data: b.callbackData } : {}),
+            ...(b.webAppUrl !== undefined ? { web_app: { url: b.webAppUrl } } : {}),
+        }))),
+    };
+    const job = visit.jobId ? await readJob(p.session, p.accountId, visit.jobId) : null;
+    const text = buildCardText({
+        cfg: p.cfg,
+        visit,
+        jobType: job?.jobType ?? null,
+        siteName: job?.siteName ?? null,
+    });
+    const sent = await p.send({ token, chatId: worker.telegramUserId, text, keyboard });
+    if (!sent.ok) {
+        // No op=dispatch-sent and no cardSentAt on this branch. That pair is what
+        // the census reconciles acknowledgements against, and stamping it for a
+        // card Telegram refused would make an unacknowledged count that can never
+        // reach zero.
+        return toolError(`Telegram refused the card: ${sent.error ?? "unknown error"}`);
+    }
+    await p.session.run(`MATCH (v:Visit {accountId: $accountId, visitId: $visitId})
+     SET v.cardSentAt = $at, v.cardMessageId = $messageId`, {
+        accountId: p.accountId,
+        visitId: p.visitId,
+        at: new Date().toISOString(),
+        messageId: sent.messageId ?? null,
+    });
+    const buttons = keyboard.inline_keyboard.flat().length;
+    p.emit(`[dispatch-tg] op=dispatch-sent visitId=${p.visitId} workerId=${worker.workerId} ` +
+        `chatId=${worker.telegramUserId} messageId=${sent.messageId ?? "none"} ` +
+        `buttons=${buttons} drawnFor=${visit.status}`);
+    return toolText(JSON.stringify({
+        vocabulary: p.cfg.vocabulary,
+        visitId: p.visitId,
+        workerId: worker.workerId,
+        chatId: worker.telegramUserId,
+        messageId: sent.messageId ?? null,
+        buttons,
+        drawnFor: visit.status,
+        droppedButtons: kb.dropped,
+    }, null, 2));
+}
+//# sourceMappingURL=notify-worker.js.map

package/payload/platform/plugins/dispatch/mcp/dist/tools/notify-worker.js.map

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

package/payload/platform/plugins/dispatch/mcp/dist/tools/site-location-set.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Give a site a position, so a live location can be measured against it.
+ *
+ * `:Site` declared `accountId`, `siteId`, `name` and `region` and nothing else,
+ * which is why the observed half of Task 2499's arrival pair had nothing to fire
+ * against: a worker could share his location all day and no code could say
+ * whether he was there. Task 2514 adds the postal address; this adds only what
+ * the geofence needs.
+ *
+ * The site must already exist. A MERGE would mint an empty site whose only
+ * property was a coordinate, and the mistyped id that produced it would never
+ * surface.
+ */
+import type { Session } from "neo4j-driver";
+import type { DispatchConfig } from "../lib/types.js";
+import { type ToolResult } from "./result.js";
+export interface SiteLocationSetParams {
+    session: Session;
+    accountId: string;
+    cfg: DispatchConfig;
+    emit: (line: string) => void;
+    siteId: string;
+    latitude: number;
+    longitude: number;
+    geofenceRadiusM?: number;
+}
+export declare function siteLocationSet(p: SiteLocationSetParams): Promise<ToolResult>;
+//# sourceMappingURL=site-location-set.d.ts.map

package/payload/platform/plugins/dispatch/mcp/dist/tools/site-location-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-location-set.d.ts","sourceRoot":"","sources":["../../src/tools/site-location-set.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,eAAe,CAAC,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2DnF"}

package/payload/platform/plugins/dispatch/mcp/dist/tools/site-location-set.js

@@ -0,0 +1,44 @@
+import { readNodeId } from "../lib/read.js";
+import { toolError, toolText } from "./result.js";
+export async function siteLocationSet(p) {
+    if (!Number.isFinite(p.latitude) || p.latitude < -90 || p.latitude > 90) {
+        return toolError(`latitude must be between -90 and 90; got ${p.latitude}.`);
+    }
+    if (!Number.isFinite(p.longitude) || p.longitude < -180 || p.longitude > 180) {
+        return toolError(`longitude must be between -180 and 180; got ${p.longitude}.`);
+    }
+    // Zero is refused rather than stored. A zero-metre fence puts every worker
+    // outside it for ever, which reads exactly like a geofence that works and
+    // nobody attending.
+    if (p.geofenceRadiusM !== undefined &&
+        (!Number.isFinite(p.geofenceRadiusM) || p.geofenceRadiusM <= 0)) {
+        return toolError(`geofenceRadiusM must be a positive number of metres; got ${p.geofenceRadiusM}.`);
+    }
+    const existing = await readNodeId(p.session, p.accountId, "Site", "siteId", p.siteId);
+    if (!existing) {
+        return toolError(`No site "${p.siteId}" on this account.`);
+    }
+    const sets = ["s.latitude = $latitude", "s.longitude = $longitude"];
+    const params = {
+        accountId: p.accountId,
+        siteId: p.siteId,
+        latitude: p.latitude,
+        longitude: p.longitude,
+    };
+    // Written only when supplied, so a call that sets coordinates never clears a
+    // radius somebody set earlier.
+    if (p.geofenceRadiusM !== undefined) {
+        sets.push("s.geofenceRadiusM = $geofenceRadiusM");
+        params.geofenceRadiusM = p.geofenceRadiusM;
+    }
+    await p.session.run(`MATCH (s:Site {accountId: $accountId, siteId: $siteId}) SET ${sets.join(", ")}`, params);
+    p.emit(`[dispatch] op=site-location siteId=${p.siteId} lat=${p.latitude} lon=${p.longitude} ` +
+        `radiusM=${p.geofenceRadiusM ?? "account-default"}`);
+    return toolText(JSON.stringify({
+        siteId: p.siteId,
+        latitude: p.latitude,
+        longitude: p.longitude,
+        geofenceRadiusM: p.geofenceRadiusM ?? null,
+    }, null, 2));
+}
+//# sourceMappingURL=site-location-set.js.map

package/payload/platform/plugins/dispatch/mcp/dist/tools/site-location-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-location-set.js","sourceRoot":"","sources":["../../src/tools/site-location-set.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAmB,MAAM,aAAa,CAAC;AAanE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,CAAwB;IAC5D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,QAAQ,GAAG,EAAE,EAAE,CAAC;QACxE,OAAO,SAAS,CAAC,4CAA4C,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;QAC7E,OAAO,SAAS,CAAC,+CAA+C,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;IAClF,CAAC;IACD,2EAA2E;IAC3E,0EAA0E;IAC1E,oBAAoB;IACpB,IACE,CAAC,CAAC,eAAe,KAAK,SAAS;QAC/B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,EAC/D,CAAC;QACD,OAAO,SAAS,CACd,4DAA4D,CAAC,CAAC,eAAe,GAAG,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACtF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,SAAS,CAAC,YAAY,CAAC,CAAC,MAAM,oBAAoB,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,wBAAwB,EAAE,0BAA0B,CAAC,CAAC;IACpE,MAAM,MAAM,GAA4B;QACtC,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,SAAS,EAAE,CAAC,CAAC,SAAS;KACvB,CAAC;IACF,6EAA6E;IAC7E,+BAA+B;IAC/B,IAAI,CAAC,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QAClD,MAAM,CAAC,eAAe,GAAG,CAAC,CAAC,eAAe,CAAC;IAC7C,CAAC;IACD,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,CACjB,+DAA+D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAChF,MAAM,CACP,CAAC;IAEF,CAAC,CAAC,IAAI,CACJ,sCAAsC,CAAC,CAAC,MAAM,QAAQ,CAAC,CAAC,QAAQ,QAAQ,CAAC,CAAC,SAAS,GAAG;QACpF,WAAW,CAAC,CAAC,eAAe,IAAI,iBAAiB,EAAE,CACtD,CAAC;IAEF,OAAO,QAAQ,CACb,IAAI,CAAC,SAAS,CACZ;QACE,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,IAAI;KAC3C,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/dispatch/mcp/dist/tools/site-upsert.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Create a site, or give an existing one its postal address.
+ *
+ * This is the write that did not exist. Nothing in the platform created a
+ * `:Site`: the dispatch-setup skill says so in as many words, `dispatch-job-create`
+ * refuses when the site is absent, and every site therefore carried whatever a
+ * generic graph write happened to put on it — which was a name. A worker read
+ * that name off the card and had no street to drive to.
+ *
+ * **The write order is load-bearing and it is not the obvious one.**
+ * `writeNodeWithEdges` rejects a zero-relationship write, so the address node
+ * cannot be written first and then attached: it has no adjacency until the site
+ * exists, and the edge needs the site's node id. The order is therefore
+ * customer, then site, then address.
+ *
+ * The customer is the caller's when they name one and the site's existing
+ * `HAS_SITE` source when they do not. Without that fallback, the office would
+ * have to know a site's customer to correct its postcode.
+ *
+ * **The three address properties travel together.** A postcode with no street
+ * renders on the card as a half address while the census counts the site
+ * addressed, which is the exact failure the whole task exists to remove.
+ */
+import type { Session } from "neo4j-driver";
+import type { DispatchConfig, WriteFn } from "../lib/types.js";
+import { type ToolResult } from "./result.js";
+export interface SiteUpsertParams {
+    session: Session;
+    write: WriteFn;
+    accountId: string;
+    createdBy: Record<string, string | undefined>;
+    cfg: DispatchConfig;
+    emit: (line: string) => void;
+    siteId: string;
+    name?: string;
+    region?: string;
+    customerId?: string;
+    streetAddress?: string;
+    addressLocality?: string;
+    postalCode?: string;
+}
+export declare function siteUpsert(p: SiteUpsertParams): Promise<ToolResult>;
+//# sourceMappingURL=site-upsert.d.ts.map

package/payload/platform/plugins/dispatch/mcp/dist/tools/site-upsert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-upsert.d.ts","sourceRoot":"","sources":["../../src/tools/site-upsert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/D,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAKnE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC9C,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAgBD,wBAAsB,UAAU,CAAC,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqKzE"}