@rubytech/create-realagent-code 0.1.573 → 0.1.575

package/payload/platform/plugins/dispatch/mcp/dist/lib/intake.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The intake queue's pure parts: which required fields a draft does not carry,
+ * and the three lifecycle lines.
+ *
+ * Kept apart from the tool bodies so the line shapes are asserted without a
+ * session, a write function or a clock. The failure this queue exists to expose
+ * is a draft nobody decided on, which emits nothing of its own, so the lines are
+ * tested directly rather than inferred from a tool's return value.
+ */
+/** Exactly what `dispatch-job-create` requires. `description` is optional there. */
+export declare const REQUIRED_FIELDS: readonly ["type", "siteId", "customerId"];
+export interface DraftFields {
+    type?: string;
+    siteId?: string;
+    customerId?: string;
+    description?: string;
+}
+/** Whether each required field resolved to a real value on this account. */
+export interface Resolution {
+    type: boolean;
+    siteId: boolean;
+    customerId: boolean;
+}
+/**
+ * A supplied value that does not resolve is treated exactly as an omitted one.
+ * One rule for all three, whether the lookup was against the config (`type`) or
+ * against the graph (`siteId`, `customerId`): two vocabularies for one condition
+ * would hand the reviewer two lists to reconcile before they could act.
+ */
+export declare function missingRequired(r: Resolution): string[];
+/** Empty renders `none`, never a blank value: a blank field reads as a bug. */
+export declare function csvOrNone(items: readonly string[]): string;
+export declare function formatReceived(reqId: string, source: string, ref: string): string;
+export declare function formatDrafted(reqId: string, draftId: string, fields: readonly string[], missing: readonly string[]): string;
+export declare function formatDecided(draftId: string, verdict: string, by: string, jobId: string | null, reason: string | null): string;
+//# sourceMappingURL=intake.d.ts.map

package/payload/platform/plugins/dispatch/mcp/dist/lib/intake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake.d.ts","sourceRoot":"","sources":["../../src/lib/intake.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oFAAoF;AACpF,eAAO,MAAM,eAAe,2CAA4C,CAAC;AAEzE,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE,CAEvD;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE1D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,MAAM,CAKR;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,MAAM,CAKR"}

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

@@ -0,0 +1,36 @@
+/**
+ * The intake queue's pure parts: which required fields a draft does not carry,
+ * and the three lifecycle lines.
+ *
+ * Kept apart from the tool bodies so the line shapes are asserted without a
+ * session, a write function or a clock. The failure this queue exists to expose
+ * is a draft nobody decided on, which emits nothing of its own, so the lines are
+ * tested directly rather than inferred from a tool's return value.
+ */
+/** Exactly what `dispatch-job-create` requires. `description` is optional there. */
+export const REQUIRED_FIELDS = ["type", "siteId", "customerId"];
+/**
+ * A supplied value that does not resolve is treated exactly as an omitted one.
+ * One rule for all three, whether the lookup was against the config (`type`) or
+ * against the graph (`siteId`, `customerId`): two vocabularies for one condition
+ * would hand the reviewer two lists to reconcile before they could act.
+ */
+export function missingRequired(r) {
+    return REQUIRED_FIELDS.filter((f) => !r[f]);
+}
+/** Empty renders `none`, never a blank value: a blank field reads as a bug. */
+export function csvOrNone(items) {
+    return items.length === 0 ? "none" : items.join(",");
+}
+export function formatReceived(reqId, source, ref) {
+    return `[dispatch] op=intake-received reqId=${reqId} source=${source} ref=${ref}`;
+}
+export function formatDrafted(reqId, draftId, fields, missing) {
+    return (`[dispatch] op=intake-drafted reqId=${reqId} draftId=${draftId} ` +
+        `fields=${csvOrNone(fields)} missing=${csvOrNone(missing)}`);
+}
+export function formatDecided(draftId, verdict, by, jobId, reason) {
+    return (`[dispatch] op=intake-decided draftId=${draftId} verdict=${verdict} by=${by} ` +
+        `jobId=${jobId ?? "none"} reason=${reason ?? "none"}`);
+}
+//# sourceMappingURL=intake.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intake.js","sourceRoot":"","sources":["../../src/lib/intake.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC;AAgBzE;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,CAAa;IAC3C,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,SAAS,CAAC,KAAwB;IAChD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,MAAc,EAAE,GAAW;IACvE,OAAO,uCAAuC,KAAK,WAAW,MAAM,QAAQ,GAAG,EAAE,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,OAAe,EACf,MAAyB,EACzB,OAA0B;IAE1B,OAAO,CACL,sCAAsC,KAAK,YAAY,OAAO,GAAG;QACjE,UAAU,SAAS,CAAC,MAAM,CAAC,YAAY,SAAS,CAAC,OAAO,CAAC,EAAE,CAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,OAAe,EACf,EAAU,EACV,KAAoB,EACpB,MAAqB;IAErB,OAAO,CACL,wCAAwC,OAAO,YAAY,OAAO,OAAO,EAAE,GAAG;QAC9E,SAAS,KAAK,IAAI,MAAM,WAAW,MAAM,IAAI,MAAM,EAAE,CACtD,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/dispatch/mcp/dist/lib/keyboard.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The card's buttons live in `platform/lib/dispatch-read`, so the plugin that
+ * draws a card and the UI route that reads the press share one implementation.
+ *
+ * This module stays as the plugin's import surface, mirroring `read.ts` and
+ * `lifecycle.ts`. Nothing here changes behaviour; anything that does is a
+ * mistake, and the plugin's own suite is the guard.
+ */
+export { CALLBACK_DATA_MAX_BYTES, buildVisitKeyboard, dispatchCallbackData, parseDispatchCallback, } from "../../../../../lib/dispatch-read/dist/index.js";
+export type { DispatchButton, VisitKeyboard, } from "../../../../../lib/dispatch-read/dist/index.js";
+//# sourceMappingURL=keyboard.d.ts.map

package/payload/platform/plugins/dispatch/mcp/dist/lib/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/lib/keyboard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gDAAgD,CAAC;AAExD,YAAY,EACV,cAAc,EACd,aAAa,GACd,MAAM,gDAAgD,CAAC"}

package/payload/platform/plugins/dispatch/mcp/dist/lib/keyboard.js

@@ -0,0 +1,10 @@
+/**
+ * The card's buttons live in `platform/lib/dispatch-read`, so the plugin that
+ * draws a card and the UI route that reads the press share one implementation.
+ *
+ * This module stays as the plugin's import surface, mirroring `read.ts` and
+ * `lifecycle.ts`. Nothing here changes behaviour; anything that does is a
+ * mistake, and the plugin's own suite is the guard.
+ */
+export { CALLBACK_DATA_MAX_BYTES, buildVisitKeyboard, dispatchCallbackData, parseDispatchCallback, } from "../../../../../lib/dispatch-read/dist/index.js";
+//# sourceMappingURL=keyboard.js.map

package/payload/platform/plugins/dispatch/mcp/dist/lib/keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../../src/lib/keyboard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gDAAgD,CAAC"}

package/payload/platform/plugins/dispatch/mcp/dist/lib/read.d.ts

@@ -6,6 +6,6 @@
  * not change. Anything that alters behaviour here is a mistake, and the
  * plugin's own suite is the guard.
  */
-export { readCommitments, readJob, readJobs, readNodeId, readSiteHistory, readVisit, readVisitRecordState, readVisitsForJob, readVisitsInWindow, } from "../../../../../lib/dispatch-read/dist/index.js";
-export type { Commitment, JobListFilter, JobRow, VisitRow, } from "../../../../../lib/dispatch-read/dist/index.js";
+export { distanceM, readCommitments, readDraft, readDrafts, readJob, readJobs, readNodeId, readPreviousVisits, readSiteHistory, readSiteLocation, readVisit, readVisitRecordState, readVisitsForJob, readVisitsInWindow, resolveAccountZone, ymdInZone, zonedDayStartUtc, } from "../../../../../lib/dispatch-read/dist/index.js";
+export type { Commitment, DraftRow, JobListFilter, JobRow, PreviousVisit, SiteLocation, VisitRow, } from "../../../../../lib/dispatch-read/dist/index.js";
 //# sourceMappingURL=read.d.ts.map

package/payload/platform/plugins/dispatch/mcp/dist/lib/read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/lib/read.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,eAAe,EACf,OAAO,EACP,QAAQ,EACR,UAAU,EACV,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gDAAgD,CAAC;AAExD,YAAY,EACV,UAAU,EACV,aAAa,EACb,MAAM,EACN,QAAQ,GACT,MAAM,gDAAgD,CAAC"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/lib/read.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAIL,SAAS,EACT,eAAe,EACf,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAIlB,kBAAkB,EAClB,SAAS,EACT,gBAAgB,GACjB,MAAM,gDAAgD,CAAC;AAExD,YAAY,EACV,UAAU,EACV,QAAQ,EACR,aAAa,EACb,MAAM,EACN,aAAa,EACb,YAAY,EACZ,QAAQ,GACT,MAAM,gDAAgD,CAAC"}

package/payload/platform/plugins/dispatch/mcp/dist/lib/read.js

@@ -6,5 +6,13 @@
  * not change. Anything that alters behaviour here is a mistake, and the
  * plugin's own suite is the guard.
  */
-export { readCommitments, readJob, readJobs, readNodeId, readSiteHistory, readVisit, readVisitRecordState, readVisitsForJob, readVisitsInWindow, } from "../../../../../lib/dispatch-read/dist/index.js";
+export { 
+// The great-circle maths, shared with the geofence. Two copies of one formula
+// drift, and a geofence and a travel estimate disagreeing about how far apart
+// two points are would be unexplainable to an operator.
+distanceM, readCommitments, readDraft, readDrafts, readJob, readJobs, readNodeId, readPreviousVisits, readSiteHistory, readSiteLocation, readVisit, readVisitRecordState, readVisitsForJob, readVisitsInWindow, 
+// The account's own day boundary. "That day" is not a UTC fact, and falling
+// back to a process-local zone is the defect Task 2280 left on thirteen
+// surfaces: it renders plausibly and is wrong.
+resolveAccountZone, ymdInZone, zonedDayStartUtc, } from "../../../../../lib/dispatch-read/dist/index.js";
 //# sourceMappingURL=read.js.map

package/payload/platform/plugins/dispatch/mcp/dist/lib/read.js.map

@@ -1 +1 @@
-{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/lib/read.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,eAAe,EACf,OAAO,EACP,QAAQ,EACR,UAAU,EACV,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gDAAgD,CAAC"}
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/lib/read.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO;AACL,8EAA8E;AAC9E,8EAA8E;AAC9E,wDAAwD;AACxD,SAAS,EACT,eAAe,EACf,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB;AAClB,4EAA4E;AAC5E,wEAAwE;AACxE,+CAA+C;AAC/C,kBAAkB,EAClB,SAAS,EACT,gBAAgB,GACjB,MAAM,gDAAgD,CAAC"}

package/payload/platform/plugins/dispatch/mcp/dist/lib/travel.d.ts

@@ -0,0 +1,43 @@
+/**
+ * How long it takes to get from the last job to the next one.
+ *
+ * The estimator is an interface with one shipped implementation, injected into
+ * the tool the way `write` is, so the plugin holds no network client and the
+ * refusal path is testable without one. An account that provisions a real
+ * routing service supplies its own; nothing here reaches the network.
+ *
+ * **A refusal is a throw, never a null.** `SiteLocation.latitude` and
+ * `.longitude` are both nullable, so "this site has no coordinates" and "the
+ * service did not answer" are both reasons an estimate cannot be produced, and
+ * both belong in one channel whose message the caller logs verbatim. A null
+ * return would force the caller to invent the reason, and the reason is the
+ * only part an operator can act on.
+ */
+import { type SiteLocation } from "./read.js";
+/** What the tool needs of an estimator, and all it may assume. */
+export interface TravelEstimator {
+    /**
+     * The method, written into `provider=` on the lifecycle line. A method name,
+     * never an endpoint and never a key: this string lands in `server.log`.
+     */
+    readonly name: string;
+    /**
+     * Minutes between two sites, or a throw naming why it could not measure.
+     * Never a sentinel: a zero here means the two sites are at one point.
+     */
+    minutes(from: SiteLocation, to: SiteLocation): Promise<number>;
+}
+/**
+ * Straight-line distance over a fixed road speed.
+ *
+ * This is a lower bound on a drive, not a drive time: an estuary, a motorway
+ * junction and a one-way system all cost minutes it cannot see. It ships as the
+ * default because it needs no network, no account and no third-party service,
+ * so every install has an estimate on day one, and because `provider=` carries
+ * the method into the log where the assumption stays visible rather than
+ * becoming folklore.
+ *
+ * `roadSpeedKmh` is an assumption about the account's roads, not a measurement.
+ */
+export declare function straightLineEstimator(roadSpeedKmh: number): TravelEstimator;
+//# sourceMappingURL=travel.d.ts.map

package/payload/platform/plugins/dispatch/mcp/dist/lib/travel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"travel.d.ts","sourceRoot":"","sources":["../../src/lib/travel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzD,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChE;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,CAwB3E"}

package/payload/platform/plugins/dispatch/mcp/dist/lib/travel.js

@@ -0,0 +1,53 @@
+/**
+ * How long it takes to get from the last job to the next one.
+ *
+ * The estimator is an interface with one shipped implementation, injected into
+ * the tool the way `write` is, so the plugin holds no network client and the
+ * refusal path is testable without one. An account that provisions a real
+ * routing service supplies its own; nothing here reaches the network.
+ *
+ * **A refusal is a throw, never a null.** `SiteLocation.latitude` and
+ * `.longitude` are both nullable, so "this site has no coordinates" and "the
+ * service did not answer" are both reasons an estimate cannot be produced, and
+ * both belong in one channel whose message the caller logs verbatim. A null
+ * return would force the caller to invent the reason, and the reason is the
+ * only part an operator can act on.
+ */
+import { distanceM } from "./read.js";
+/** True when the site carries both coordinates. Zero is a real coordinate. */
+function located(s) {
+    return s.latitude !== null && s.longitude !== null;
+}
+/**
+ * Straight-line distance over a fixed road speed.
+ *
+ * This is a lower bound on a drive, not a drive time: an estuary, a motorway
+ * junction and a one-way system all cost minutes it cannot see. It ships as the
+ * default because it needs no network, no account and no third-party service,
+ * so every install has an estimate on day one, and because `provider=` carries
+ * the method into the log where the assumption stays visible rather than
+ * becoming folklore.
+ *
+ * `roadSpeedKmh` is an assumption about the account's roads, not a measurement.
+ */
+export function straightLineEstimator(roadSpeedKmh) {
+    if (!(roadSpeedKmh > 0)) {
+        // A zero or negative divisor yields Infinity or a negative duration, and
+        // either one formats into the log line as though it were measured.
+        throw new Error(`road speed must be greater than zero, got ${roadSpeedKmh}`);
+    }
+    return {
+        name: "straight-line",
+        async minutes(from, to) {
+            const missing = [from, to].filter((s) => !located(s)).map((s) => s.siteId);
+            if (missing.length > 0) {
+                // Named, so the office knows which site to run dispatch-site-location-set
+                // against. "unavailable" on its own is a dead end.
+                throw new Error(`no coordinates on ${missing.join(" and ")}; set them with dispatch-site-location-set`);
+            }
+            const metres = distanceM({ latitude: from.latitude, longitude: from.longitude }, { latitude: to.latitude, longitude: to.longitude });
+            return Math.round((metres / 1000 / roadSpeedKmh) * 60);
+        },
+    };
+}
+//# sourceMappingURL=travel.js.map

package/payload/platform/plugins/dispatch/mcp/dist/lib/travel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"travel.js","sourceRoot":"","sources":["../../src/lib/travel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,SAAS,EAAqB,MAAM,WAAW,CAAC;AAgBzD,8EAA8E;AAC9E,SAAS,OAAO,CAAC,CAAe;IAC9B,OAAO,CAAC,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACxD,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,EAAE,CAAC;QACxB,yEAAyE;QACzE,mEAAmE;QACnE,MAAM,IAAI,KAAK,CAAC,6CAA6C,YAAY,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,KAAK,CAAC,OAAO,CAAC,IAAkB,EAAE,EAAgB;YAChD,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC3E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,0EAA0E;gBAC1E,mDAAmD;gBACnD,MAAM,IAAI,KAAK,CACb,qBAAqB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,4CAA4C,CACvF,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,SAAS,CACtB,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAkB,EAAE,SAAS,EAAE,IAAI,CAAC,SAAmB,EAAE,EAC1E,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAkB,EAAE,SAAS,EAAE,EAAE,CAAC,SAAmB,EAAE,CACvE,CAAC;YACF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/dispatch/mcp/dist/lib/types.d.ts

@@ -40,6 +40,16 @@ export interface Worker {
     readonly name: string;
     readonly qualifications: readonly string[];
     readonly workingHours: WorkingHours;
+    /**
+     * The Telegram user id this worker signs in and receives cards as (Task 2502
+     * bound it, Task 2510 sends to it). Absent means the worker has no field
+     * surface; a card for him is refused by name rather than sent to somebody.
+     *
+     * Mirrors `platform/lib/dispatch-read/src/types.ts`. The two declarations are
+     * one contract read by two packages, so a field added to either belongs in
+     * both.
+     */
+    readonly telegramUserId?: string;
 }
 export interface RecordsConfig {
     /** Checklist template per job type name. */
@@ -128,7 +138,8 @@ export type WriteFn = (params: {
     };
     mergeOn?: string[];
 }) => Promise<{
-    elementId: string;
-    created: boolean;
+    nodeId: string;
+    labels: string[];
+    edgesCreated: number;
 }>;
 //# sourceMappingURL=types.d.ts.map

package/payload/platform/plugins/dispatch/mcp/dist/lib/types.d.ts.map

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

package/payload/platform/plugins/dispatch/mcp/dist/scripts/converge-visit-instants.d.ts

@@ -0,0 +1,6 @@
+export declare function convergeVisitInstants(accountIds: string[]): Promise<{
+    scanned: number;
+    rewritten: number;
+    unparseable: number;
+}>;
+//# sourceMappingURL=converge-visit-instants.d.ts.map

package/payload/platform/plugins/dispatch/mcp/dist/scripts/converge-visit-instants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converge-visit-instants.d.ts","sourceRoot":"","sources":["../../src/scripts/converge-visit-instants.ts"],"names":[],"mappings":"AAqCA,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAqEtE"}

package/payload/platform/plugins/dispatch/mcp/dist/scripts/converge-visit-instants.js

@@ -0,0 +1,102 @@
+/**
+ * Task 2513 — one-shot convergence of `:Visit.startDate` and `:Visit.endDate`
+ * onto canonical UTC.
+ *
+ * Run by the installer immediately after `seed-neo4j.sh`, beside Task 2213's
+ * `:Event` convergence. It is an installer step, not a
+ * `platform/scripts/backfill-*`, because nothing invokes anything in that
+ * directory: those run only when an operator SSHes in, which leaves the rows
+ * wrong on every box nobody visits. The shape follows Task 1623's
+ * `converge-client-admins.ts` — "reaching all installs and brands without a
+ * per-box script".
+ *
+ * It needs no connection code of its own. `dispatch-read`'s `withSession`
+ * already refuses to default `NEO4J_URI`, which is what keeps a co-resident
+ * brand's graph untouched, and resolves the password from `PLATFORM_ROOT`.
+ *
+ * It imports the same `normaliseInstant` the writer uses, so the migration and
+ * the writer cannot disagree about what canonical means.
+ *
+ *   PLATFORM_ROOT=... NEO4J_URI=... node dist/scripts/converge-visit-instants.js
+ */
+import { resolve } from "node:path";
+import { isCanonicalInstant, normaliseInstant, } from "../../../../../lib/canonical-instant/dist/index.js";
+import { resolveAccountZone, withSession } from "../../../../../lib/dispatch-read/dist/index.js";
+import { enumerateValidAccountIds } from "../../../../../lib/account-enumeration/dist/index.js";
+const TAG = "[dispatch]";
+export async function convergeVisitInstants(accountIds) {
+    let scanned = 0;
+    let rewritten = 0;
+    let unparseable = 0;
+    for (const accountId of accountIds) {
+        const zone = await resolveAccountZone(accountId);
+        const rows = await withSession(async (session) => {
+            const r = await session.run(`MATCH (v:Visit {accountId: $accountId})
+         RETURN v.visitId AS visitId, v.startDate AS startDate, v.endDate AS endDate`, { accountId });
+            return r.records.map((g) => ({
+                visitId: String(g.get("visitId")),
+                startDate: g.get("startDate") ?? null,
+                endDate: g.get("endDate") ?? null,
+            }));
+        });
+        for (const row of rows) {
+            scanned++;
+            // A NULL instant is not a defect: a visit can carry no end. Only a stored
+            // value that is not canonical is in scope.
+            const needsStart = row.startDate !== null && !isCanonicalInstant(row.startDate);
+            const needsEnd = row.endDate !== null && !isCanonicalInstant(row.endDate);
+            if (!needsStart && !needsEnd)
+                continue;
+            let startOut = row.startDate;
+            let endOut = row.endDate;
+            try {
+                if (needsStart)
+                    startOut = normaliseInstant(row.startDate, zone);
+                if (needsEnd)
+                    endOut = normaliseInstant(row.endDate, zone);
+            }
+            catch (err) {
+                // Counted apart from `rewritten`, always. A row nobody could fix must
+                // never be reported as fixed.
+                unparseable++;
+                console.error(`${TAG} op=migration-refused visitId=${row.visitId} account=${accountId} ` +
+                    `startIn=${row.startDate ?? "-"} endIn=${row.endDate ?? "-"} tz=${zone ?? "none"} ` +
+                    `detail=${err instanceof Error ? err.message : String(err)}`);
+                continue;
+            }
+            await withSession(async (session) => {
+                await session.run(`MATCH (v:Visit {accountId: $accountId, visitId: $visitId})
+           SET v.startDate = $startDate, v.endDate = $endDate`, { accountId, visitId: row.visitId, startDate: startOut, endDate: endOut });
+            });
+            rewritten++;
+            console.error(`${TAG} op=rewrite visitId=${row.visitId} account=${accountId} ` +
+                `startIn=${row.startDate ?? "-"} startOut=${startOut ?? "-"} ` +
+                `endIn=${row.endDate ?? "-"} endOut=${endOut ?? "-"} tz=${zone ?? "none"}`);
+        }
+    }
+    // Printed even when nothing changed. A run that says nothing is
+    // indistinguishable from a run that never happened.
+    console.error(`${TAG} op=start-migration scanned=${scanned} rewritten=${rewritten} unparseable=${unparseable}`);
+    return { scanned, rewritten, unparseable };
+}
+async function main() {
+    // The accounts directory is derived from PLATFORM_ROOT, which is what the
+    // installer exports. `getAccountsDirFromEnv` is NOT used: it reads
+    // MAXY_PLATFORM_ROOT and loud-throws when unset, so calling it here would
+    // abort the migration on every install. Same resolution as
+    // `listLocalAccountIds` in the scheduling plugin's dispatcher-env.
+    const root = process.env.PLATFORM_ROOT;
+    if (!root) {
+        throw new Error("PLATFORM_ROOT environment variable is required");
+    }
+    await convergeVisitInstants(enumerateValidAccountIds(resolve(root, "..", "data/accounts")));
+}
+// Entry point only when executed directly, so the test can import the function
+// without running a migration.
+if (process.argv[1] && process.argv[1].endsWith("converge-visit-instants.js")) {
+    main().catch((err) => {
+        console.error(`${TAG} op=migration-fatal detail=${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=converge-visit-instants.js.map

package/payload/platform/plugins/dispatch/mcp/dist/scripts/converge-visit-instants.js.map

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

package/payload/platform/plugins/dispatch/mcp/dist/tools/allocate.d.ts

@@ -9,12 +9,19 @@
  */
 import type { Session } from "neo4j-driver";
 import type { DispatchConfig, WriteFn } from "../lib/types.js";
+import type { TravelEstimator } from "../lib/travel.js";
 import { type ToolResult } from "./result.js";
 export interface AllocateCandidatesParams {
     session: Session;
     accountId: string;
     cfg: DispatchConfig;
     emit: (line: string) => void;
+    /**
+     * How long it takes to reach this job from where the worker already is.
+     * Injected the way `write` is, so this module holds no network client and the
+     * refusal path is testable without one.
+     */
+    estimator: TravelEstimator;
     jobId: string;
     start: string;
     end?: string;
@@ -33,6 +40,17 @@ export interface AllocateParams {
     end?: string;
     purpose?: string;
     vehicleId?: string;
+    /**
+     * Add this worker to an EXISTING visit rather than creating a new one
+     * (Task 2512).
+     *
+     * Without it, staffing a second worker onto one job produced a second
+     * `:Visit` — two cards on the planner, two rows in every read, and no way to
+     * tell that from two genuinely separate visits. `start`, `end` and `purpose`
+     * are ignored when this is set: they belong to the visit, and the visit
+     * already exists.
+     */
+    visitId?: string;
 }
 export declare function allocate(p: AllocateParams): Promise<ToolResult>;
 //# sourceMappingURL=allocate.d.ts.map

package/payload/platform/plugins/dispatch/mcp/dist/tools/allocate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"allocate.d.ts","sourceRoot":"","sources":["../../src/tools/allocate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAU/D,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,wBAAwB;IACvC,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,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,kBAAkB,CACtC,CAAC,EAAE,wBAAwB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAiErB;AAED,MAAM,WAAW,cAAc;IAC7B,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,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAkKrE"}
+{"version":3,"file":"allocate.d.ts","sourceRoot":"","sources":["../../src/tools/allocate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAqB/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAInE,MAAM,WAAW,wBAAwB;IACvC,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;;;;OAIG;IACH,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAkED,wBAAsB,kBAAkB,CACtC,CAAC,EAAE,wBAAwB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAyIrB;AAED,MAAM,WAAW,cAAc;IAC7B,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,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA0RrE"}