@aryacode/dsh-engineering 0.0.0-stage → 0.3.0

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: [],
+        },
+    };
+}

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

@@ -0,0 +1,49 @@
+/**
+ * Parameter schemas that always describe themselves.
+ *
+ * The port's first measured failure was 132 parameters with no description.
+ * These helpers make an undescribed parameter impossible to write: the
+ * description is a required argument, not an optional field.
+ *
+ * @module dsh-engineering-l5x/core/params
+ */
+/** One JSON Schema property, with the description that is mandatory here. */
+export interface ParameterSchema {
+    readonly type: 'string' | 'integer' | 'number' | 'boolean' | 'array' | 'object';
+    readonly description: string;
+    readonly enum?: readonly string[];
+    readonly items?: ParameterSchema;
+    readonly default?: unknown;
+    readonly minimum?: number;
+    readonly maximum?: number;
+    readonly minItems?: number;
+    readonly maxItems?: number;
+    readonly properties?: Readonly<Record<string, ParameterSchema>>;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: boolean;
+}
+/** A string parameter. */
+export declare function string(description: string, extra?: Partial<ParameterSchema>): ParameterSchema;
+/** An integer parameter with an optional range. */
+export declare function integer(description: string, extra?: Partial<ParameterSchema>): ParameterSchema;
+/** A string parameter restricted to a known set. */
+export declare function choice(description: string, values: readonly string[], extra?: Partial<ParameterSchema>): ParameterSchema;
+/** An array of one parameter type. */
+export declare function list(description: string, items: ParameterSchema, extra?: Partial<ParameterSchema>): ParameterSchema;
+/** One object element of an array parameter. */
+export declare function objectItem(description: string, properties: Readonly<Record<string, ParameterSchema>>, required?: readonly string[]): ParameterSchema;
+/** The `parameters` object of one tool. */
+export interface Parameters {
+    readonly type: 'object';
+    readonly properties: Readonly<Record<string, ParameterSchema>>;
+    readonly required: readonly string[];
+    readonly additionalProperties: false;
+}
+/**
+ * Build a tool's parameter object.
+ *
+ * @param properties - Named parameters, every one already described.
+ * @param required - Names the caller must supply.
+ * @returns The schema object a tool definition declares.
+ */
+export declare function object(properties: Readonly<Record<string, ParameterSchema>>, required?: readonly string[]): Parameters;

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

@@ -0,0 +1,39 @@
+/**
+ * Parameter schemas that always describe themselves.
+ *
+ * The port's first measured failure was 132 parameters with no description.
+ * These helpers make an undescribed parameter impossible to write: the
+ * description is a required argument, not an optional field.
+ *
+ * @module dsh-engineering-l5x/core/params
+ */
+/** A string parameter. */
+export function string(description, extra = {}) {
+    return { type: 'string', description, ...extra };
+}
+/** An integer parameter with an optional range. */
+export function integer(description, extra = {}) {
+    return { type: 'integer', description, ...extra };
+}
+/** A string parameter restricted to a known set. */
+export function choice(description, values, extra = {}) {
+    return { type: 'string', description, enum: values, ...extra };
+}
+/** An array of one parameter type. */
+export function list(description, items, extra = {}) {
+    return { type: 'array', description, items, ...extra };
+}
+/** One object element of an array parameter. */
+export function objectItem(description, properties, required = []) {
+    return { type: 'object', description, properties, required, additionalProperties: false };
+}
+/**
+ * Build a tool's parameter object.
+ *
+ * @param properties - Named parameters, every one already described.
+ * @param required - Names the caller must supply.
+ * @returns The schema object a tool definition declares.
+ */
+export function object(properties, required = []) {
+    return { type: 'object', properties, required, additionalProperties: false };
+}

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

@@ -0,0 +1,46 @@
+/**
+ * The model-facing success document.
+ *
+ * Every read answers with a summary first and concrete next calls last. The
+ * summary lets a small model decide whether it got what it asked for without
+ * reading the whole payload; `next` is the recovery path when its plan is thin.
+ *
+ * @module dsh-engineering-l5x/core/result
+ */
+/** One call the reader can make next, with the reason it is useful. */
+export interface NextStep {
+    /** Tool name registered by this plugin. */
+    readonly tool: string;
+    /** Why this call answers the current question. */
+    readonly why: string;
+    /** Arguments worth passing; omitted when the tool needs none. */
+    readonly args?: Readonly<Record<string, unknown>>;
+}
+/** How much of the requested question the answer actually covers. */
+export interface Coverage {
+    /** Whether the requested scope was answered in full. */
+    readonly complete: boolean;
+    /** What this answer cannot establish, named rather than implied. */
+    readonly unverified: readonly string[];
+}
+/** A successful tool answer. */
+export interface Success<T> {
+    /** One sentence the reader can act on. */
+    readonly summary: string;
+    /** Tool-specific payload. */
+    readonly data: T;
+    /** Present when the answer has limits worth stating. */
+    readonly coverage?: Coverage;
+    /** Concrete next calls, most useful first. */
+    readonly next: readonly NextStep[];
+}
+/**
+ * Build a success document.
+ *
+ * @param summary - One sentence naming what was read.
+ * @param data - Tool-specific payload.
+ * @param next - Concrete next calls; may be empty when the answer is terminal.
+ * @param coverage - Limits of the answer, when it has any.
+ * @returns The document the tool returns.
+ */
+export declare function success<T>(summary: string, data: T, next?: readonly NextStep[], coverage?: Coverage): Success<T>;

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

@@ -0,0 +1,21 @@
+/**
+ * The model-facing success document.
+ *
+ * Every read answers with a summary first and concrete next calls last. The
+ * summary lets a small model decide whether it got what it asked for without
+ * reading the whole payload; `next` is the recovery path when its plan is thin.
+ *
+ * @module dsh-engineering-l5x/core/result
+ */
+/**
+ * Build a success document.
+ *
+ * @param summary - One sentence naming what was read.
+ * @param data - Tool-specific payload.
+ * @param next - Concrete next calls; may be empty when the answer is terminal.
+ * @param coverage - Limits of the answer, when it has any.
+ * @returns The document the tool returns.
+ */
+export function success(summary, data, next = [], coverage) {
+    return coverage === undefined ? { summary, data, next } : { summary, data, coverage, next };
+}

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

@@ -0,0 +1,102 @@
+/**
+ * The tool and service surfaces this package registers against.
+ *
+ * Declared locally, and structurally, so the package compiles without the host
+ * packages at build time while still matching what the Cordis registry and the
+ * filesystem provider expose at runtime.
+ *
+ * @module dsh-engineering-l5x/core/tool
+ */
+import type { Parameters } from './params.ts';
+/** One content block the registry renders for the model. */
+export interface TextBlock {
+    readonly type: 'text';
+    readonly text: string;
+}
+/** The canonical output declaration every tool must carry. */
+export interface ToolOutput {
+    readonly schema: {
+        readonly type: 'object';
+        readonly additionalProperties: boolean;
+    };
+    render(args: unknown, value: unknown): readonly TextBlock[];
+}
+/** The execution context a tool receives from the registry. */
+export interface ToolExec {
+    readonly signal?: AbortSignal;
+    readonly callId?: unknown;
+    readonly sessionId?: string;
+    readonly agent?: {
+        readonly session?: {
+            readonly header?: {
+                readonly cwd?: string;
+            };
+        };
+    };
+}
+/** The context a tool body receives: cancellation, workspace, chat identity and approval fields. */
+export interface ExecContext {
+    readonly signal?: AbortSignal;
+    readonly cwd?: string;
+    /** The calling chat; handles are scoped to it. */
+    readonly chat?: object;
+    /** Registry call id, forwarded to the approval request. */
+    readonly callId?: unknown;
+    /** Owning session id, used by session-owned jobs. */
+    readonly sessionId?: string;
+    /** The calling agent, forwarded to the approval request. */
+    readonly agent?: unknown;
+}
+/** A registered tool. */
+export interface ToolDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: Parameters;
+    readonly output: ToolOutput;
+    execute(args: Readonly<Record<string, unknown>>, exec: ToolExec): Promise<unknown>;
+}
+/** The registry service. */
+export interface ToolRegistry {
+    register(definition: ToolDefinition): unknown;
+}
+/** A path resolved by the filesystem provider into its backend identity. */
+export interface FsTarget {
+    /** Opaque key for stale guards and target lookup. */
+    readonly targetKey: unknown;
+    /** Path for model- and UI-facing output. */
+    readonly displayPath: string;
+}
+/** The filesystem service operations this package uses. */
+export interface FsService {
+    resolve(path: string, options?: {
+        readonly signal?: AbortSignal;
+        readonly cwd?: string;
+    }): Promise<FsTarget>;
+    stat(target: FsTarget, signal?: AbortSignal): Promise<{
+        readonly type: string;
+    } | undefined>;
+    readBytes(target: FsTarget, signal: AbortSignal | undefined, maxBytes?: number): Promise<Uint8Array>;
+    writeText?(target: FsTarget, text: string, options?: {
+        readonly kind?: 'createIfAbsent';
+    }, signal?: AbortSignal): Promise<void>;
+}
+/** The services a composition must provide before this plugin loads. */
+export interface PluginContext {
+    readonly tools: ToolRegistry;
+    readonly fs: FsService;
+    readonly logger?: {
+        warn(message: string): void;
+    };
+    /** Register a service other entries in the same composition can consume. */
+    provide?(name: string, value: unknown): void;
+    /** Read a service another entry in the same composition provided. */
+    get?(name: string): unknown;
+}
+/**
+ * Render one tool answer as pretty JSON.
+ *
+ * @param _args - Accepted arguments; unused by this renderer.
+ * @param value - The validated canonical value.
+ * @returns One text block.
+ */
+export declare function jsonText(_args: unknown, value: unknown): readonly TextBlock[];

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

@@ -0,0 +1,19 @@
+/**
+ * The tool and service surfaces this package registers against.
+ *
+ * Declared locally, and structurally, so the package compiles without the host
+ * packages at build time while still matching what the Cordis registry and the
+ * filesystem provider expose at runtime.
+ *
+ * @module dsh-engineering-l5x/core/tool
+ */
+/**
+ * Render one tool answer as pretty JSON.
+ *
+ * @param _args - Accepted arguments; unused by this renderer.
+ * @param value - The validated canonical value.
+ * @returns One text block.
+ */
+export function jsonText(_args, value) {
+    return [{ type: 'text', text: JSON.stringify(value, undefined, 2) }];
+}

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

@@ -0,0 +1,66 @@
+/**
+ * Drafts: one accumulated edit list per project per chat.
+ *
+ * The model adds one operation at a time, sees the count grow, then validates
+ * and applies. Nothing here writes a file; preparation and application belong
+ * to the tools, so an abandoned draft leaves no residue.
+ *
+ * @module dsh-engineering-l5x/drafts
+ */
+import type { ExecContext } from './core/tool.ts';
+/** One version-1 change-set operation, as the engine accepts it. */
+export interface DraftOperation {
+    readonly operation: string;
+    readonly [field: string]: unknown;
+}
+/** One accumulated draft. */
+export interface Draft {
+    /** Stable handle returned to the caller. */
+    readonly id: string;
+    /** Project handle this draft applies to. */
+    readonly projectId: string;
+    /** Operations in the order they were added. */
+    readonly operations: readonly DraftOperation[];
+    /** ISO timestamp of the first operation. */
+    readonly createdAt: string;
+}
+/** Drafts, scoped to the chat that created them. */
+export declare class DraftStore {
+    private readonly chats;
+    private readonly detached;
+    /**
+     * The draft for one project in this chat, created on first use.
+     *
+     * @param exec - Calling context; its chat selects the draft set.
+     * @param projectId - Project handle the draft edits.
+     * @returns The accumulated draft.
+     */
+    forProject(exec: ExecContext | undefined, projectId: string): Draft;
+    /**
+     * Append one operation to a project's draft.
+     *
+     * @param exec - Calling context.
+     * @param projectId - Project handle the draft edits.
+     * @param operation - Operation to append.
+     * @param maxOperations - Inclusive operation cap for one draft.
+     * @returns The updated draft.
+     */
+    append(exec: ExecContext | undefined, projectId: string, operation: DraftOperation, maxOperations: number): Draft;
+    /**
+     * Resolve one draft by handle.
+     *
+     * @param exec - Calling context.
+     * @param id - Draft handle; empty selects the chat's only draft.
+     * @returns The draft.
+     */
+    get(exec: ExecContext | undefined, id: string | undefined): Draft;
+    /**
+     * Remove one draft after it is applied.
+     *
+     * @param exec - Calling context.
+     * @param id - Draft handle.
+     */
+    remove(exec: ExecContext | undefined, id: string): void;
+    /** The draft map for one calling chat. */
+    private chatsOf;
+}

package/vendor/l5x/lib/drafts.js

@@ -0,0 +1,98 @@
+/**
+ * Drafts: one accumulated edit list per project per chat.
+ *
+ * The model adds one operation at a time, sees the count grow, then validates
+ * and applies. Nothing here writes a file; preparation and application belong
+ * to the tools, so an abandoned draft leaves no residue.
+ *
+ * @module dsh-engineering-l5x/drafts
+ */
+import { randomUUID } from 'node:crypto';
+import { L5xError } from "./core/errors.js";
+/** Drafts, scoped to the chat that created them. */
+export class DraftStore {
+    chats = new WeakMap();
+    detached = new Map();
+    /**
+     * The draft for one project in this chat, created on first use.
+     *
+     * @param exec - Calling context; its chat selects the draft set.
+     * @param projectId - Project handle the draft edits.
+     * @returns The accumulated draft.
+     */
+    forProject(exec, projectId) {
+        const drafts = this.chatsOf(exec);
+        for (const draft of drafts.values()) {
+            if (draft.projectId === projectId)
+                return draft;
+        }
+        const created = { id: randomUUID(), projectId, operations: [], createdAt: new Date().toISOString() };
+        drafts.set(created.id, created);
+        return created;
+    }
+    /**
+     * Append one operation to a project's draft.
+     *
+     * @param exec - Calling context.
+     * @param projectId - Project handle the draft edits.
+     * @param operation - Operation to append.
+     * @param maxOperations - Inclusive operation cap for one draft.
+     * @returns The updated draft.
+     */
+    append(exec, projectId, operation, maxOperations) {
+        const current = this.forProject(exec, projectId);
+        if (current.operations.length >= maxOperations) {
+            throw new L5xError('DRAFT_TOO_LARGE', `This draft already holds ${current.operations.length} operations, the configured maximum.`, 'Validate and apply this draft, then start another for the remaining edits.');
+        }
+        const updated = { ...current, operations: [...current.operations, operation] };
+        this.chatsOf(exec).set(updated.id, updated);
+        return updated;
+    }
+    /**
+     * Resolve one draft by handle.
+     *
+     * @param exec - Calling context.
+     * @param id - Draft handle; empty selects the chat's only draft.
+     * @returns The draft.
+     */
+    get(exec, id) {
+        const drafts = this.chatsOf(exec);
+        const ids = [...drafts.keys()];
+        if (id === undefined || id === '') {
+            const only = ids[0];
+            if (only === undefined) {
+                throw new L5xError('NO_DRAFT', 'No draft exists in this chat.', 'Add an operation with a draft_* tool first.');
+            }
+            if (ids.length > 1) {
+                throw new L5xError('AMBIGUOUS_DRAFT', `${ids.length} drafts exist in this chat, so draft_id is required.`, `Pass one of: ${ids.join(', ')}.`, ids);
+            }
+            return drafts.get(only);
+        }
+        const draft = drafts.get(id);
+        if (draft === undefined) {
+            throw new L5xError('UNKNOWN_DRAFT', `No draft exists with draft_id ${JSON.stringify(id)} in this chat.`, ids.length === 0 ? 'Add an operation with a draft_* tool first.' : `Pass one of this chat's draft ids: ${ids.join(', ')}.`, ids);
+        }
+        return draft;
+    }
+    /**
+     * Remove one draft after it is applied.
+     *
+     * @param exec - Calling context.
+     * @param id - Draft handle.
+     */
+    remove(exec, id) {
+        this.chatsOf(exec).delete(id);
+    }
+    /** The draft map for one calling chat. */
+    chatsOf(exec) {
+        const chat = exec?.chat;
+        if (chat === undefined)
+            return this.detached;
+        const existing = this.chats.get(chat);
+        if (existing !== undefined)
+            return existing;
+        const created = new Map();
+        this.chats.set(chat, created);
+        return created;
+    }
+}

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

@@ -0,0 +1,30 @@
+/**
+ * The L5X editing entry: drafts over the read entry's project handles.
+ *
+ * Kept separate so a profile that only reads, checks and compares does not pay
+ * for nine draft schemas. It consumes the `l5xProjects` service the read entry
+ * provides, so a project is opened once and both entries see the same handle.
+ *
+ * @module dsh-engineering-l5x/editing
+ */
+import type { PluginContext } from './core/tool.ts';
+/** Plugin name in a composition. */
+export declare const name = "l5x-editing";
+/** The read entry's project service must already be mounted. */
+export declare const inject: readonly ["tools", "l5xProjects"];
+/** Configuration for the editing entry. */
+export interface Config {
+    /** Largest export, in bytes, one preparation may read. Defaults to 64 MiB. */
+    maxFileBytes?: number;
+    /** Most operations one draft may accumulate. Defaults to 200. */
+    maxDraftOperations?: number;
+}
+/**
+ * Register the draft tools.
+ *
+ * @param ctx - Plugin context carrying the read entry's project service.
+ * @param config - Deployment limits.
+ */
+export declare function apply(ctx: PluginContext, config?: Config): void;
+export { DraftStore } from './drafts.ts';
+export { draftTools } from './tools/drafts.ts';