@rubytech/create-realagent-code 0.1.570 → 0.1.572

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

@@ -0,0 +1,134 @@
+/**
+ * The dispatch config contract, and the result shapes for reading it.
+ *
+ * Everything an operator can name lives here as data: statuses and the legal
+ * transitions between them, job types and what qualification each needs,
+ * workers and what they hold, checklists and what a visit must carry before it
+ * closes, and the nouns the operator uses. None of it appears as a literal
+ * anywhere in this plugin's source — a taxi firm's fare/pickup/driver and a
+ * contractor's job/visit/engineer run identical code.
+ */
+export interface StatusDecl {
+    readonly name: string;
+    /** True when a job or visit that reaches this status is finished. */
+    readonly terminal: boolean;
+}
+/** One legal move, `[from, to]`. Absent from the list means refused. */
+export type Transition = readonly [string, string];
+export interface StatusConfig {
+    readonly job: readonly StatusDecl[];
+    readonly visit: readonly StatusDecl[];
+    readonly jobTransitions: readonly Transition[];
+    readonly visitTransitions: readonly Transition[];
+}
+export interface JobType {
+    readonly name: string;
+    /** A worker is offered for this type only if they hold this qualification. */
+    readonly requiredQualification: string;
+    readonly defaultDurationMin: number;
+    /**
+     * Hours from job creation to the SLA target. Omitted when the account sets no
+     * target for this type — omitted, never zero, because a zero would make every
+     * job of that type instantly overdue on the census.
+     */
+    readonly slaTargetHours?: number;
+}
+/** `{ mon: ["08:00", "17:00"] }`. Absent day means not working that day. */
+export type WorkingHours = Readonly<Record<string, readonly [string, string]>>;
+export interface Worker {
+    readonly workerId: string;
+    readonly name: string;
+    readonly qualifications: readonly string[];
+    readonly workingHours: WorkingHours;
+}
+export interface RecordsConfig {
+    /** Checklist template per job type name. */
+    readonly checklists: Readonly<Record<string, readonly string[]>>;
+    /**
+     * Field names a visit must carry before it may reach the keyed terminal
+     * visit status. Recognised names: `notes`, `media`, `parts`, `checklist`,
+     * `signature`.
+     */
+    readonly requiredBeforeTerminal: Readonly<Record<string, readonly string[]>>;
+}
+export interface Vocabulary {
+    readonly job: string;
+    readonly visit: string;
+    readonly worker: string;
+}
+export interface VehicleConfig {
+    /**
+     * When false, a vehicle passed to `dispatch-allocate` is refused rather than
+     * silently dropped. `:Vehicle` is declared in `schema-logistics.md`, so an
+     * account setting this true also enables that vertical.
+     */
+    readonly enabled: boolean;
+    /**
+     * Metres from a site centroid inside which a geofence observation counts as
+     * on site. Omitted when the account sets no default; an observation is then
+     * stored with its distance unqualified rather than dropped.
+     */
+    readonly defaultGeofenceRadiusM?: number;
+}
+export interface DispatchConfig {
+    readonly statuses: StatusConfig;
+    readonly jobTypes: readonly JobType[];
+    readonly workers: readonly Worker[];
+    readonly records: RecordsConfig;
+    readonly vocabulary: Vocabulary;
+    readonly vehicles: VehicleConfig;
+}
+/** `parseConfig` result. A refusal always names what was wrong. */
+export type ConfigResult = {
+    readonly ok: true;
+    readonly value: DispatchConfig;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/**
+ * `loadConfig` result. Absence is a named state, never a throw: module init
+ * runs this and must not throw, because plugin-system spawn enumerates
+ * tools/list with empty env and one boot throw empties the whole registry.
+ */
+export type LoadResult = {
+    readonly present: true;
+    readonly value: DispatchConfig;
+} | {
+    readonly present: false;
+    readonly reason: "no-account-dir" | "no-file" | "unreadable" | "invalid";
+    readonly detail?: string;
+};
+export interface ConfigAudit {
+    readonly statuses: number;
+    /** Declared statuses no transition ever reaches. */
+    readonly unreachable: readonly string[];
+    readonly terminal: number;
+    readonly jobTypes: number;
+    /** Job types whose required qualification no worker holds. */
+    readonly typesWithNoQualifiedWorker: readonly string[];
+    /** Workers holding no qualification at all. */
+    readonly workersWithNoQualification: readonly string[];
+}
+/** graph-write's `writeNodeWithEdges`, injected so tools stay testable. */
+export type WriteFn = (params: {
+    session: unknown;
+    labels: string[];
+    props: Record<string, unknown>;
+    relationships: Array<{
+        type: string;
+        direction: "outgoing" | "incoming";
+        targetNodeId: string;
+    }>;
+    createdBy: {
+        agent?: string;
+        session?: string;
+        tool?: string;
+        source?: string;
+    };
+    mergeOn?: string[];
+}) => Promise<{
+    elementId: string;
+    created: boolean;
+}>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"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/lib/types.js

@@ -0,0 +1,12 @@
+/**
+ * The dispatch config contract, and the result shapes for reading it.
+ *
+ * Everything an operator can name lives here as data: statuses and the legal
+ * transitions between them, job types and what qualification each needs,
+ * workers and what they hold, checklists and what a visit must carry before it
+ * closes, and the nouns the operator uses. None of it appears as a literal
+ * anywhere in this plugin's source — a taxi firm's fare/pickup/driver and a
+ * contractor's job/visit/engineer run identical code.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

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

@@ -0,0 +1,38 @@
+/**
+ * Who could go, and sending one of them.
+ *
+ * Two tools in one module because they share the candidate rule and must not
+ * disagree about it: `dispatch-allocate` re-checks the qualification rather
+ * than trusting that the caller passed a worker `dispatch-allocate-candidates`
+ * offered, since the two calls are minutes apart and the config can change
+ * between them.
+ */
+import type { Session } from "neo4j-driver";
+import type { DispatchConfig, WriteFn } from "../lib/types.js";
+import { type ToolResult } from "./result.js";
+export interface AllocateCandidatesParams {
+    session: Session;
+    accountId: string;
+    cfg: DispatchConfig;
+    emit: (line: string) => void;
+    jobId: string;
+    start: string;
+    end?: string;
+}
+export declare function allocateCandidates(p: AllocateCandidatesParams): Promise<ToolResult>;
+export interface AllocateParams {
+    session: Session;
+    write: WriteFn;
+    accountId: string;
+    createdBy: Record<string, string | undefined>;
+    cfg: DispatchConfig;
+    emit: (line: string) => void;
+    jobId: string;
+    workerId: string;
+    start: string;
+    end?: string;
+    purpose?: string;
+    vehicleId?: 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

@@ -0,0 +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"}

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

@@ -0,0 +1,167 @@
+import { formatAllocateCandidates, overlaps, selectCandidates, } from "../lib/allocate.js";
+import { checkTransition, formatTransitionRefused, initialStatus } from "../lib/lifecycle.js";
+import { newReqId, newVisitId } from "../lib/ids.js";
+import { readCommitments, readJob, readNodeId } from "../lib/read.js";
+import { toolError, toolText } from "./result.js";
+export async function allocateCandidates(p) {
+    const job = await readJob(p.session, p.accountId, p.jobId);
+    if (!job)
+        return toolError(`No ${p.cfg.vocabulary.job} "${p.jobId}" on this account.`);
+    if (!job.jobType) {
+        return toolError(`${p.cfg.vocabulary.job} "${p.jobId}" carries no type, so no qualification can be required of a ${p.cfg.vocabulary.worker}.`);
+    }
+    const type = p.cfg.jobTypes.find((t) => t.name === job.jobType);
+    if (!type) {
+        return toolError(`${p.cfg.vocabulary.job} "${p.jobId}" is type "${job.jobType}", which this account no longer declares. Re-type it or add the type back to the config.`);
+    }
+    const end = p.end ?? new Date(Date.parse(p.start) + type.defaultDurationMin * 60_000).toISOString();
+    const committed = await readCommitments(p.session, p.accountId, p.start, end);
+    // Narrow each worker's commitments to those genuinely overlapping the window
+    // before they are shown, so a "conflict" is always a real one.
+    const windowed = new Map([...committed].map(([workerId, list]) => [
+        workerId,
+        list.filter((c) => overlaps({ start: p.start, end }, c)),
+    ]));
+    const selection = selectCandidates({
+        jobType: job.jobType,
+        cfg: p.cfg,
+        commitments: windowed,
+    });
+    p.emit(formatAllocateCandidates({
+        jobId: p.jobId,
+        required: selection.required,
+        offered: selection.offered.length,
+        excluded: selection.excluded,
+    }));
+    return toolText(JSON.stringify({
+        jobId: p.jobId,
+        window: { start: p.start, end },
+        required: selection.required,
+        vocabulary: p.cfg.vocabulary,
+        // A busy candidate is offered WITH its conflicts, never dropped. The
+        // office double-books on purpose; hiding the option makes that call for
+        // them.
+        offered: selection.offered.map((c) => ({
+            workerId: c.workerId,
+            name: c.name,
+            free: c.conflicts.length === 0,
+            conflicts: c.conflicts,
+        })),
+        excluded: selection.excluded,
+    }, null, 2));
+}
+export async function allocate(p) {
+    const reqId = newReqId();
+    const job = await readJob(p.session, p.accountId, p.jobId);
+    if (!job)
+        return toolError(`No ${p.cfg.vocabulary.job} "${p.jobId}" on this account.`);
+    const type = p.cfg.jobTypes.find((t) => t.name === job.jobType);
+    const worker = p.cfg.workers.find((w) => w.workerId === p.workerId);
+    if (!worker) {
+        return toolError(`"${p.workerId}" is not a ${p.cfg.vocabulary.worker} on this account. Declared: ${p.cfg.workers.map((w) => w.workerId).join(", ")}.`);
+    }
+    if (type && !worker.qualifications.includes(type.requiredQualification)) {
+        return toolError(`${worker.name} does not hold "${type.requiredQualification}", which "${type.name}" requires.`);
+    }
+    if (p.vehicleId !== undefined && !p.cfg.vehicles.enabled) {
+        // Refused, not dropped. Silently ignoring the vehicle would leave the
+        // caller believing a vehicle was assigned.
+        return toolError(`This account does not assign vehicles (vehicles.enabled is false in dispatch/config.json), so vehicle "${p.vehicleId}" cannot be attached.`);
+    }
+    const engineerNodeId = await readNodeId(p.session, p.accountId, "Engineer", "engineerId", p.workerId);
+    if (!engineerNodeId) {
+        return toolError(`${p.cfg.vocabulary.worker} "${p.workerId}" is declared in dispatch/config.json but has no :Person:Engineer node on this account. Create it with memory-update before allocating.`);
+    }
+    let vehicleNodeId = null;
+    if (p.vehicleId !== undefined) {
+        vehicleNodeId = await readNodeId(p.session, p.accountId, "Vehicle", "vehicleId", p.vehicleId);
+        if (!vehicleNodeId) {
+            return toolError(`No vehicle "${p.vehicleId}" on this account.`);
+        }
+    }
+    const end = p.end ??
+        new Date(Date.parse(p.start) + (type?.defaultDurationMin ?? 60) * 60_000).toISOString();
+    const visitId = newVisitId();
+    const checklist = job.jobType ? (p.cfg.records.checklists[job.jobType] ?? []) : [];
+    await p.write({
+        session: p.session,
+        labels: ["Visit"],
+        props: {
+            accountId: p.accountId,
+            visitId,
+            status: initialStatus("visit", p.cfg),
+            startDate: p.start,
+            endDate: end,
+            purpose: p.purpose ?? job.jobType ?? p.cfg.vocabulary.visit,
+            checklist,
+            checklistDone: [],
+            notes: [],
+            media: [],
+            parts: [],
+            signatures: [],
+        },
+        relationships: [
+            { type: "ATTENDED_BY", direction: "outgoing", targetNodeId: engineerNodeId },
+            ...(vehicleNodeId === null
+                ? []
+                : [
+                    {
+                        type: "USED_VEHICLE",
+                        direction: "outgoing",
+                        targetNodeId: vehicleNodeId,
+                    },
+                ]),
+        ],
+        createdBy: p.createdBy,
+        mergeOn: ["visitId"],
+    });
+    await p.session.run(`MATCH (j:Job {accountId: $accountId, jobId: $jobId})
+     MATCH (v:Visit {accountId: $accountId, visitId: $visitId})
+     MERGE (j)-[:HAS_VISIT]->(v)`, { accountId: p.accountId, jobId: p.jobId, visitId });
+    // Move the job along its own configured edge, but ONLY when the account
+    // declares exactly one way out of where it is. A config that branches — say
+    // New → Allocated and New → Cancelled — offers no basis for choosing, and
+    // picking whichever pair happens to be listed first could cancel a job on
+    // the act of staffing it. Where it branches, the job stays put and the
+    // operator moves it with dispatch-visit-status-set or its own decision.
+    const outgoing = p.cfg.statuses.jobTransitions.filter(([from]) => from === job.status);
+    const nextJobStatus = outgoing.length === 1 ? outgoing[0][1] : null;
+    if (nextJobStatus !== null) {
+        const check = checkTransition("job", job.status, nextJobStatus, p.cfg);
+        if (check.legal) {
+            await p.session.run(`MATCH (j:Job {accountId: $accountId, jobId: $jobId}) SET j.status = $status`, { accountId: p.accountId, jobId: p.jobId, status: nextJobStatus });
+        }
+        else {
+            p.emit(formatTransitionRefused({
+                jobId: p.jobId,
+                visitId,
+                from: job.status,
+                to: nextJobStatus,
+                reason: check.reason,
+            }));
+        }
+    }
+    else if (outgoing.length > 1) {
+        // Not a refusal — nothing was attempted. Said out loud because a job that
+        // stays in its opening status after a successful allocation otherwise
+        // looks like the status write silently failed.
+        p.emit(`[dispatch] op=job-status-ambiguous jobId=${p.jobId} from=${job.status} ` +
+            `candidates=${outgoing.map(([, to]) => to).join(",")}`);
+    }
+    p.emit(`[dispatch] op=allocate jobId=${p.jobId} visitId=${visitId} workerId=${p.workerId} ` +
+        `vehicleId=${p.vehicleId ?? "none"} start=${p.start}`);
+    return toolText(JSON.stringify({
+        reqId,
+        jobId: p.jobId,
+        visitId,
+        workerId: p.workerId,
+        vehicleId: p.vehicleId ?? null,
+        start: p.start,
+        end,
+        status: initialStatus("visit", p.cfg),
+        jobStatus: nextJobStatus ?? job.status,
+        checklist,
+        vocabulary: p.cfg.vocabulary,
+    }, null, 2));
+}
+//# sourceMappingURL=allocate.js.map

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

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

package/payload/platform/plugins/dispatch/mcp/dist/tools/config-get.d.ts

@@ -0,0 +1,15 @@
+/**
+ * What this account calls things, and what it will let you do.
+ *
+ * One read so the agent and the planner share a single source for the status
+ * set, the job types, the roster and the nouns. Without it each surface would
+ * re-read config.json and they would drift on the day somebody edits it.
+ *
+ * The audit rides along because an operator asking "what can I do here?" is
+ * exactly the moment an unreachable status or an unstaffable job type is worth
+ * knowing about.
+ */
+import type { DispatchConfig } from "../lib/types.js";
+import { type ToolResult } from "./result.js";
+export declare function configGet(cfg: DispatchConfig): ToolResult;
+//# sourceMappingURL=config-get.d.ts.map

package/payload/platform/plugins/dispatch/mcp/dist/tools/config-get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-get.d.ts","sourceRoot":"","sources":["../../src/tools/config-get.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAExD,wBAAgB,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,UAAU,CA0BzD"}

package/payload/platform/plugins/dispatch/mcp/dist/tools/config-get.js

@@ -0,0 +1,24 @@
+import { auditConfig } from "../lib/config.js";
+import { toolText } from "./result.js";
+export function configGet(cfg) {
+    return toolText(JSON.stringify({
+        vocabulary: cfg.vocabulary,
+        statuses: {
+            job: cfg.statuses.job,
+            visit: cfg.statuses.visit,
+            jobTransitions: cfg.statuses.jobTransitions,
+            visitTransitions: cfg.statuses.visitTransitions,
+        },
+        jobTypes: cfg.jobTypes,
+        workers: cfg.workers.map((w) => ({
+            workerId: w.workerId,
+            name: w.name,
+            qualifications: w.qualifications,
+            workingHours: w.workingHours,
+        })),
+        records: cfg.records,
+        vehicles: cfg.vehicles,
+        audit: auditConfig(cfg),
+    }, null, 2));
+}
+//# sourceMappingURL=config-get.js.map

package/payload/platform/plugins/dispatch/mcp/dist/tools/config-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-get.js","sourceRoot":"","sources":["../../src/tools/config-get.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAmB,MAAM,aAAa,CAAC;AAExD,MAAM,UAAU,SAAS,CAAC,GAAmB;IAC3C,OAAO,QAAQ,CACb,IAAI,CAAC,SAAS,CACZ;QACE,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,QAAQ,EAAE;YACR,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG;YACrB,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK;YACzB,cAAc,EAAE,GAAG,CAAC,QAAQ,CAAC,cAAc;YAC3C,gBAAgB,EAAE,GAAG,CAAC,QAAQ,CAAC,gBAAgB;SAChD;QACD,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,YAAY,EAAE,CAAC,CAAC,YAAY;SAC7B,CAAC,CAAC;QACH,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC;KACxB,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/dispatch/mcp/dist/tools/job-create.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Create a job. This is the write that did not exist: the reference account's
+ * own PRD says there is no way to create, allocate or send a job except by
+ * editing the database by hand.
+ *
+ * The job's opening status is the account's FIRST declared job status, not a
+ * literal. Its SLA target is computed from the job type's configured hours; a
+ * type with no configured target leaves `slaTargetAt` unset rather than writing
+ * a sentinel, because an unset property is absent from the overdue count while
+ * a sentinel would put every job of that type permanently past due.
+ */
+import type { Session } from "neo4j-driver";
+import type { DispatchConfig, WriteFn } from "../lib/types.js";
+import { type ToolResult } from "./result.js";
+export interface JobCreateParams {
+    session: Session;
+    write: WriteFn;
+    accountId: string;
+    createdBy: Record<string, string | undefined>;
+    cfg: DispatchConfig;
+    emit: (line: string) => void;
+    now: () => number;
+    type: string;
+    siteId: string;
+    customerId: string;
+    description?: string;
+    jobId?: string;
+}
+export declare function jobCreate(p: JobCreateParams): Promise<ToolResult>;
+//# sourceMappingURL=job-create.d.ts.map

package/payload/platform/plugins/dispatch/mcp/dist/tools/job-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-create.d.ts","sourceRoot":"","sources":["../../src/tools/job-create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI/D,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,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,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAyEvE"}

package/payload/platform/plugins/dispatch/mcp/dist/tools/job-create.js

@@ -0,0 +1,53 @@
+import { initialStatus } from "../lib/lifecycle.js";
+import { newJobId, newReqId } from "../lib/ids.js";
+import { readNodeId } from "../lib/read.js";
+import { toolText, toolError } from "./result.js";
+export async function jobCreate(p) {
+    const reqId = newReqId();
+    const jobType = p.cfg.jobTypes.find((t) => t.name === p.type);
+    if (!jobType) {
+        return toolError(`Unknown job type "${p.type}". This account declares: ${p.cfg.jobTypes.map((t) => t.name).join(", ")}.`);
+    }
+    const siteNodeId = await readNodeId(p.session, p.accountId, "Site", "siteId", p.siteId);
+    if (!siteNodeId) {
+        return toolError(`No ${p.cfg.vocabulary.job} can be raised: site "${p.siteId}" does not exist on this account. Create the site first.`);
+    }
+    const customerNodeId = await readNodeId(p.session, p.accountId, "Customer", "customerId", p.customerId);
+    if (!customerNodeId) {
+        return toolError(`No ${p.cfg.vocabulary.job} can be raised: customer "${p.customerId}" does not exist on this account. Create the customer first.`);
+    }
+    const jobId = p.jobId ?? newJobId();
+    const createdAt = new Date(p.now()).toISOString();
+    const slaTargetAt = jobType.slaTargetHours === undefined
+        ? null
+        : new Date(p.now() + jobType.slaTargetHours * 3_600_000).toISOString();
+    await p.write({
+        session: p.session,
+        labels: ["Job"],
+        props: {
+            accountId: p.accountId,
+            jobId,
+            status: initialStatus("job", p.cfg),
+            jobType: jobType.name,
+            createdAt,
+            ...(slaTargetAt === null ? {} : { slaTargetAt }),
+            ...(p.description === undefined ? {} : { description: p.description }),
+        },
+        relationships: [
+            { type: "AT_SITE", direction: "outgoing", targetNodeId: siteNodeId },
+            { type: "FOR_CUSTOMER", direction: "outgoing", targetNodeId: customerNodeId },
+        ],
+        createdBy: p.createdBy,
+        mergeOn: ["jobId"],
+    });
+    p.emit(`[dispatch] op=job-create reqId=${reqId} jobId=${jobId} type=${jobType.name} ` +
+        `siteId=${p.siteId} customerId=${p.customerId} slaTargetAt=${slaTargetAt ?? "none"}`);
+    return toolText(JSON.stringify({
+        jobId,
+        status: initialStatus("job", p.cfg),
+        type: jobType.name,
+        slaTargetAt,
+        vocabulary: p.cfg.vocabulary,
+    }, null, 2));
+}
+//# sourceMappingURL=job-create.js.map

package/payload/platform/plugins/dispatch/mcp/dist/tools/job-create.js.map

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

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

@@ -0,0 +1,38 @@
+/**
+ * The four read tools: one job, many jobs, one site's history, one day.
+ *
+ * Every one of them returns the account's own `vocabulary` alongside the rows,
+ * so a surface rendering them never has to guess whether to write "engineer" or
+ * "driver", and never has to re-read config.json to find out.
+ */
+import type { Session } from "neo4j-driver";
+import type { DispatchConfig } from "../lib/types.js";
+import { type JobListFilter } from "../lib/read.js";
+import { type ToolResult } from "./result.js";
+export declare function jobGet(p: {
+    session: Session;
+    accountId: string;
+    cfg: DispatchConfig;
+    jobId: string;
+}): Promise<ToolResult>;
+export declare function jobList(p: {
+    session: Session;
+    accountId: string;
+    cfg: DispatchConfig;
+    filter: JobListFilter;
+    now: () => number;
+}): Promise<ToolResult>;
+export declare function siteHistory(p: {
+    session: Session;
+    accountId: string;
+    cfg: DispatchConfig;
+    siteId: string;
+    limit?: number;
+}): Promise<ToolResult>;
+export declare function day(p: {
+    session: Session;
+    accountId: string;
+    cfg: DispatchConfig;
+    date: string;
+}): Promise<ToolResult>;
+//# sourceMappingURL=reads.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../../src/tools/reads.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnE,wBAAsB,MAAM,CAAC,CAAC,EAAE;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,UAAU,CAAC,CAWtB;AAED,wBAAsB,OAAO,CAAC,CAAC,EAAE;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2BtB;AAED,wBAAsB,WAAW,CAAC,CAAC,EAAE;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,UAAU,CAAC,CAStB;AAED,wBAAsB,GAAG,CAAC,CAAC,EAAE;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,UAAU,CAAC,CAoCtB"}

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

@@ -0,0 +1,63 @@
+import { isTerminal } from "../lib/lifecycle.js";
+import { readJob, readJobs, readSiteHistory, readVisitsForJob, readVisitsInWindow, } from "../lib/read.js";
+import { toolError, toolText } from "./result.js";
+export async function jobGet(p) {
+    const job = await readJob(p.session, p.accountId, p.jobId);
+    if (!job)
+        return toolError(`No ${p.cfg.vocabulary.job} "${p.jobId}" on this account.`);
+    const visits = await readVisitsForJob(p.session, p.accountId, p.jobId);
+    return toolText(JSON.stringify({ vocabulary: p.cfg.vocabulary, job, visits, visitCount: visits.length }, null, 2));
+}
+export async function jobList(p) {
+    if (p.filter.status && !p.cfg.statuses.job.some((s) => s.name === p.filter.status)) {
+        return toolError(`"${p.filter.status}" is not a ${p.cfg.vocabulary.job} status on this account. Declared: ${p.cfg.statuses.job.map((s) => s.name).join(", ")}.`);
+    }
+    const rows = await readJobs(p.session, p.accountId, p.filter);
+    const nowIso = new Date(p.now()).toISOString();
+    return toolText(JSON.stringify({
+        vocabulary: p.cfg.vocabulary,
+        count: rows.length,
+        jobs: rows.map((j) => ({
+            ...j,
+            // Computed, never stored: a stored overdue flag goes stale the moment
+            // the clock passes the target with nothing writing to the row.
+            overdue: j.slaTargetAt !== null &&
+                j.slaTargetAt < nowIso &&
+                !isTerminal("job", j.status, p.cfg),
+        })),
+    }, null, 2));
+}
+export async function siteHistory(p) {
+    const rows = await readSiteHistory(p.session, p.accountId, p.siteId, p.limit ?? 50);
+    return toolText(JSON.stringify({ vocabulary: p.cfg.vocabulary, siteId: p.siteId, count: rows.length, visits: rows }, null, 2));
+}
+export async function day(p) {
+    const from = `${p.date}T00:00:00.000Z`;
+    const to = `${p.date}T23:59:59.999Z`;
+    const visits = await readVisitsInWindow(p.session, p.accountId, from, to);
+    const unallocated = await readJobs(p.session, p.accountId, {
+        unallocatedOnly: true,
+        limit: 200,
+    });
+    // Every declared worker gets a row, including one with nothing on. An omitted
+    // row reads as a worker who does not exist, and a planner drawing rows from
+    // this would silently lose them for the day.
+    const workers = p.cfg.workers.map((w) => ({
+        workerId: w.workerId,
+        name: w.name,
+        workingHours: w.workingHours,
+        visits: visits.filter((v) => v.workerId === w.workerId),
+    }));
+    return toolText(JSON.stringify({
+        date: p.date,
+        vocabulary: p.cfg.vocabulary,
+        workers,
+        unallocated: unallocated.map((j) => ({
+            jobId: j.jobId,
+            type: j.jobType,
+            slaTargetAt: j.slaTargetAt,
+        })),
+        unassignedVisits: visits.filter((v) => v.workerId === null),
+    }, null, 2));
+}
+//# sourceMappingURL=reads.js.map