@aryacode/dsh-engineering 0.0.0-stage → 0.3.0

package/vendor/l5x/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: rockwell-l5x
+description: Read and review Studio 5000 L5X exports: open a project, list and read components, find references, trace dependencies, resolve addresses, map bit usage, run checks, and compare exports.
+whenToUse: Use when the user asks about a Studio 5000 L5X export, Logix tags, routines, UDTs, AOIs, I/O modules, references, dependency tracing, checks, or comparison between exports.
+---
+
+# Rockwell L5X engineering
+
+## Boundary
+
+This surface reads and drafts. A draft writes only a new L5X file: it never overwrites the source, imports into Studio, connects to a controller, changes mode, or writes runtime data.
+
+## Start
+
+1. Call `open_project` with the export path. Keep the returned `project_id`.
+2. Later calls may omit `project_id` when exactly one project is open; pass it when several are.
+3. A read refuses a changed export with `STALE_EXPORT`; call `open_project` again before continuing.
+
+## Find the thing
+
+- `list_components` enumerates one kind: program, task, tag, udt, routine, aoi, module, alarm. Filter by name, page with offset and limit.
+- `get_component` reads one in full by exact name. Pass `scope` for a program-scoped tag or routine.
+- `search_logic` finds literal text in rungs, ST lines and diagram labels.
+- `find_references` answers where a symbol is read or written. Use `detail: "evidence"` for rung or line rows with access type and context.
+- `trace_dependencies` follows upstream or downstream operands. It is static evidence, not runtime causality.
+- `resolve_tag` resolves an alias chain, member, integer bit or array subscript.
+- `usage_map` reports which array elements and bits a tag uses and which remain free.
+
+## Scope rules
+
+- Program-scoped tags and routines need `scope` set to the program name.
+- AOI members are written `AOI_Name::Member`, for example `AOI_EncoderScale::Out_FPM`. `find_references` accepts that spelling; `trace_dependencies` splits it and resolves the member against the AOI.
+- An unresolved symbol is refused with `UNRESOLVED_SYMBOL` and candidate scope names. Do not guess past it; fix the scope or the spelling.
+
+## Checks and comparison
+
+- `run_checks` returns findings with a rule and severity. Filter with `severity` or `rule`, page with offset and limit. Findings are candidates for engineering review, never proof of a defect or of safety.
+- `compare_projects` diffs two open exports by component. Export timestamps and XML formatting are ignored by design.
+
+## Live reads
+
+The `l5x-live` entry reads declared scalar tags straight from a controller over EtherNet/IP, without Studio 5000, FactoryTalk Linx or the SDK. It may be disabled; if `poll_live_tags` is unavailable, say live reads are not enabled rather than trying another tool.
+
+- `poll_live_tags` takes an explicit IPv4 address, a CPU slot and 1 to 16 declared scalar tags (`BOOL`, `INT`, `DINT`, `REAL`), and returns timestamped sweeps, quality and the controller identity.
+- `start_plc_trend` samples the same way as a session-owned job the chart can follow; stop it through the job controls.
+- These are read-only. Never write controller data, force tags, toggle bits or edit online.
+- Report `live_logic_matches_export: "unverified"`: the read proves a value at a moment, not that the controller runs the exported logic, and sequential reads can miss transitions.
+
+## Reporting
+
+- Every result carries `summary`, `data`, `coverage` and `next`. Read `coverage` before claiming the answer is complete.
+- State what the export cannot prove: FBD and SFC execution semantics, dynamic indices, runtime behavior, external HMI and driver consumers, and whether online logic matches the export.
+- Quote the program, routine and rung or ST line for each finding.
+- Do not call a tag unused, or an output permanently zero, from the absence of references alone. External consumers are invisible here.
+
+## Revisions
+
+- Reading accepts any export revision 19 or later. Revisions outside the observed matrix open and report `verification: "untested_revision"`.
+- Reading never needs Studio 5000. The studio entry adds offline import and build, and its controller
+  tools handle upload, mode change and download under per-call approval.
+
+## Studio
+
+The `l5x-studio` entry adds offline SDK work; it may be disabled. Call `studio_sdk_status` before using it.
+
+- `export_acd_to_l5x` writes one new full L5X from an ACD. No controller contact.
+- `verify_offline_l5x` imports a full L5X into a new offline ACD and builds it. Build needs project revision 37 or later; `probe: true` attempts a lower revision and reports the SDK error. A Studio-exported L5X builds; an L5X produced by `export_acd_to_l5x` may be refused by the SDK as "no changes".
+- `build_acd_from_draft` imports one changed RLL or ST routine into a new ACD copy, builds it and exports it. The baseline must be an L5X exported from that ACD in this chat, and neither file may change afterwards.
+- `studio_review_evidence` checks program, routine and rung or line names and verbatim quotes before you report findings.
+- `controller_approval_status` reports whether this session can ask a human. `capture_controller_snapshot`, `change_controller_mode` and `download_project` each require per-call human approval of the exact controller, route and target, and proceed only on `allowed-once`; `download_project` accepts only a `verification_id` from a passed build in this chat.
+- `go_online`, `read_controller_mode` and `read_live_tag` are read-only and need no approval. Never write controller data, force tags, toggle bits or edit online.
+
+## Editing
+
+Editing uses the `draft_*` family. It may be disabled in this profile; if a draft tool is unavailable, say editing is not enabled here rather than trying another tool.
+
+- One operation per call: `draft_rung`, `draft_st`, `draft_routine`, `draft_tag`, `draft_tag_description`, `draft_udt_member`, `draft_udt_description`. Each returns the draft id and the operation count.
+- `draft_validate` prepares the accumulated draft against the project and returns its hash, diff summary and check findings. Read the findings before applying.
+- `draft_apply` writes the draft to ONE new `.L5X` path. It never overwrites an existing file.
+- After applying, reopen the written file with `open_project` to review it.
+- Drafts belong to this chat. Another chat starts with none, and an applied draft is cleared.

package/vendor/l5x/lib/approvals.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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 type { ExecContext, PluginContext } from './core/tool.ts';
+/** The approval service the composition may provide. */
+export interface ApprovalService {
+    request?(request: {
+        readonly agent: unknown;
+        readonly toolName: string;
+        readonly callId: unknown;
+        readonly reason: string;
+        readonly signal?: AbortSignal;
+    }): Promise<string>;
+    overrideOf?(session: unknown): 'ask' | 'never' | undefined;
+    readonly config?: {
+        readonly policy?: 'ask' | 'never';
+    };
+}
+/**
+ * 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 declare function approvalStatus(ctx: PluginContext, exec?: ExecContext): Record<string, unknown>;
+/**
+ * Refuse when approval cannot be requested at all.
+ *
+ * @param ctx - Plugin context.
+ * @param exec - Calling context.
+ */
+export declare function ensureApprovalReady(ctx: PluginContext, exec?: ExecContext): void;
+/**
+ * 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 declare function requireHumanApproval(ctx: PluginContext, exec: ExecContext | undefined, toolName: string, reason: string): Promise<void>;

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