@codesys/mcp-toolkit 1.5.8 → 2.0.0

package/dist/codesys/install.js

@@ -0,0 +1,144 @@
+/** Find CODESYS installations, their profiles and project templates. */
+import { existsSync, mkdirSync, readdirSync, statSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+const isCodesysExe = (exe) => basename(exe).toLowerCase() === "codesys.exe";
+/**
+ * The folder holding an install's Profiles and Templates. CODESYS keeps them
+ * two levels above the program (`<root>\CODESYS\Common\CODESYS.exe`). Products
+ * built on CODESYS can lay this out differently, so look a few levels up.
+ */
+function installBase(exe) {
+    let dir = dirname(exe);
+    for (let level = 0; level < 3; level++) {
+        for (const base of [dir, join(dir, "CODESYS")])
+            if (existsSync(join(base, "Profiles")))
+                return base;
+        dir = dirname(dir);
+    }
+    return dirname(dirname(exe));
+}
+/** The workspace folder: created when missing, with a clear error when it can't be used. */
+export function ensureWorkspace(dir, log) {
+    try {
+        if (existsSync(dir)) {
+            if (!statSync(dir).isDirectory())
+                throw new Error("it is a file, not a folder");
+            return dir;
+        }
+        mkdirSync(dir, { recursive: true });
+        log(`created the workspace folder ${dir}`);
+        return dir;
+    }
+    catch (e) {
+        throw new Error(`Can't use the workspace ${dir}: ${e.message}`);
+    }
+}
+/**
+ * The add-on folder CODESYS's own shortcuts start this install with
+ * (`--additionalfolder`). SP22 installs add-ons such as Scripting there:
+ * `<CODESYS>\AdditionalFolders\Default`, or the only folder in AdditionalFolders.
+ */
+export function findAdditionalFolder(base) {
+    const root = join(base, "AdditionalFolders");
+    if (!existsSync(root))
+        return undefined;
+    const dirs = readdirSync(root, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
+    const pick = dirs.find((d) => d.toLowerCase() === "default") ?? (dirs.length === 1 ? dirs[0] : undefined);
+    return pick ? join(root, pick) : undefined;
+}
+function profilesIn(dir) {
+    const profilesDir = join(dir, "Profiles");
+    if (!existsSync(profilesDir))
+        return [];
+    return readdirSync(profilesDir)
+        .filter((f) => f.toLowerCase().endsWith(".profile.xml"))
+        .map((f) => f.slice(0, -".profile.xml".length));
+}
+export function describeInstall(exe, additionalFolder) {
+    const base = installBase(exe);
+    const extra = additionalFolder ?? findAdditionalFolder(base);
+    const profiles = [...new Set([...profilesIn(base), ...(extra ? profilesIn(extra) : [])])].sort(compareProfiles);
+    const templatesDir = join(base, "Templates");
+    return {
+        exe,
+        profiles,
+        templatesDir: existsSync(templatesDir) ? templatesDir : undefined,
+        label: isCodesysExe(exe) ? (dirname(base).split(/[\\/]/).pop() ?? base) : dirname(exe).split(/[\\/]/).slice(-2).join(" "),
+        ...(extra ? { additionalFolder: extra } : {}),
+    };
+}
+/** Scan Program Files for CODESYS installs (Windows only). */
+export function findInstalls() {
+    const roots = [process.env["ProgramFiles"], process.env["ProgramFiles(x86)"], process.env["ProgramW6432"]]
+        .filter((r) => !!r)
+        .filter((r, i, a) => a.indexOf(r) === i);
+    const found = [];
+    for (const root of roots) {
+        if (!existsSync(root))
+            continue;
+        for (const dir of readdirSync(root)) {
+            if (!/^codesys/i.test(dir))
+                continue;
+            const exe = join(root, dir, "CODESYS", "Common", "CODESYS.exe");
+            if (existsSync(exe))
+                found.push(describeInstall(exe));
+        }
+    }
+    // Newest version first ("CODESYS 3.5.21.0" > "CODESYS 3.5.19.50").
+    return found.sort((a, b) => versionKey(b.label).localeCompare(versionKey(a.label)));
+}
+/** "CODESYS V3.5 SP22 Patch 1" -> a key that sorts numerically (SP9 < SP21 < SP22 < SP22 Patch 1). */
+export function profileKey(name) {
+    const m = /V(\d+)\.(\d+)(?:\.(\d+))?(?:\s*SP\s*(\d+))?(?:\s*Patch\s*(\d+))?/i.exec(name);
+    if (!m)
+        return "";
+    return [m[1], m[2], m[3], m[4], m[5]].map((n) => (n ?? "0").padStart(4, "0")).join(".");
+}
+/** Newest profile first; names without a version last, alphabetically. */
+export function compareProfiles(a, b) {
+    return profileKey(b).localeCompare(profileKey(a)) || a.localeCompare(b);
+}
+function versionKey(label) {
+    const m = label.match(/(\d+)\.(\d+)\.(\d+)\.(\d+)/);
+    return m ? m.slice(1).map((n) => n.padStart(4, "0")).join(".") : label;
+}
+/** Pick the CODESYS exe + profile from options, falling back to the newest install. */
+export function resolveCodesys(exe, profile, additionalFolder) {
+    if (additionalFolder && !existsSync(additionalFolder))
+        throw new Error(`CODESYS additional folder not found: ${additionalFolder}`);
+    let install;
+    let reason;
+    if (exe) {
+        if (!existsSync(exe))
+            throw new Error(`CODESYS executable not found: ${exe}`);
+        install = describeInstall(exe, additionalFolder);
+        reason = "set with --codesys-path";
+    }
+    else {
+        const all = findInstalls();
+        const withProfile = profile ? all.find((i) => i.profiles.includes(profile)) : undefined;
+        install = withProfile ?? all[0];
+        if (!install)
+            throw new Error("No CODESYS installation found. Pass --codesys-path <...\\CODESYS\\Common\\CODESYS.exe>.");
+        reason = withProfile ? `it has profile "${profile}"` : pickedNewest(all.map((i) => i.label));
+        if (additionalFolder)
+            install = { ...install, additionalFolder };
+    }
+    const prof = profile ?? install.profiles[0];
+    if (!prof)
+        throw new Error(`No CODESYS profile found next to ${install.exe}. Pass --codesys-profile "<name>".`);
+    let warning;
+    if (profile && !install.profiles.some((p) => p.toLowerCase() === profile.toLowerCase())) {
+        const known = install.profiles.join(", ");
+        // Only CODESYS.exe is known to name its profiles after these files; other products get the benefit of the doubt.
+        if (known && isCodesysExe(install.exe))
+            throw new Error(`Profile "${profile}" isn't installed next to ${install.exe}. Installed profiles: ${known}.`);
+        warning = known ? `profile "${profile}" isn't among those found next to ${install.exe} (${known}); trying it anyway` : `no Profiles folder found near ${install.exe}, so profile "${profile}" can't be checked`;
+    }
+    return { exe: install.exe, profile: prof, install, reason, ...(warning ? { warning } : {}) };
+}
+/** "newest of 2 installs found (CODESYS 3.5.22.40, CODESYS 3.5.21.0); --codesys-path picks another" */
+export function pickedNewest(labels) {
+    return labels.length === 1 ? "the only install found" : `newest of ${labels.length} installs found (${labels.join(", ")}); --codesys-path picks another`;
+}
+//# sourceMappingURL=install.js.map

package/dist/codesys/install.js.map

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

package/dist/codesys/library-browse.d.ts

@@ -0,0 +1,19 @@
+export interface BrowseEntry {
+    name: string;
+    comment?: string;
+}
+export interface InstalledLibrary {
+    title: string;
+    version: string;
+    company: string;
+}
+export declare function parseBrowseCache(xml: string): BrowseEntry[];
+/** The newest of several installed versions, compared as numbers (3.5.22 is newer than 3.5.9). */
+export declare function newestLibrary<T extends {
+    version: string;
+}>(libs: T[]): T | undefined;
+/** The library's browse cache in one of the repositories CODESYS reports. */
+export declare function browseCacheFile(repositories: string[], lib: InstalledLibrary): string | undefined;
+export declare function readBrowseCache(file: string): BrowseEntry[];
+/** A library's objects as text; `symbol` narrows it to names or descriptions containing that text. */
+export declare function describeBrowse(head: string, entries: BrowseEntry[], symbol?: string, maxLines?: number): string;

package/dist/codesys/library-browse.js

@@ -0,0 +1,57 @@
+/**
+ * What CODESYS's own library browser knows about an installed library. Each
+ * library in a repository has a `browsercache` XML file listing its objects
+ * and their descriptions. Scripting can't read a compiled library's contents,
+ * and this works for libraries the project doesn't reference yet.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const decode = (s) => s
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, '"')
+    .replace(/&apos;/g, "'")
+    .replace(/&#x([0-9a-fA-F]+);/g, (_, h) => String.fromCodePoint(parseInt(h, 16)))
+    .replace(/&#(\d+);/g, (_, d) => String.fromCodePoint(parseInt(d, 10)))
+    .replace(/&amp;/g, "&");
+export function parseBrowseCache(xml) {
+    const out = [];
+    for (const node of xml.matchAll(/<Node\s+([^>]*?)\/?>/g)) {
+        const attrs = new Map([...node[1].matchAll(/(\w+)="([^"]*)"/g)].map((a) => [a[1], decode(a[2])]));
+        const name = attrs.get("Name");
+        if (!name)
+            continue;
+        const comment = attrs.get("Comment")?.trim().replace(/\s+/g, " ");
+        out.push({ name, ...(comment ? { comment } : {}) });
+    }
+    return out;
+}
+const versionParts = (v) => v.split(".").map((n) => Number.parseInt(n, 10) || 0);
+/** The newest of several installed versions, compared as numbers (3.5.22 is newer than 3.5.9). */
+export function newestLibrary(libs) {
+    return [...libs].sort((a, b) => {
+        const [x, y] = [versionParts(a.version), versionParts(b.version)];
+        for (let i = 0; i < Math.max(x.length, y.length); i++)
+            if ((x[i] ?? 0) !== (y[i] ?? 0))
+                return (y[i] ?? 0) - (x[i] ?? 0);
+        return 0;
+    })[0];
+}
+/** The library's browse cache in one of the repositories CODESYS reports. */
+export function browseCacheFile(repositories, lib) {
+    return repositories.map((root) => join(root, lib.company, lib.title, lib.version, "browsercache")).find((f) => existsSync(f));
+}
+export function readBrowseCache(file) {
+    return parseBrowseCache(readFileSync(file, "utf8"));
+}
+/** A library's objects as text; `symbol` narrows it to names or descriptions containing that text. */
+export function describeBrowse(head, entries, symbol, maxLines = 300) {
+    const want = symbol?.toLowerCase();
+    const shown = want ? entries.filter((e) => e.name.toLowerCase().includes(want) || e.comment?.toLowerCase().includes(want)) : entries;
+    if (want && !shown.length)
+        return `${head} has nothing matching '${symbol}'.`;
+    const lines = shown.slice(0, maxLines).map((e) => `- ${e.name}${e.comment ? ` :: ${e.comment}` : ""}`);
+    const more = shown.length > maxLines ? [`... ${shown.length - maxLines} more. Pass symbol to narrow it.`] : [];
+    return [`${head}: ${want ? `${shown.length} of ` : ""}${entries.length} objects, from CODESYS's library browser. Parameters aren't listed here; test a call with compile.`, ...lines, ...more].join("\n");
+}
+//# sourceMappingURL=library-browse.js.map

package/dist/codesys/library-browse.js.map

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

package/dist/codesys/outline.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Project outline for the model: what exists, how to call it, and what runs
+ * it, without reading every object. Built from the CODESYS export (all ST
+ * text in one call) and the task list.
+ */
+import type { TreeNode } from "./st.js";
+export interface OutlineTask {
+    name: string;
+    interval?: string | null;
+    interval_unit?: string | null;
+    priority?: string | null;
+    kind?: string | null;
+    pous: string[];
+}
+export interface OutlineOptions {
+    /** An object or folder path: details for an object, an overview of a folder. */
+    path?: string;
+    /** Max lines of output (default 400). */
+    maxLines?: number;
+}
+export declare function buildOutline(nodes: TreeNode[], tasks: OutlineTask[], o?: OutlineOptions): string;
+export interface IoEntry {
+    owner: string;
+    name: string;
+    at: string;
+    type: string;
+    direction: "input" | "output" | "memory";
+    comment?: string;
+    placeholder: boolean;
+}
+/** Variables with AT addresses (including the %I* and %Q* placeholders), from GVLs and POUs. */
+export declare function ioList(nodes: TreeNode[]): IoEntry[];

package/dist/codesys/outline.js

@@ -0,0 +1,219 @@
+import { parseDeclaration, signature } from "./decl.js";
+const TOP_KINDS = new Set(["pou", "dut", "gvl", "interface"]);
+const SECTION_LABEL = {
+    VAR_INPUT: "in",
+    VAR_OUTPUT: "out",
+    VAR_IN_OUT: "in_out",
+    VAR: "var",
+    VAR_TEMP: "temp",
+    VAR_STAT: "stat",
+    VAR_INST: "inst",
+    VAR_GLOBAL: "global",
+    VAR_EXTERNAL: "external",
+    VAR_CONFIG: "config",
+};
+function intervalText(t) {
+    if (!t.interval)
+        return t.kind ?? "";
+    return `${t.interval}${t.interval_unit && !/[a-z]/i.test(t.interval) ? ` ${t.interval_unit}` : ""}`;
+}
+const varText = (v, withComment = true) => `${v.name}${v.at ? ` AT ${v.at}` : ""} : ${v.type}${v.init !== undefined ? ` := ${v.init}` : ""}${withComment && v.comment ? ` // ${v.comment}` : ""}`;
+export function buildOutline(nodes, tasks, o = {}) {
+    const byPath = new Map(nodes.map((n) => [n.path.toLowerCase(), n]));
+    const parentOf = (p) => (p.includes("/") ? p.slice(0, p.lastIndexOf("/")) : "");
+    const kids = new Map();
+    for (const n of nodes) {
+        const p = parentOf(n.path).toLowerCase();
+        if (!kids.has(p))
+            kids.set(p, []);
+        kids.get(p).push(n);
+    }
+    const childrenOf = (n, ...kinds) => (kids.get(n.path.toLowerCase()) ?? []).filter((c) => !kinds.length || kinds.includes(c.kind));
+    const isContainer = (p) => p === "" || byPath.get(p.toLowerCase())?.kind === "folder";
+    const tops = nodes.filter((n) => TOP_KINDS.has(n.kind) && isContainer(parentOf(n.path)));
+    const parsed = new Map();
+    const parse = (n) => {
+        let p = parsed.get(n.path);
+        if (!p) {
+            p = parseDeclaration(n.declaration);
+            parsed.set(n.path, p);
+        }
+        return p;
+    };
+    const runBy = new Map();
+    for (const t of tasks)
+        for (const pou of t.pous) {
+            const k = pou.split(".").pop().toLowerCase();
+            runBy.set(k, [...(runBy.get(k) ?? []), `${t.name} ${intervalText(t)}`.trim()]);
+        }
+    const isTest = (n) => parse(n).header.attributes.some((a) => a.toLowerCase() === "test");
+    // ---- one object, in detail
+    const detail = (n) => {
+        const p = parse(n);
+        const h = p.header;
+        const out = [];
+        const head = [n.path, kindText(n, p)];
+        const run = runBy.get(n.name.toLowerCase());
+        if (run)
+            head.push(`run by ${run.join(", ")}`);
+        out.push(head.join("  "));
+        if (n.st === false)
+            out.push("  (graphical body: not ST)");
+        if (h.attributes.length)
+            out.push(`  attributes: ${h.attributes.join(", ")}`);
+        if (p.dutKind === "enum")
+            out.push(`  members: ${p.enumMembers.map((m) => (m.value !== undefined ? `${m.name} := ${m.value}` : m.name)).join(", ")}${p.baseType ? `  (base ${p.baseType})` : ""}`);
+        if (p.dutKind === "alias")
+            out.push(`  = ${p.baseType}`);
+        for (const f of p.fields ?? [])
+            out.push(`  ${varText(f)}`);
+        let section = "";
+        for (const v of p.vars) {
+            if (v.section !== section) {
+                section = v.section;
+                out.push(`  ${SECTION_LABEL[v.section] ?? v.section}${v.constant ? " constant" : ""}${v.retain ? " retain" : ""}${v.persistent ? " persistent" : ""}:`);
+            }
+            out.push(`    ${varText(v)}`);
+        }
+        for (const m of childrenOf(n, "method", "interface_method")) {
+            const mp = parse(m);
+            const locals = mp.vars.filter((v) => !["VAR_INPUT", "VAR_OUTPUT", "VAR_IN_OUT"].includes(v.section)).length;
+            out.push(`  method ${[...mp.header.modifiers, ""].join(" ")}${signature(mp, m.name)}${locals ? `  (${locals} local${locals > 1 ? "s" : ""})` : ""}`);
+        }
+        for (const pr of childrenOf(n, "property")) {
+            const pp = parse(pr);
+            const acc = childrenOf(pr, "accessor").map((a) => a.name.toLowerCase());
+            out.push(`  property ${[...pp.header.modifiers, ""].join(" ")}${pr.name} : ${pp.header.returnType ?? "?"} (${acc.join(", ") || "no accessors"})`);
+        }
+        for (const a of childrenOf(n, "action"))
+            out.push(`  action ${a.name}${a.st === false ? " [non-ST]" : ""}`);
+        const lines = (n.implementation ?? "").replace(/\s+$/, "").split("\n").filter((l) => l.trim()).length;
+        if (n.kind === "pou")
+            out.push(`  implementation: ${lines} line(s)`);
+        return out;
+    };
+    // ---- overview line(s) for one object
+    const brief = (n) => {
+        const p = parse(n);
+        const run = runBy.get(n.name.toLowerCase());
+        const tags = [kindText(n, p), run ? `[${run.join(", ")}]` : "", n.st === false ? "[non-ST]" : ""].filter(Boolean).join(" ");
+        const out = [`${n.path}  ${tags}`];
+        if (n.kind === "pou" && !isTest(n)) {
+            const ins = p.vars.filter((v) => v.section === "VAR_INPUT" || v.section === "VAR_IN_OUT");
+            const outs = p.vars.filter((v) => v.section === "VAR_OUTPUT");
+            if (ins.length)
+                out.push(`  in: ${ins.map((v) => varText(v, false)).join("; ")}`);
+            if (outs.length)
+                out.push(`  out: ${outs.map((v) => varText(v, false)).join("; ")}`);
+            const ms = childrenOf(n, "method").map((m) => signature(parse(m), m.name));
+            if (ms.length)
+                out.push(`  methods: ${ms.join("; ")}`);
+            const ps = childrenOf(n, "property").map((pr) => {
+                const acc = childrenOf(pr, "accessor").map((a) => a.name.toLowerCase());
+                return `${pr.name} : ${parse(pr).header.returnType ?? "?"}${acc.length === 1 ? ` (${acc[0]} only)` : ""}`;
+            });
+            if (ps.length)
+                out.push(`  properties: ${ps.join("; ")}`);
+            const as = childrenOf(n, "action").map((a) => a.name);
+            if (as.length)
+                out.push(`  actions: ${as.join(", ")}`);
+        }
+        else if (n.kind === "interface") {
+            const ms = childrenOf(n, "interface_method", "method").map((m) => signature(parse(m), m.name));
+            if (ms.length)
+                out.push(`  methods: ${ms.join("; ")}`);
+        }
+        else if (n.kind === "dut" && p.fields?.length) {
+            out.push(`  fields: ${p.fields.slice(0, 12).map((f) => `${f.name} : ${f.type}`).join("; ")}${p.fields.length > 12 ? `; ... (${p.fields.length})` : ""}`);
+        }
+        return out;
+    };
+    const max = o.maxLines ?? 400;
+    const clip = (lines, hint) => (lines.length > max ? [...lines.slice(0, max), `... ${lines.length - max} more line(s). ${hint}`] : lines);
+    if (o.path) {
+        const target = byPath.get(o.path.replace(/^\/+/, "").toLowerCase());
+        if (!target) {
+            const close = nodes.filter((n) => n.name.toLowerCase() === o.path.split("/").pop().toLowerCase()).map((n) => n.path);
+            return `No object '${o.path}'.${close.length ? ` Did you mean: ${close.join(", ")}?` : ""}`;
+        }
+        if (target.kind === "folder") {
+            const inside = tops.filter((t) => t.path.toLowerCase().startsWith(target.path.toLowerCase() + "/"));
+            return clip([`${target.path}/  (${inside.length} object(s))`, ...inside.flatMap(brief)], "Ask for one object for details.").join("\n");
+        }
+        const top = TOP_KINDS.has(target.kind) ? target : undefined;
+        if (top)
+            return clip(detail(top), "").join("\n");
+        // a method, property or action: its own declaration
+        const p = parse(target);
+        return clip([`${target.path}  ${target.kind}`, ...p.vars.map((v) => `  ${SECTION_LABEL[v.section] ?? v.section}: ${varText(v)}`), ...(p.header.returnType ? [`  returns ${p.header.returnType}`] : [])], "").join("\n");
+    }
+    const count = (pred) => tops.filter(pred).length;
+    const tests = tops.filter((n) => n.kind === "pou" && isTest(n));
+    const header = [
+        `Outline: ${count((n) => n.kind === "pou" && !isTest(n))} POU(s), ${count((n) => n.kind === "gvl")} GVL(s), ${count((n) => n.kind === "dut")} DUT(s), ${count((n) => n.kind === "interface")} interface(s)${tests.length ? `, ${tests.length} test(s)` : ""}.`,
+        `Tasks: ${tasks.length ? tasks.map((t) => `${t.name} (${intervalText(t)}${t.priority ? `, prio ${t.priority}` : ""}) -> ${t.pous.join(", ") || "nothing"}`).join("; ") : "none"}`,
+    ];
+    const order = (n) => (isTest(n) ? 9 : n.kind === "pou" ? (n.sub === "program" ? 0 : n.sub === "function_block" ? 1 : 2) : n.kind === "interface" ? 3 : n.kind === "dut" ? 4 : 5);
+    const sorted = [...tops].sort((a, b) => order(a) - order(b) || a.path.localeCompare(b.path));
+    const body = sorted.filter((n) => !isTest(n)).flatMap(brief);
+    if (tests.length)
+        body.push(`tests: ${tests.map((t) => t.path).join(", ")}`);
+    return clip([...header, ...body], "Pass path (an object or folder) to narrow it.").join("\n");
+}
+function kindText(n, p) {
+    const h = p.header;
+    const mods = h.modifiers.length ? `${h.modifiers.join(" ")} ` : "";
+    if (n.kind === "pou") {
+        if (h.attributes.some((a) => a.toLowerCase() === "test"))
+            return "TEST";
+        const kw = h.keyword || (n.sub ?? "").toUpperCase();
+        let s = `${mods}${kw}`;
+        if (h.returnType)
+            s += ` : ${h.returnType}`;
+        if (h.extends?.length)
+            s += ` EXTENDS ${h.extends.join(", ")}`;
+        if (h.implements?.length)
+            s += ` IMPLEMENTS ${h.implements.join(", ")}`;
+        return s;
+    }
+    if (n.kind === "interface") {
+        const bases = (h.extends ?? []).filter((b) => !/^__System\.IQueryInterface$/i.test(b));
+        return `INTERFACE${bases.length ? ` EXTENDS ${bases.join(", ")}` : ""}`;
+    }
+    if (n.kind === "gvl") {
+        const q = h.attributes.some((a) => a.toLowerCase() === "qualified_only");
+        return `GVL (${p.vars.length} var${p.vars.length === 1 ? "" : "s"}${q ? ", qualified_only" : ""})`;
+    }
+    if (n.kind === "dut") {
+        if (p.dutKind === "enum")
+            return `ENUM (${p.enumMembers.map((m) => (m.value !== undefined ? `${m.name}=${m.value}` : m.name)).join(", ")})`;
+        if (p.dutKind === "alias")
+            return `ALIAS = ${p.baseType}`;
+        return `${(p.dutKind ?? "dut").toUpperCase()}${p.fields ? ` (${p.fields.length} field${p.fields.length === 1 ? "" : "s"})` : ""}`;
+    }
+    return n.kind;
+}
+/** Variables with AT addresses (including the %I* and %Q* placeholders), from GVLs and POUs. */
+export function ioList(nodes) {
+    const out = [];
+    for (const n of nodes) {
+        if (!["gvl", "pou"].includes(n.kind))
+            continue;
+        for (const v of parseDeclaration(n.declaration).vars) {
+            if (!v.at)
+                continue;
+            const area = /^%([IQM])/i.exec(v.at)?.[1]?.toUpperCase();
+            out.push({
+                owner: n.path,
+                name: v.name,
+                at: v.at,
+                type: v.type,
+                direction: area === "I" ? "input" : area === "Q" ? "output" : "memory",
+                ...(v.comment ? { comment: v.comment } : {}),
+                placeholder: /\*$/.test(v.at),
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=outline.js.map

package/dist/codesys/outline.js.map

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

package/dist/codesys/simulation.d.ts

@@ -0,0 +1,34 @@
+import type { RegisterAction } from "../actions.js";
+import type { AppContext } from "../tools.js";
+interface Status {
+    running: boolean;
+    state?: string;
+    operation?: string;
+    forced?: string[];
+    cycles?: number;
+}
+export interface CodesysSimState {
+    state: string;
+    forced: string[];
+    cycles: number;
+    /** The bridge's restart count when this was recorded: a restart ends the simulation. */
+    restarts?: number;
+}
+type ToolResult = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: boolean;
+};
+export interface SimToolDeps {
+    reg: RegisterAction;
+    run: (fn: () => Promise<string>) => Promise<ToolResult>;
+    /** Compile; the build report when it has errors, otherwise undefined. */
+    compileErrors: () => Promise<string | undefined>;
+}
+/** The simulation the panel should show; undefined when none runs. */
+export declare function currentCodesysSim(ctx: AppContext): CodesysSimState | undefined;
+export declare function describeSim(s: Status): string;
+export declare function registerCodesysSim(ctx: AppContext, deps: SimToolDeps): void;
+export {};

package/dist/codesys/simulation.js

@@ -0,0 +1,57 @@
+/**
+ * CODESYS's own simulation: runs the active application inside CODESYS, with no
+ * controller and nothing extra to install. It uses the real CODESYS compiler
+ * and libraries. It can run, read, write, force and take single cycles. It has
+ * no breakpoints: CODESYS's scripting offers none, and its breakpoint commands
+ * work at an editor cursor, which a session without a window doesn't have.
+ */
+import * as z from "zod/v4";
+/** The simulation the panel should show; undefined when none runs. */
+export function currentCodesysSim(ctx) {
+    const s = ctx.codesysSim;
+    return s && s.restarts === ctx.bridge.health().restarts ? s : undefined;
+}
+export function describeSim(s) {
+    if (!s.running)
+        return "CODESYS simulation: not running.";
+    return `CODESYS simulation: application ${s.state}.${s.forced?.length ? ` Forced: ${s.forced.join(", ")}.` : ""}`;
+}
+const names = z.array(z.string()).min(1).describe("Variables as CODESYS expressions relative to the application, e.g. 'PLC_PRG.nCount' or 'GVL_IO.xValve'");
+const values = z.record(z.string(), z.string()).describe("Variable to value, with values as Structured Text: { 'PLC_PRG.xStart': 'TRUE', 'PLC_PRG.nSpeed': '5' }");
+export function registerCodesysSim(ctx, deps) {
+    const b = ctx.bridge;
+    const { reg, run } = deps;
+    const NOTE = "CODESYS's own simulation: no controller is involved.";
+    const status = async (op, args = {}, timeoutMs = 60_000) => {
+        const s = await b.call(op, args, { timeoutMs });
+        ctx.codesysSim = s.running ? { state: s.state ?? "unknown", forced: s.forced ?? [], cycles: s.cycles ?? 0, restarts: b.health().restarts } : undefined;
+        return describeSim(s);
+    };
+    reg("codesys_sim_start", {
+        description: `Compile, then load the active application into ${NOTE} Uses the real CODESYS compiler and libraries, and needs nothing installed beyond CODESYS. The application is loaded and stopped unless run is true. While the simulation runs the project is locked: compile, write_object and the other changing tools are refused until codesys_sim_stop. It has no breakpoints, and time runs at real speed.`,
+        inputSchema: z.object({ run: z.boolean().optional().describe("Start the application straight away (default false)") }),
+    }, async ({ run: start }) => run(async () => {
+        const errors = await deps.compileErrors();
+        if (errors)
+            throw new Error(`Fix the compile errors before simulating.\n${errors}`);
+        return `${await status("sim.start", { run: !!start }, 300_000)} The project is locked until codesys_sim_stop.`;
+    }));
+    reg("codesys_sim_stop", { description: "Stop CODESYS's own simulation, release all forced values and unlock the project.", inputSchema: z.object({}) }, async () => run(() => status("sim.stop", {}, 120_000)));
+    reg("codesys_sim_status", { description: "Whether CODESYS's own simulation is running, the application's state and the forced variables.", inputSchema: z.object({}) }, async () => run(() => status("sim.status")));
+    reg("codesys_sim_control", {
+        description: "Run, stop or reset the application in CODESYS's own simulation. A reset also releases forced values.",
+        inputSchema: z.object({ action: z.enum(["run", "stop", "reset_warm", "reset_cold"]) }),
+    }, async ({ action }) => run(() => status("sim.control", { action })));
+    reg("codesys_sim_cycle", {
+        description: "Run exactly this many task cycles in CODESYS's own simulation, then stay stopped. Stops the application first if it is running. Each cycle takes about 0.1 s. Timers follow the clock, not the cycle count: to let a TON elapse, wait, then run another cycle.",
+        inputSchema: z.object({ count: z.number().int().min(1).max(1000).optional().describe("Cycles to run (default 1)") }),
+    }, async ({ count }) => run(() => status("sim.cycle", { count: count ?? 1 }, Math.max(60_000, (count ?? 1) * 1_000))));
+    reg("codesys_sim_read", { description: "Read current values from CODESYS's own simulation. A read takes about 0.4 s, so read everything you need in one call.", inputSchema: z.object({ names }) }, async ({ names: list }) => run(async () => {
+        const r = await b.call("sim.read", { names: list });
+        return list.map((n) => (n in r.values ? `${n} = ${r.values[n]}` : `${n}: ${r.errors[n] ?? "no value"}`)).join("\n");
+    }));
+    reg("codesys_sim_write", { description: "Write values once in CODESYS's own simulation. If the program assigns the variable, the next cycle overwrites it; use codesys_sim_force to hold a value.", inputSchema: z.object({ values }) }, async ({ values: v }) => run(() => status("sim.write", { values: v })));
+    reg("codesys_sim_force", { description: "Force values in CODESYS's own simulation, until codesys_sim_unforce or codesys_sim_stop. Right for inputs. CODESYS re-applies a force between scans, so if the program assigns the variable, code before that assignment sees the forced value and code after it, in the same scan, sees the program's own value.", inputSchema: z.object({ values }) }, async ({ values: v }) => run(() => status("sim.force", { values: v })));
+    reg("codesys_sim_unforce", { description: "Release forced values in CODESYS's own simulation: the named ones, or all of them.", inputSchema: z.object({ names: names.optional() }) }, async ({ names: list }) => run(() => status("sim.unforce", list ? { names: list } : {})));
+}
+//# sourceMappingURL=simulation.js.map