@codesys/mcp-toolkit 2.1.2 → 2.3.0

package/dist/codesys/simtest.js

@@ -0,0 +1,103 @@
+/**
+ * Unit tests in CODESYS's simulation: test cases of steps (write or force
+ * inputs, run cycles or wait, check values), run in order, reported as a table.
+ */
+import * as z from "zod/v4";
+import { plcValue } from "../hmi/value.js";
+import { currentCodesysSim } from "./simulation.js";
+const expectation = z.union([
+    z.string().describe("Exact value: 'TRUE', '42', 'T#2S'"),
+    z.object({ op: z.enum(["=", "<>", "<", "<=", ">", ">="]), value: z.number(), tolerance: z.number().optional() }),
+]);
+export const testSchema = z.object({
+    cases: z
+        .array(z.object({
+        name: z.string(),
+        steps: z
+            .array(z.object({
+            write: z.record(z.string(), z.string()).optional().describe("Write values once"),
+            force: z.record(z.string(), z.string()).optional().describe("Force values (held until unforced)"),
+            unforce: z.array(z.string()).optional(),
+            cycles: z.number().int().min(1).max(10_000).optional().describe("Run exactly n cycles (the simulation is stopped between steps)"),
+            waitMs: z.number().int().min(1).max(60_000).optional().describe("Let it run for this long"),
+            expect: z.record(z.string(), expectation).optional().describe("Values to check after the step"),
+        }))
+            .min(1),
+    }))
+        .min(1),
+});
+/** Whether a read value meets an expectation; booleans and numbers compare by value. */
+export function check(raw, exp) {
+    const got = plcValue(raw);
+    if (typeof exp === "string") {
+        const want = plcValue(exp);
+        if (typeof got === "number" && typeof want === "number")
+            return Math.abs(got - want) < 1e-9;
+        return String(got).toLowerCase() === String(want).toLowerCase();
+    }
+    const n = typeof got === "boolean" ? (got ? 1 : 0) : typeof got === "number" ? got : NaN;
+    if (Number.isNaN(n))
+        return false;
+    const t = exp.tolerance ?? 0;
+    switch (exp.op) {
+        case "=":
+            return Math.abs(n - exp.value) <= t;
+        case "<>":
+            return Math.abs(n - exp.value) > t;
+        case "<":
+            return n < exp.value;
+        case "<=":
+            return n <= exp.value + t;
+        case ">":
+            return n > exp.value;
+        case ">=":
+            return n >= exp.value - t;
+    }
+}
+const show = (e) => (typeof e === "string" ? e : `${e.op} ${e.value}${e.tolerance ? ` ±${e.tolerance}` : ""}`);
+export function registerSimTestAction(reg, ctx, run) {
+    const b = ctx.bridge;
+    reg("codesys_sim_test", {
+        description: "Run test cases in CODESYS's simulation and get a pass/fail report. Each case is a list of steps: write or force inputs, run exact cycles or wait (real time), then expect values ('TRUE', '42', or {op: '>=', value: 10, tolerance?}). Cases run in order on the same running application, so reset what a case changes. Start the simulation first (codesys_sim_start). Use it to prove logic (latches, interlocks, timers, sequences) before building an HMI.",
+        inputSchema: testSchema,
+    }, async ({ cases }) => run(async () => {
+        if (!currentCodesysSim(ctx))
+            throw new Error("The simulation isn't running: call codesys_sim_start first.");
+        const rows = [];
+        let passed = 0, failed = 0;
+        for (const tc of cases) {
+            let ok = true;
+            const notes = [];
+            for (const [k, st] of tc.steps.entries()) {
+                if (st.unforce?.length)
+                    await b.call("sim.unforce", { names: st.unforce });
+                if (st.force)
+                    await b.call("sim.force", { values: st.force });
+                if (st.write)
+                    await b.call("sim.write", { values: st.write });
+                if (st.cycles)
+                    await b.call("sim.cycle", { count: st.cycles }, { timeoutMs: Math.max(60_000, st.cycles * 1_000) });
+                if (st.waitMs) {
+                    await b.call("sim.control", { action: "run" });
+                    await new Promise((r) => setTimeout(r, st.waitMs));
+                }
+                if (st.expect) {
+                    const names = Object.keys(st.expect);
+                    const r = await b.call("sim.read", { names });
+                    for (const n of names) {
+                        const exp = st.expect[n];
+                        const got = r.values[n] ?? (r.errors[n] ? `error: ${r.errors[n]}` : undefined);
+                        if (!check(r.values[n], exp)) {
+                            ok = false;
+                            notes.push(`step ${k + 1}: ${n} = ${got ?? "?"}, expected ${show(exp)}`);
+                        }
+                    }
+                }
+            }
+            ok ? passed++ : failed++;
+            rows.push(`| ${tc.name} | ${ok ? "PASS" : "FAIL"} | ${notes.join("; ") || "all expectations met"} |`);
+        }
+        return [`${passed} passed, ${failed} failed.`, "", "| Test | Result | Details |", "| --- | --- | --- |", ...rows].join("\n");
+    }));
+}
+//# sourceMappingURL=simtest.js.map

package/dist/codesys/simtest.js.map

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

package/dist/codesys/st.d.ts

@@ -1,6 +1,6 @@
 /** Structured Text helpers: object kinds and declaration-header checks. */
 export type ObjectKind = "pou" | "method" | "property" | "accessor" | "action" | "dut" | "gvl" | "interface" | "interface_method" | "task_config" | "task" | "task_call" | "library_manager" | "application" | "folder" | "device" | "other";
-export type CreateKind = "program" | "function_block" | "function" | "method" | "property" | "action" | "interface" | "dut" | "gvl" | "folder";
+export type CreateKind = "program" | "function_block" | "function" | "method" | "property" | "action" | "interface" | "dut" | "gvl" | "persistent_vars" | "folder";
 export interface TreeNode {
     path: string;
     name: string;

package/dist/codesys/st.js.map

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

package/dist/codesys/trace.d.ts

@@ -0,0 +1,19 @@
+import type { ActionResult, RegisterAction } from "../actions.js";
+import type { AppContext } from "../tools.js";
+export interface TraceData {
+    vars: string[];
+    t: number[];
+    cols: number[][];
+}
+/** CODESYS's saved trace: a title, the project, a header 'Timestamp(ms) a b', then rows. */
+export declare function parseTrace(text: string): TraceData;
+export declare function summarize(d: TraceData): string;
+/** At most n rows, evenly spread, as a table. */
+export declare function table(d: TraceData, n?: number): string;
+/** A chart page: one lane per variable (booleans as steps), shared time axis. */
+export declare function chartPage(d: TraceData, title: string): {
+    html: string;
+    w: number;
+    h: number;
+};
+export declare function registerTraceActions(reg: RegisterAction, ctx: AppContext, run: (fn: () => Promise<string>) => Promise<ActionResult>): void;

package/dist/codesys/trace.js

@@ -0,0 +1,139 @@
+/**
+ * CODESYS Trace in the simulation: record variables every task cycle and get
+ * the data back as a summary, a table and a chart (watcher/mcp_trace.py).
+ */
+import { mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import * as z from "zod/v4";
+import { findBrowser, screenshot } from "../hmi/service.js";
+import { currentCodesysSim } from "./simulation.js";
+/** CODESYS's saved trace: a title, the project, a header 'Timestamp(ms) a b', then rows. */
+export function parseTrace(text) {
+    const lines = text.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+    const h = lines.findIndex((l) => /^Timestamp/i.test(l));
+    if (h < 0)
+        throw new Error("not a CODESYS trace file");
+    const vars = lines[h].split(/\s+/).slice(1);
+    const t = [];
+    const cols = vars.map(() => []);
+    for (const l of lines.slice(h + 1)) {
+        const p = l.split(/\s+/).map(Number);
+        if (p.length < vars.length + 1 || p.some((x) => Number.isNaN(x)))
+            continue;
+        t.push(p[0]);
+        vars.forEach((_, i) => cols[i].push(p[i + 1]));
+    }
+    return { vars, t, cols };
+}
+const fmt = (x) => (Number.isInteger(x) ? String(x) : x.toFixed(Math.abs(x) >= 100 ? 1 : 3).replace(/0+$/, "").replace(/\.$/, ""));
+export function summarize(d) {
+    if (!d.t.length)
+        return "The trace recorded no samples (is the task running?).";
+    const span = d.t[d.t.length - 1] - d.t[0];
+    const dt = d.t.length > 1 ? span / (d.t.length - 1) : 0;
+    const lines = [`${d.t.length} samples over ${(span / 1000).toFixed(2)} s (about every ${Math.round(dt)} ms).`];
+    d.vars.forEach((v, i) => {
+        const c = d.cols[i];
+        const bool = c.every((x) => x === 0 || x === 1);
+        if (bool) {
+            const edges = [];
+            for (let k = 1; k < c.length; k++)
+                if (c[k] !== c[k - 1])
+                    edges.push(`${c[k] ? "TRUE" : "FALSE"} at ${d.t[k]} ms`);
+            lines.push(`${v} (BOOL): starts ${c[0] ? "TRUE" : "FALSE"}, ${edges.length ? `then ${edges.slice(0, 12).join(", ")}${edges.length > 12 ? ` (+${edges.length - 12} more)` : ""}` : "never changes"}.`);
+        }
+        else {
+            const min = Math.min(...c), max = Math.max(...c);
+            lines.push(`${v}: first ${fmt(c[0])}, last ${fmt(c[c.length - 1])}, min ${fmt(min)} at ${d.t[c.indexOf(min)]} ms, max ${fmt(max)} at ${d.t[c.indexOf(max)]} ms.`);
+        }
+    });
+    return lines.join("\n");
+}
+/** At most n rows, evenly spread, as a table. */
+export function table(d, n = 40) {
+    const step = Math.max(1, Math.ceil(d.t.length / n));
+    const rows = [["t (ms)", ...d.vars].join("\t")];
+    for (let k = 0; k < d.t.length; k += step)
+        rows.push([d.t[k], ...d.cols.map((c) => fmt(c[k]))].join("\t"));
+    return rows.join("\n");
+}
+const COLORS = ["#38bdf8", "#a78bfa", "#fbbf24", "#34d399", "#f472b6", "#60a5fa"];
+/** A chart page: one lane per variable (booleans as steps), shared time axis. */
+export function chartPage(d, title) {
+    const W = 1000, lane = 110, top = 62, left = 70, right = 20;
+    const H = top + d.vars.length * (lane + 34) + 14;
+    const t0 = d.t[0] ?? 0, t1 = d.t[d.t.length - 1] ?? 1;
+    const X = (t) => left + ((t - t0) / (t1 - t0 || 1)) * (W - left - right);
+    const lanes = d.vars.map((v, i) => {
+        const c = d.cols[i];
+        const y0 = top + i * (lane + 34);
+        const bool = c.every((x) => x === 0 || x === 1);
+        const min = Math.min(...c), max = Math.max(...c);
+        const lo = bool ? 0 : min === max ? min - 1 : min, hi = bool ? 1 : min === max ? max + 1 : max;
+        const Y = (x) => y0 + lane - (bool ? 0.1 + 0.8 * x : (x - lo) / (hi - lo)) * lane;
+        let path = "";
+        c.forEach((x, k) => {
+            const px = X(d.t[k]).toFixed(1), py = Y(x).toFixed(1);
+            if (!k)
+                path = `M${px} ${py}`;
+            else
+                path += bool ? ` H${px} V${py}` : ` L${px} ${py}`;
+        });
+        const col = COLORS[i % COLORS.length];
+        return `<text x="${left}" y="${y0 - 8}" class="n">${v.replace(/[<&]/g, "")}</text><text x="${left - 6}" y="${y0 + 12}" class="a">${bool ? "TRUE" : fmt(hi)}</text><text x="${left - 6}" y="${y0 + lane}" class="a">${bool ? "FALSE" : fmt(lo)}</text>
+<line x1="${left}" x2="${W - right}" y1="${y0 + lane}" y2="${y0 + lane}" class="g"/><line x1="${left}" x2="${W - right}" y1="${y0}" y2="${y0}" class="g"/>
+<path d="${path}" fill="none" stroke="${col}" stroke-width="2"/>`;
+    });
+    const html = `<!doctype html><html><head><meta charset="utf-8"><style>body{margin:0;background:#0b1220;font-family:"Segoe UI",system-ui,sans-serif}
+text{fill:#8193ad;font-size:12px}.n{fill:#e6edf7;font-size:13px;font-weight:600}.a{text-anchor:end;font-size:11px}.g{stroke:#24324a}.t{fill:#e6edf7;font-size:16px;font-weight:650}</style></head>
+<body><svg width="${W}" height="${H}" viewBox="0 0 ${W} ${H}"><text x="8" y="26" class="t">${title.replace(/[<&]/g, "")}</text>
+${lanes.join("\n")}<text x="${left}" y="${H - 8}">${t0} ms</text><text x="${W - right}" y="${H - 8}" class="a">${t1} ms</text></svg></body></html>`;
+    return { html, w: W, h: H };
+}
+export function registerTraceActions(reg, ctx, run) {
+    const b = ctx.bridge;
+    reg("trace_setup", {
+        description: "Set up a CODESYS trace (before codesys_sim_start: it is part of the project): the variables to record every cycle of a task. Then start the simulation and call trace_record. Replaces a trace of the same name.",
+        inputSchema: z.object({
+            variables: z.array(z.string()).min(1).max(20).describe("e.g. ['PLC_PRG.rLevel', 'PLC_PRG.fbPump.xRunning']"),
+            name: z.string().default("Trace_MCP"),
+            task: z.string().optional().describe("Task to sample in (default: the first task)"),
+            everyNCycles: z.number().int().min(1).max(1000).optional().describe("Record every n-th cycle"),
+        }),
+    }, async ({ variables, name, task, everyNCycles }) => run(async () => {
+        const r = await b.call("trace.setup", { variables, name, task, every_n_cycles: everyNCycles, save: ctx.autosave }, { timeoutMs: 120_000 });
+        return `Trace ${r.name} records ${variables.length} variable(s) in task ${r.task}. Start the simulation (codesys_sim_start, codesys_sim_control run), drive the inputs, then call trace_record.`;
+    }));
+    reg("trace_record", {
+        description: "Record a trace in the running simulation for some seconds, then return what happened: a summary per variable (BOOL edges with times, min/max with times), a table and a chart image. Set the trace up first with trace_setup. Write or force inputs before or between recordings to test timing (e.g. a 500 ms blink, a start delay).",
+        inputSchema: z.object({ name: z.string().default("Trace_MCP"), seconds: z.number().min(0.5).max(60).default(5) }),
+    }, async ({ name, seconds }) => {
+        if (!currentCodesysSim(ctx))
+            return { content: [{ type: "text", text: "The simulation isn't running: call codesys_sim_start (and codesys_sim_control run) first." }], isError: true };
+        const dir = mkdtempSync(join(tmpdir(), "cmcp-trace-"));
+        try {
+            const path = join(dir, "trace.txt");
+            let d;
+            const r = await run(async () => {
+                await b.call("trace.record", { name, ms: Math.round(seconds * 1000), path }, { timeoutMs: seconds * 1000 + 120_000 });
+                d = parseTrace(readFileSync(path, "utf8"));
+                return `${summarize(d)}\n\n${table(d)}`;
+            });
+            if (r.isError || !d || !findBrowser())
+                return r;
+            try {
+                const c = chartPage(d, name);
+                const png = await screenshot(c.html, undefined, { w: c.w, h: c.h });
+                return { content: [{ type: "image", data: png.toString("base64"), mimeType: "image/png" }, ...r.content] };
+            }
+            catch (e) {
+                return { content: [...r.content, { type: "text", text: `(No chart: ${e.message})` }] };
+            }
+        }
+        finally {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    });
+}
+//# sourceMappingURL=trace.js.map

package/dist/codesys/trace.js.map

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

package/dist/hmi/native.d.ts

@@ -0,0 +1,89 @@
+import type { Screen, Tone } from "./spec.js";
+type Argb = number;
+export interface NativeElement {
+    kind: "rect" | "round" | "circle" | "switcher" | "image";
+    name?: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    text?: string;
+    font?: [string, number] | [string, number, "bold"];
+    color?: Argb;
+    align?: "LEFT" | "HCENTER" | "RIGHT";
+    fill?: Argb | null;
+    frame?: Argb | null;
+    lineWidth?: number;
+    gradient?: [Argb, Argb, number];
+    radius?: number;
+    invisible?: string;
+    props?: Record<string, string | number | boolean | {
+        argb: Argb;
+    }>;
+    click?: string;
+    /** Switch the client to another visualization on click. */
+    goto?: string;
+    /** Open a dialog visualization on click. */
+    dialog?: {
+        name: string;
+        x?: number;
+        y?: number;
+    };
+    /** Close this dialog on click. */
+    close_dialog?: string;
+    /** Open CODESYS's login dialog on click (visualization user management). */
+    login?: boolean;
+}
+export interface NativeDialog {
+    name: string;
+    size: [number, number];
+    background: Argb;
+    elements: NativeElement[];
+}
+export interface NativePlan {
+    /** Canvas size of the page. */
+    size: [number, number];
+    /** Faceplate dialogs opened from symbols. */
+    dialogs: NativeDialog[];
+    visu: string;
+    imagePool: string;
+    background: Argb;
+    elements: NativeElement[];
+    images: {
+        id: string;
+        svg: string;
+    }[];
+    helper: {
+        name: string;
+        declaration: string;
+        implementation: string;
+    };
+}
+interface Palette {
+    bg: Argb;
+    header: [Argb, Argb];
+    headerText: Argb;
+    tile: Argb;
+    tile2: Argb;
+    border: Argb;
+    text: Argb;
+    muted: Argb;
+    track: Argb;
+    pipe: Argb;
+    shell: Argb;
+    liquid: [Argb, Argb];
+    tones: Record<Tone, Argb>;
+    soft: Record<Tone, Argb>;
+}
+/** Pictures per turn of a running pump or fan. */
+export declare const FRAMES = 8;
+/** SVG symbols for the image pool (100x100). */
+export declare function symbols(p: Palette): {
+    id: string;
+    svg: string;
+}[];
+export declare function nativePlan(screen: Screen, pages?: {
+    name: string;
+    title: string;
+}[]): NativePlan;
+export {};