@aryacode/dsh-engineering 0.0.0-stage → 0.4.0

package/vendor/l5x/lib/approvals.js

@@ -0,0 +1,93 @@
+/**
+ * Human approval for the controller actions that change a machine.
+ *
+ * Reading a controller needs no approval. Uploading a snapshot, changing mode
+ * and downloading a project each ask the session's approval service for this
+ * exact operation, and proceed only on `allowed-once`. A session whose policy
+ * is not `ask` cannot request approval at all, and the tool refuses before it
+ * touches the controller.
+ *
+ * @module dsh-engineering-l5x/approvals
+ */
+import { L5xError } from "./core/errors.js";
+/** The calling session behind an agent context. */
+function sessionOf(exec) {
+    return exec?.agent?.session;
+}
+/**
+ * Report whether this session can request per-operation approval.
+ *
+ * @param ctx - Plugin context that may provide the approval service.
+ * @param exec - Calling context carrying the agent.
+ * @returns The status fields the tool shows the reader.
+ */
+export function approvalStatus(ctx, exec) {
+    const approval = ctx.get?.('approval');
+    const session = sessionOf(exec);
+    const presets = ctx.get?.('permissionPresets');
+    const preset = session === undefined ? undefined : presets?.current?.(session);
+    const policy = session === undefined || approval === undefined
+        ? undefined
+        : approval.overrideOf?.(session) ?? approval.config?.policy ?? 'ask';
+    const requestable = session !== undefined && typeof approval?.request === 'function' && policy === 'ask';
+    return {
+        permission_preset: preset ?? 'unknown',
+        approval_policy: policy ?? 'unknown',
+        approval_service: typeof approval?.request === 'function',
+        agent_context: session !== undefined,
+        approved_controller_actions_requestable: requestable,
+        approval_required_per_call: ['capture_controller_snapshot', 'change_controller_mode', 'download_project'],
+        ...(requestable
+            ? { note: 'A human must still approve each exact operation; this does not confirm an answerer is online.' }
+            : {
+                next_step: policy === 'never'
+                    ? preset === 'danger-full-access'
+                        ? 'Switch this session from Full access to a preset that asks for approval, then call this tool again.'
+                        : 'This session has Never approval policy. Change it to Ask before a controller action, then call this tool again.'
+                    : 'Use a session with an agent context and an approval service that can ask. Do not bypass the plugin.',
+            }),
+    };
+}
+/**
+ * Refuse when approval cannot be requested at all.
+ *
+ * @param ctx - Plugin context.
+ * @param exec - Calling context.
+ */
+export function ensureApprovalReady(ctx, exec) {
+    const status = approvalStatus(ctx, exec);
+    if (!status.approved_controller_actions_requestable) {
+        throw new L5xError('APPROVAL_UNAVAILABLE', `Human approval cannot be requested (policy: ${status.approval_policy}). ${status.next_step ?? ''}`, 'Switch to an approval preset that asks, then call this tool again.');
+    }
+}
+/**
+ * Ask for approval of one exact operation and refuse unless it is granted once.
+ *
+ * @param ctx - Plugin context.
+ * @param exec - Calling context.
+ * @param toolName - Tool asking, recorded with the request.
+ * @param reason - Exact operation the human is approving.
+ */
+export async function requireHumanApproval(ctx, exec, toolName, reason) {
+    ensureApprovalReady(ctx, exec);
+    const approval = ctx.get?.('approval');
+    if (exec?.agent === undefined || typeof approval?.request !== 'function') {
+        throw new L5xError('APPROVAL_UNAVAILABLE', `${toolName} requires human approval for this exact operation.`, 'Use a session with an agent context and an approval service, then call this tool again.');
+    }
+    let outcome;
+    try {
+        outcome = await approval.request({
+            agent: exec.agent,
+            toolName,
+            callId: exec.callId,
+            reason,
+            ...(exec.signal === undefined ? {} : { signal: exec.signal }),
+        });
+    }
+    catch (error) {
+        throw new L5xError('APPROVAL_UNAVAILABLE', error instanceof Error ? error.message : String(error), 'Check that a human can answer approval requests in this session, then retry.');
+    }
+    if (outcome !== 'allowed-once') {
+        throw new L5xError('APPROVAL_DENIED', `${toolName} was not approved (${outcome}).`, 'Nothing was sent to the controller. Ask the human what to change, then request a new operation.');
+    }
+}

package/vendor/l5x/lib/client.js

@@ -0,0 +1,412 @@
+window.__ModuleLoader__.load({
+	id: "@aryacode/dsh-engineering-l5x",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		// src/client/locales.ts
+		/** Copy owned by the Studio 5000 loader console. */
+		/** Locale namespace this console registers its dictionaries under. */
+		const NS = "studio5000";
+		/** Chinese copy. */
+		const zh = {
+			"trend.title": "PLC 实时趋势",
+			"trend.actualInterval": "显示窗口平均实际间隔",
+			"trend.overruns": "观察到的超时周期",
+			"trend.badValue": "读数不可用",
+			"trend.connecting": "正在连接…",
+			"trend.running": "采集中",
+			"trend.completed": "采集完成",
+			"trend.stopped": "已停止",
+			"trend.failed": "采集失败",
+			"trend.unavailable": "实时趋势流不可用",
+			"trend.gap": "部分历史数据不可用",
+			"trend.stopFailed": "无法停止采集，请重试",
+			"trend.stop": "停止",
+			"trend.interval": "请求间隔",
+			"trend.samples": "显示采样数",
+			"trend.source": "源文件",
+			"trend.limitation": "读取并非 PLC 扫描同步，可能遗漏变化；尚未验证在线逻辑与导出一致",
+			title: "Studio 5000",
+			workspace: "工作区",
+			refresh: "刷新",
+			rescan: "重新扫描",
+			recent: "最近打开",
+			projects: "项目",
+			open: "在 Studio 5000 中打开",
+			filter: "筛选 ACD 项目",
+			"fallback.open": "使用 Windows 默认应用打开",
+			"fallback.description": "文件处理程序查询不可用或未找到 Studio。此操作将使用此 ACD 的系统默认应用。",
+			"status.defaultOpened": "已发送给系统默认应用。请确认打开的是正确项目。",
+			"launch.description": "在已安装的 Studio 5000 中打开项目。",
+			"status.desktop": "此主机没有可用的桌面。",
+			"status.discovery": "无法检查此文件的应用程序。请更新主机或检查连接。",
+			"status.handler": "没有找到 Studio 5000 文件处理程序。请检查安装和 ACD 文件关联。",
+			reveal: "在资源管理器中显示",
+			"empty.none": "此工作区中没有找到 .acd 文件。",
+			"empty.scanning": "正在扫描工作区…",
+			"empty.noSession": "此工作区还没有会话，无法列出文件。",
+			"empty.noWorkspace": "还没有工作区。请先打开一个项目文件夹。",
+			"unavailable.listing": "此配置未提供工作区文件列表功能。",
+			"unavailable.launch": "此主机无法打开本机文件。",
+			"unavailable.desktop": "当前主机没有可用的桌面程序。",
+			"status.opened": "已发送打开请求。请在 Studio 5000 中确认项目已打开。",
+			"status.revealed": "已在资源管理器中显示。",
+			"status.failed": "打开失败。",
+			"status.scanFailed": "部分目录无法读取。",
+			"status.truncated": "列表已被截断。",
+			size: "大小",
+			truncated: "（已截断）"
+		};
+		/** English copy, same keys. */
+		const en = {
+			"trend.title": "Live PLC trend",
+			"trend.actualInterval": "Mean actual interval in displayed window",
+			"trend.overruns": "Observed sweep overruns",
+			"trend.badValue": "Reading unavailable",
+			"trend.connecting": "Connecting…",
+			"trend.running": "Collecting",
+			"trend.completed": "Capture complete",
+			"trend.stopped": "Stopped",
+			"trend.failed": "Capture failed",
+			"trend.unavailable": "Live trend stream unavailable",
+			"trend.gap": "Some history is unavailable",
+			"trend.stopFailed": "Could not stop capture. Try again.",
+			"trend.stop": "Stop",
+			"trend.interval": "Requested interval",
+			"trend.samples": "Displayed samples",
+			"trend.source": "Source export",
+			"trend.limitation": "Reads are not scan-synchronized and may miss transitions. Online logic matching this export is unverified.",
+			title: "Studio 5000",
+			workspace: "Workspace",
+			refresh: "Refresh",
+			rescan: "Rescan",
+			recent: "Recently opened",
+			projects: "Projects",
+			open: "Open in Studio 5000",
+			filter: "Filter ACD projects",
+			"fallback.open": "Open with Windows default",
+			"fallback.description": "Handler discovery is unavailable or found no Studio handler. This opens the selected ACD using its system default application.",
+			"status.defaultOpened": "Sent to the system default application. Confirm the correct project opened.",
+			"launch.description": "Open projects in installed Studio 5000.",
+			"status.desktop": "No desktop is available on this host.",
+			"status.discovery": "Could not check file handlers. Update the host or check the connection.",
+			"status.handler": "No Studio 5000 file handler found. Check the installation and ACD file association.",
+			reveal: "Reveal in Explorer",
+			"empty.none": "No .acd files found in this workspace.",
+			"empty.scanning": "Scanning the workspace…",
+			"empty.noSession": "This workspace has no Session yet, so its files cannot be listed.",
+			"empty.noWorkspace": "No workspace yet. Open a project folder first.",
+			"unavailable.listing": "Workspace file listing is not available in this profile.",
+			"unavailable.launch": "This host cannot open local files.",
+			"unavailable.desktop": "No desktop application is available on this host.",
+			"status.opened": "Open request sent. Confirm the project opened in Studio 5000.",
+			"status.revealed": "Revealed in the file manager.",
+			"status.failed": "Could not open the project.",
+			"status.scanFailed": "Some directories could not be read.",
+			"status.truncated": "The listing was truncated.",
+			size: "Size",
+			truncated: "(truncated)"
+		};
+		// src/client/trend-model.ts
+		/** Parse a recorded start receipt. @param content - Logged tool content. @returns Valid receipt or undefined. */
+		function trendReceipt(content) {
+			if (!Array.isArray(content)) return void 0;
+			for (const entry of content) {
+				if (!entry || typeof entry !== "object" || entry.type !== "text" || typeof entry.text !== "string") continue;
+				try {
+					const value = JSON.parse(entry.text);
+					if (value && typeof value === "object" && "view" in value && value.view === "plc-trend" && "job_id" in value && typeof value.job_id === "string" && /^plc-trend-\d+$/u.test(value.job_id) && "owner_session_id" in value && typeof value.owner_session_id === "string" && "requested_interval_ms" in value && typeof value.requested_interval_ms === "number" && "source_sha256" in value && typeof value.source_sha256 === "string" && "display_refresh_ms" in value && typeof value.display_refresh_ms === "number" && value.display_refresh_ms >= 50 && value.display_refresh_ms <= 1e4 && "display_max_samples" in value && typeof value.display_max_samples === "number" && value.display_max_samples >= 2 && value.display_max_samples <= 2e4) return {
+						jobId: value.job_id,
+						sessionId: value.owner_session_id,
+						interval: value.requested_interval_ms,
+						sourceHash: value.source_sha256,
+						refresh: value.display_refresh_ms,
+						maxSamples: value.display_max_samples
+					};
+				} catch (error) {}
+			}
+		}
+		/** Parse one sampler line. @param line - Retained job output. @returns Plot point or undefined for other frames. */
+		function trendPoint(line) {
+			const value = JSON.parse(line);
+			if (!value || typeof value !== "object" || !("type" in value) || value.type !== "sample") return void 0;
+			if (!("elapsed_ms" in value) || typeof value.elapsed_ms !== "number" || !Number.isFinite(value.elapsed_ms) || !("values" in value) || !Array.isArray(value.values)) throw new Error("Invalid trend sample");
+			const values = value.values.map((item) => {
+				if (!item || typeof item !== "object" || !("tag" in item) || typeof item.tag !== "string" || !("quality" in item) || typeof item.quality !== "string" || !("value" in item) || !(item.value === null || typeof item.value === "boolean" || typeof item.value === "number" && Number.isFinite(item.value))) throw new Error("Invalid trend value");
+				return {
+					tag: item.tag,
+					quality: item.quality,
+					value: item.value
+				};
+			});
+			return {
+				elapsed: value.elapsed_ms,
+				overrun: "overrun" in value && typeof value.overrun === "boolean" ? value.overrun : void 0,
+				values
+			};
+		}
+		/** Build distinct line segments so bad samples do not imply continuity. @param points - Retained samples. @param tag - Scoped tag. @returns SVG line segments and range. */
+		function trendSegments(points, tag) {
+			const finite = points.flatMap((point) => point.values.filter((item) => item.tag === tag && item.quality === "good" && item.value !== null).map((item) => Number(item.value)));
+			const min = Math.min(0, ...finite);
+			const max = Math.max(1, ...finite);
+			const start = points[0]?.elapsed ?? 0;
+			const duration = Math.max(1, (points.at(-1)?.elapsed ?? start) - start);
+			const segments = [];
+			let current = [];
+			for (const point of points) {
+				const value = point.values.find((item) => item.tag === tag);
+				if (!value || value.quality !== "good" || value.value === null) {
+					if (current.length) segments.push(current.join(" "));
+					current = [];
+					continue;
+				}
+				const x = 10 + (point.elapsed - start) / duration * 580;
+				const y = 100 - (Number(value.value) - min) / (max - min) * 90;
+				if (typeof value.value === "boolean" && current.length) current.push(`${x},${current.at(-1)?.split(",")[1]}`);
+				current.push(`${x},${y}`);
+			}
+			if (current.length) segments.push(current.join(" "));
+			return {
+				segments,
+				min,
+				max
+			};
+		}
+		// src/client/TrendCard.tsx
+		/** Inline live PLC trend driven by the existing session-authorized job stream. */
+		/** Display a live watch and stop it without cancelling the chat. @param props - Tool seat and existing job Remote. @returns Trend card. */
+		function TrendCard({ phase, block, trendJobs, t }) {
+			const receipt = phase === "result" ? trendReceipt(block.content) : void 0;
+			const [points, setPoints] = (0, react.useState)([]);
+			const [state, setState] = (0, react.useState)("trend.connecting");
+			const [stopping, setStopping] = (0, react.useState)(false);
+			(0, react.useEffect)(() => {
+				if (!receipt || !trendJobs) return;
+				const abort = new AbortController();
+				let pending = [];
+				let dirty = false;
+				let tail = "";
+				const flush = () => {
+					if (!dirty || abort.signal.aborted) return;
+					dirty = false;
+					setPoints([...pending]);
+				};
+				const timer = setInterval(flush, receipt.refresh);
+				const run = async () => {
+					try {
+						for await (const frame of trendJobs.follow({
+							jobId: receipt.jobId,
+							sessionId: receipt.sessionId
+						}, abort.signal)) {
+							if (abort.signal.aborted) return;
+							if (!frame || typeof frame !== "object" || !("type" in frame)) throw new Error("Invalid job frame");
+							if (frame.type === "opened") setState("trend.running");
+							if (frame.type === "output" && "chunks" in frame && Array.isArray(frame.chunks)) {
+								if ("lossy" in frame && frame.lossy === true) {
+									pending = [];
+									tail = "";
+									setState("trend.gap");
+								}
+								for (const chunk of frame.chunks) {
+									if (!chunk || typeof chunk !== "object" || typeof chunk.text !== "string") throw new Error("Invalid trend output");
+									if (chunk.gapBefore === true) {
+										pending = [];
+										tail = "";
+										setState("trend.gap");
+									}
+									tail += chunk.text;
+									const lines = tail.split("\n");
+									tail = lines.pop() ?? "";
+									for (const line of lines) {
+										const point = trendPoint(line);
+										if (point) {
+											pending.push(point);
+											if (pending.length > receipt.maxSamples) pending.shift();
+											dirty = true;
+										}
+									}
+								}
+							}
+							if (frame.type === "status" && "job" in frame && frame.job && typeof frame.job === "object" && "status" in frame.job) {
+								flush();
+								setState(frame.job.status === "completed" ? "trend.completed" : frame.job.status === "killed" ? "trend.stopped" : "trend.failed");
+							}
+						}
+					} catch (error) {
+						if (!abort.signal.aborted) setState("trend.unavailable");
+					} finally {
+						clearInterval(timer);
+						flush();
+					}
+				};
+				run();
+				return () => {
+					abort.abort();
+					clearInterval(timer);
+				};
+			}, [
+				receipt?.jobId,
+				receipt?.sessionId,
+				receipt?.refresh,
+				receipt?.maxSamples,
+				trendJobs
+			]);
+			if (!receipt) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				role: "status",
+				children: t(block.isError ? "trend.failed" : "trend.connecting")
+			});
+			const tags = [...new Set(points.flatMap((point) => point.values.map((value) => value.tag)))];
+			const stop = async () => {
+				if (!trendJobs || stopping) return;
+				setStopping(true);
+				try {
+					if (!(await trendJobs.kill({
+						jobId: receipt.jobId,
+						sessionId: receipt.sessionId
+					})).ok) setState("trend.stopFailed");
+				} catch (error) {
+					setState("trend.stopFailed");
+				} finally {
+					setStopping(false);
+				}
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				"aria-label": t("trend.title"),
+				style: {
+					padding: "12px",
+					border: "1px solid var(--dsw-alias-border-l3)",
+					borderRadius: "8px"
+				},
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: {
+							display: "flex",
+							gap: "12px",
+							alignItems: "center"
+						},
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("trend.title") }),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								role: "status",
+								children: t(trendJobs ? state : "trend.unavailable")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: {
+									color: "var(--dsw-alias-label-primary)",
+									background: "transparent",
+									border: "1px solid var(--dsw-alias-border-l3)",
+									borderRadius: "6px",
+									font: "inherit",
+									padding: "4px 10px"
+								},
+								disabled: !trendJobs || stopping || [
+									"trend.completed",
+									"trend.stopped",
+									"trend.failed"
+								].includes(state),
+								onClick: () => {
+									stop();
+								},
+								children: t("trend.stop")
+							})
+						]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", { children: [
+						t("trend.interval"),
+						": ",
+						receipt.interval,
+						" ms · ",
+						t("trend.samples"),
+						": ",
+						points.length
+					] }),
+					points.length > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", { children: [
+						t("trend.actualInterval"),
+						": ",
+						((points.at(-1).elapsed - points[0].elapsed) / (points.length - 1)).toFixed(1),
+						" ms · ",
+						t("trend.overruns"),
+						": ",
+						points.filter((point) => point.overrun === true).length
+					] }),
+					tags.map((tag) => {
+						const plot = trendSegments(points, tag);
+						const latest = points.at(-1)?.values.find((value) => value.tag === tag);
+						return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("figure", {
+							style: { margin: "12px 0" },
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("figcaption", { children: [
+									tag,
+									" · ",
+									latest?.quality === "good" ? String(latest.value) : t("trend.badValue"),
+									" · ",
+									plot.min,
+									"–",
+									plot.max
+								] }),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+									viewBox: "0 0 600 110",
+									role: "img",
+									"aria-label": tag,
+									style: {
+										width: "100%",
+										height: "110px"
+									},
+									children: plot.segments.map((segment, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("polyline", {
+										points: segment,
+										fill: "none",
+										stroke: "currentColor",
+										strokeWidth: "1.5"
+									}, index))
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("small", { children: [
+									((points[0]?.elapsed ?? 0) / 1e3).toFixed(2),
+									"–",
+									((points.at(-1)?.elapsed ?? 0) / 1e3).toFixed(2),
+									" s"
+								] })
+							]
+						}, tag);
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("small", { children: [
+						t("trend.source"),
+						": ",
+						receipt.sourceHash.slice(0, 12),
+						" · ",
+						t("trend.limitation")
+					] })
+				]
+			});
+		}
+		// src/client/index.ts
+		/** Required client services; job availability is explained inside the card. */
+		const inject = [
+			"slots",
+			"locale",
+			"remote"
+		];
+		/** Register the live trend card without a Studio launcher sidebar. @param ctx - Browser service context. */
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "l5x-live: trend copy");
+			ctx.slots.inject("tool.call.toolview", () => ctx.slots.register({
+				name: "tool.call.toolview",
+				key: "start_plc_trend",
+				locale: NS,
+				inject: () => ({ trendJobs: ctx.remote.job })
+			}, TrendCard));
+		}
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/vendor/l5x/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":["useState"],"sources":["../src/client/locales.ts","../src/client/trend-model.ts","../src/client/TrendCard.tsx","../src/client/index.ts"],"sourcesContent":["/** Copy owned by the Studio 5000 loader console. */\n\n/** Locale namespace this console registers its dictionaries under. */\nexport const NS = 'studio5000'\n\n/** Chinese copy. */\nexport const zh = {\n  'trend.title': 'PLC 实时趋势',\n  'trend.actualInterval': '显示窗口平均实际间隔',\n  'trend.overruns': '观察到的超时周期',\n  'trend.badValue': '读数不可用',\n  'trend.connecting': '正在连接…',\n  'trend.running': '采集中',\n  'trend.completed': '采集完成',\n  'trend.stopped': '已停止',\n  'trend.failed': '采集失败',\n  'trend.unavailable': '实时趋势流不可用',\n  'trend.gap': '部分历史数据不可用',\n  'trend.stopFailed': '无法停止采集，请重试',\n  'trend.stop': '停止',\n  'trend.interval': '请求间隔',\n  'trend.samples': '显示采样数',\n  'trend.source': '源文件',\n  'trend.limitation': '读取并非 PLC 扫描同步，可能遗漏变化；尚未验证在线逻辑与导出一致',\n  title: 'Studio 5000',\n  workspace: '工作区',\n  refresh: '刷新',\n  rescan: '重新扫描',\n  recent: '最近打开',\n  projects: '项目',\n  open: '在 Studio 5000 中打开',\n  filter: '筛选 ACD 项目',\n  'fallback.open': '使用 Windows 默认应用打开',\n  'fallback.description': '文件处理程序查询不可用或未找到 Studio。此操作将使用此 ACD 的系统默认应用。',\n  'status.defaultOpened': '已发送给系统默认应用。请确认打开的是正确项目。',\n  'launch.description': '在已安装的 Studio 5000 中打开项目。',\n  'status.desktop': '此主机没有可用的桌面。',\n  'status.discovery': '无法检查此文件的应用程序。请更新主机或检查连接。',\n  'status.handler': '没有找到 Studio 5000 文件处理程序。请检查安装和 ACD 文件关联。',\n  reveal: '在资源管理器中显示',\n  'empty.none': '此工作区中没有找到 .acd 文件。',\n  'empty.scanning': '正在扫描工作区…',\n  'empty.noSession': '此工作区还没有会话，无法列出文件。',\n  'empty.noWorkspace': '还没有工作区。请先打开一个项目文件夹。',\n  'unavailable.listing': '此配置未提供工作区文件列表功能。',\n  'unavailable.launch': '此主机无法打开本机文件。',\n  'unavailable.desktop': '当前主机没有可用的桌面程序。',\n  'status.opened': '已发送打开请求。请在 Studio 5000 中确认项目已打开。',\n  'status.revealed': '已在资源管理器中显示。',\n  'status.failed': '打开失败。',\n  'status.scanFailed': '部分目录无法读取。',\n  'status.truncated': '列表已被截断。',\n  size: '大小',\n  truncated: '（已截断）',\n} satisfies Record<string, string>\n\n/** English copy, same keys. */\nexport const en = {\n  'trend.title': 'Live PLC trend',\n  'trend.actualInterval': 'Mean actual interval in displayed window',\n  'trend.overruns': 'Observed sweep overruns',\n  'trend.badValue': 'Reading unavailable',\n  'trend.connecting': 'Connecting…',\n  'trend.running': 'Collecting',\n  'trend.completed': 'Capture complete',\n  'trend.stopped': 'Stopped',\n  'trend.failed': 'Capture failed',\n  'trend.unavailable': 'Live trend stream unavailable',\n  'trend.gap': 'Some history is unavailable',\n  'trend.stopFailed': 'Could not stop capture. Try again.',\n  'trend.stop': 'Stop',\n  'trend.interval': 'Requested interval',\n  'trend.samples': 'Displayed samples',\n  'trend.source': 'Source export',\n  'trend.limitation': 'Reads are not scan-synchronized and may miss transitions. Online logic matching this export is unverified.',\n  title: 'Studio 5000',\n  workspace: 'Workspace',\n  refresh: 'Refresh',\n  rescan: 'Rescan',\n  recent: 'Recently opened',\n  projects: 'Projects',\n  open: 'Open in Studio 5000',\n  filter: 'Filter ACD projects',\n  'fallback.open': 'Open with Windows default',\n  'fallback.description': 'Handler discovery is unavailable or found no Studio handler. This opens the selected ACD using its system default application.',\n  'status.defaultOpened': 'Sent to the system default application. Confirm the correct project opened.',\n  'launch.description': 'Open projects in installed Studio 5000.',\n  'status.desktop': 'No desktop is available on this host.',\n  'status.discovery': 'Could not check file handlers. Update the host or check the connection.',\n  'status.handler': 'No Studio 5000 file handler found. Check the installation and ACD file association.',\n  reveal: 'Reveal in Explorer',\n  'empty.none': 'No .acd files found in this workspace.',\n  'empty.scanning': 'Scanning the workspace…',\n  'empty.noSession': 'This workspace has no Session yet, so its files cannot be listed.',\n  'empty.noWorkspace': 'No workspace yet. Open a project folder first.',\n  'unavailable.listing': 'Workspace file listing is not available in this profile.',\n  'unavailable.launch': 'This host cannot open local files.',\n  'unavailable.desktop': 'No desktop application is available on this host.',\n  'status.opened': 'Open request sent. Confirm the project opened in Studio 5000.',\n  'status.revealed': 'Revealed in the file manager.',\n  'status.failed': 'Could not open the project.',\n  'status.scanFailed': 'Some directories could not be read.',\n  'status.truncated': 'The listing was truncated.',\n  size: 'Size',\n  truncated: '(truncated)',\n} satisfies Record<keyof typeof zh, string>\n","/** Bounded, gap-preserving plot data from the authenticated job stream. */\nexport interface TrendPoint { elapsed: number; overrun: boolean | undefined; values: { tag: string; value: number | boolean | null; quality: string }[] }\n/** Start receipt persisted in the tool result. */\nexport interface TrendReceipt { jobId: string; sessionId: string; interval: number; sourceHash: string; refresh: number; maxSamples: number }\n\n/** Parse a recorded start receipt. @param content - Logged tool content. @returns Valid receipt or undefined. */\nexport function trendReceipt(content: unknown): TrendReceipt | undefined {\n  if (!Array.isArray(content)) return undefined\n  for (const entry of content) {\n    if (!entry || typeof entry !== 'object' || entry.type !== 'text' || typeof entry.text !== 'string') continue\n    try {\n      const value: unknown = JSON.parse(entry.text)\n      if (value && typeof value === 'object' && 'view' in value && value.view === 'plc-trend'\n        && 'job_id' in value && typeof value.job_id === 'string' && /^plc-trend-\\d+$/u.test(value.job_id)\n        && 'owner_session_id' in value && typeof value.owner_session_id === 'string'\n        && 'requested_interval_ms' in value && typeof value.requested_interval_ms === 'number'\n        && 'source_sha256' in value && typeof value.source_sha256 === 'string'\n        && 'display_refresh_ms' in value && typeof value.display_refresh_ms === 'number' && value.display_refresh_ms >= 50 && value.display_refresh_ms <= 10000\n        && 'display_max_samples' in value && typeof value.display_max_samples === 'number' && value.display_max_samples >= 2 && value.display_max_samples <= 20000)\n        return { jobId: value.job_id, sessionId: value.owner_session_id, interval: value.requested_interval_ms, sourceHash: value.source_sha256,\n          refresh: value.display_refresh_ms, maxSamples: value.display_max_samples }\n    } catch (error) { void error /* Failed tool output is rendered as a state, not plot data. */ }\n  }\n  return undefined\n}\n\n/** Parse one sampler line. @param line - Retained job output. @returns Plot point or undefined for other frames. */\nexport function trendPoint(line: string): TrendPoint | undefined {\n  const value: unknown = JSON.parse(line)\n  if (!value || typeof value !== 'object' || !('type' in value) || value.type !== 'sample') return undefined\n  if (!('elapsed_ms' in value) || typeof value.elapsed_ms !== 'number' || !Number.isFinite(value.elapsed_ms)\n    || !('values' in value) || !Array.isArray(value.values)) throw new Error('Invalid trend sample')\n  const values = value.values.map((item: unknown) => {\n    if (!item || typeof item !== 'object' || !('tag' in item) || typeof item.tag !== 'string'\n      || !('quality' in item) || typeof item.quality !== 'string' || !('value' in item)\n      || !(item.value === null || typeof item.value === 'boolean' || typeof item.value === 'number' && Number.isFinite(item.value)))\n      throw new Error('Invalid trend value')\n    return { tag: item.tag, quality: item.quality, value: item.value }\n  })\n  return { elapsed: value.elapsed_ms, overrun: 'overrun' in value && typeof value.overrun === 'boolean' ? value.overrun : undefined, values }\n}\n\n/** Build distinct line segments so bad samples do not imply continuity. @param points - Retained samples. @param tag - Scoped tag. @returns SVG line segments and range. */\nexport function trendSegments(points: readonly TrendPoint[], tag: string) {\n  const finite = points.flatMap(point => point.values.filter(item => item.tag === tag && item.quality === 'good' && item.value !== null).map(item => Number(item.value)))\n  const min = Math.min(0, ...finite); const max = Math.max(1, ...finite)\n  const start = points[0]?.elapsed ?? 0; const duration = Math.max(1, (points.at(-1)?.elapsed ?? start) - start)\n  const segments: string[] = []; let current: string[] = []\n  for (const point of points) {\n    const value = point.values.find(item => item.tag === tag)\n    if (!value || value.quality !== 'good' || value.value === null) {\n      if (current.length) segments.push(current.join(' ')); current = []; continue\n    }\n    const x = 10 + (point.elapsed - start) / duration * 580\n    const y = 100 - (Number(value.value) - min) / (max - min) * 90\n    if (typeof value.value === 'boolean' && current.length) current.push(`${x},${current.at(-1)?.split(',')[1]}`)\n    current.push(`${x},${y}`)\n  }\n  if (current.length) segments.push(current.join(' '))\n  return { segments, min, max }\n}\n","/** Inline live PLC trend driven by the existing session-authorized job stream. */\nimport { useEffect, useState } from 'react'\nimport type { TrendJobRemote } from './types.ts'\nimport { trendPoint, trendReceipt, trendSegments, type TrendPoint } from './trend-model.ts'\n\n/** Narrow owner/injected props supplied by the keyed tool seat. */\nexport interface TrendCardProps {\n  phase: string\n  block: { content?: unknown; isError?: boolean }\n  trendJobs?: TrendJobRemote | undefined\n  t(key: string): string\n}\n\n/** Display a live watch and stop it without cancelling the chat. @param props - Tool seat and existing job Remote. @returns Trend card. */\nexport function TrendCard({ phase, block, trendJobs, t }: TrendCardProps) {\n  const receipt = phase === 'result' ? trendReceipt(block.content) : undefined\n  const [points, setPoints] = useState<TrendPoint[]>([])\n  const [state, setState] = useState('trend.connecting')\n  const [stopping, setStopping] = useState(false)\n  useEffect(() => {\n    if (!receipt || !trendJobs) return\n    const abort = new AbortController()\n    let pending: TrendPoint[] = []; let dirty = false; let tail = ''\n    const flush = () => { if (!dirty || abort.signal.aborted) return; dirty = false; setPoints([...pending]) }\n    const timer = setInterval(flush, receipt.refresh)\n    const run = async () => {\n      try {\n        for await (const frame of trendJobs.follow({ jobId: receipt.jobId, sessionId: receipt.sessionId }, abort.signal)) {\n          if (abort.signal.aborted) return\n          if (!frame || typeof frame !== 'object' || !('type' in frame)) throw new Error('Invalid job frame')\n          if (frame.type === 'opened') setState('trend.running')\n          if (frame.type === 'output' && 'chunks' in frame && Array.isArray(frame.chunks)) {\n            if ('lossy' in frame && frame.lossy === true) { pending = []; tail = ''; setState('trend.gap') }\n            for (const chunk of frame.chunks) {\n              if (!chunk || typeof chunk !== 'object' || typeof chunk.text !== 'string') throw new Error('Invalid trend output')\n              if (chunk.gapBefore === true) { pending = []; tail = ''; setState('trend.gap') }\n              tail += chunk.text\n              const lines = tail.split('\\n'); tail = lines.pop() ?? ''\n              for (const line of lines) {\n                const point = trendPoint(line)\n                if (point) { pending.push(point); if (pending.length > receipt.maxSamples) pending.shift(); dirty = true }\n              }\n            }\n          }\n          if (frame.type === 'status' && 'job' in frame && frame.job && typeof frame.job === 'object' && 'status' in frame.job) {\n            flush(); setState(frame.job.status === 'completed' ? 'trend.completed' : frame.job.status === 'killed' ? 'trend.stopped' : 'trend.failed')\n          }\n        }\n      } catch (error) { if (!abort.signal.aborted) { void error; setState('trend.unavailable') } }\n      finally { clearInterval(timer); flush() }\n    }\n    void run()\n    return () => { abort.abort(); clearInterval(timer) }\n  }, [receipt?.jobId, receipt?.sessionId, receipt?.refresh, receipt?.maxSamples, trendJobs])\n  if (!receipt) return <div role=\"status\">{t(block.isError ? 'trend.failed' : 'trend.connecting')}</div>\n  const tags = [...new Set(points.flatMap(point => point.values.map(value => value.tag)))]\n  const stop = async () => {\n    if (!trendJobs || stopping) return\n    setStopping(true)\n    try {\n      const result = await trendJobs.kill({ jobId: receipt.jobId, sessionId: receipt.sessionId })\n      if (!result.ok) setState('trend.stopFailed')\n    } catch (error) { void error; setState('trend.stopFailed') }\n    finally { setStopping(false) }\n  }\n  return <section aria-label={t('trend.title')} style={{ padding: '12px', border: '1px solid var(--dsw-alias-border-l3)', borderRadius: '8px' }}>\n    <div style={{ display: 'flex', gap: '12px', alignItems: 'center' }}>\n      <span>{t('trend.title')}</span><span role=\"status\">{t(trendJobs ? state : 'trend.unavailable')}</span>\n      <button type=\"button\" style={{ color: 'var(--dsw-alias-label-primary)', background: 'transparent', border: '1px solid var(--dsw-alias-border-l3)', borderRadius: '6px', font: 'inherit', padding: '4px 10px' }} disabled={!trendJobs || stopping || ['trend.completed', 'trend.stopped', 'trend.failed'].includes(state)} onClick={() => { void stop() }}>{t('trend.stop')}</button>\n    </div>\n    <p>{t('trend.interval')}: {receipt.interval} ms · {t('trend.samples')}: {points.length}</p>\n    {points.length > 1 && <p>{t('trend.actualInterval')}: {((points.at(-1)!.elapsed - points[0]!.elapsed) / (points.length - 1)).toFixed(1)} ms · {t('trend.overruns')}: {points.filter(point => point.overrun === true).length}</p>}\n    {tags.map(tag => {\n      const plot = trendSegments(points, tag)\n      const latest = points.at(-1)?.values.find(value => value.tag === tag)\n      return <figure key={tag} style={{ margin: '12px 0' }}><figcaption>{tag} · {latest?.quality === 'good' ? String(latest.value) : t('trend.badValue')} · {plot.min}–{plot.max}</figcaption>\n        <svg viewBox=\"0 0 600 110\" role=\"img\" aria-label={tag} style={{ width: '100%', height: '110px' }}>\n          {plot.segments.map((segment, index) => <polyline key={index} points={segment} fill=\"none\" stroke=\"currentColor\" strokeWidth=\"1.5\" />)}\n        </svg>\n        <small>{((points[0]?.elapsed ?? 0) / 1000).toFixed(2)}–{((points.at(-1)?.elapsed ?? 0) / 1000).toFixed(2)} s</small>\n      </figure>\n    })}\n    <small>{t('trend.source')}: {receipt.sourceHash.slice(0, 12)} · {t('trend.limitation')}</small>\n  </section>\n}\n","/** Inline PLC trend tool view; data and cancellation use the existing job Remote. */\nimport type { ClientScope } from './types.ts'\nimport { en, NS, zh } from './locales.ts'\nimport { TrendCard } from './TrendCard.tsx'\n\n/** Required client services; job availability is explained inside the card. */\nexport const inject = ['slots', 'locale', 'remote']\n\n/** Register the live trend card without a Studio launcher sidebar. @param ctx - Browser service context. */\nexport function apply(ctx: ClientScope): void {\n  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'l5x-live: trend copy')\n  ctx.slots.inject('tool.call.toolview', () => ctx.slots.register({\n    name: 'tool.call.toolview', key: 'start_plc_trend', locale: NS,\n    inject: () => ({ trendJobs: ctx.remote.job }),\n  }, TrendCard))\n}\n"],"mappings":"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"}

package/vendor/l5x/lib/core/errors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Failures the model can repair from.
+ *
+ * Every expected failure carries the next call, because a refused tool call is
+ * a turn the reader has to spend. An unexpected failure is a plugin defect and
+ * says so instead of pretending to be a project problem.
+ *
+ * @module dsh-engineering-l5x/core/errors
+ */
+/** One expected failure, with everything the reader needs to recover. */
+export declare class L5xError extends Error {
+    readonly code: string;
+    readonly fix: string;
+    readonly candidates: readonly string[];
+    /**
+     * @param code - Stable identifier for tests and logs.
+     * @param message - What failed, in the reader's terms.
+     * @param fix - The exact next call or check.
+     * @param candidates - Valid names when the request named something absent or ambiguous.
+     */
+    constructor(code: string, message: string, fix: string, candidates?: readonly string[]);
+}
+/** The model-facing failure document. */
+export interface ErrorEnvelope {
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+        readonly fix: string;
+        readonly candidates: readonly string[];
+    };
+}
+/**
+ * Convert a thrown value into the failure document.
+ *
+ * @param error - Whatever the tool body threw.
+ * @returns The failure document; never throws.
+ */
+export declare function errorEnvelope(error: unknown): ErrorEnvelope;

package/vendor/l5x/lib/core/errors.js

@@ -0,0 +1,48 @@
+/**
+ * Failures the model can repair from.
+ *
+ * Every expected failure carries the next call, because a refused tool call is
+ * a turn the reader has to spend. An unexpected failure is a plugin defect and
+ * says so instead of pretending to be a project problem.
+ *
+ * @module dsh-engineering-l5x/core/errors
+ */
+/** One expected failure, with everything the reader needs to recover. */
+export class L5xError extends Error {
+    code;
+    fix;
+    candidates;
+    /**
+     * @param code - Stable identifier for tests and logs.
+     * @param message - What failed, in the reader's terms.
+     * @param fix - The exact next call or check.
+     * @param candidates - Valid names when the request named something absent or ambiguous.
+     */
+    constructor(code, message, fix, candidates = []) {
+        super(message);
+        this.code = code;
+        this.fix = fix;
+        this.candidates = candidates;
+        this.name = 'L5xError';
+    }
+}
+/**
+ * Convert a thrown value into the failure document.
+ *
+ * @param error - Whatever the tool body threw.
+ * @returns The failure document; never throws.
+ */
+export function errorEnvelope(error) {
+    if (error instanceof L5xError) {
+        return { error: { code: error.code, message: error.message, fix: error.fix, candidates: error.candidates } };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        error: {
+            code: 'INTERNAL',
+            message,
+            fix: 'This is a plugin defect, not a project condition. Report it with the arguments used, then reopen the project.',
+            candidates: [],
+        },
+    };
+}