@flanksource/clicky-ui 0.3.35 → 0.3.37

package/dist/data/task-copy.js

@@ -1,3 +1,7 @@
+import { shellCommandLine } from "../lib/shell-command.js";
+import { stripTrailingNewlines } from "../lib/string.js";
+import { isTaskExecDetails } from "./task-exec-details.js";
+import { isTaskProcessDetails } from "./task-process-details.js";
 import { bucketTasks } from "./task-status.js";
 function isFailedOrWarn(t) {
   return t.status === "failed" || t.status === "FAIL" || t.status === "ERR" || t.status === "warning";
@@ -9,11 +13,22 @@ function taskGroupErrorCount(tasks) {
   return tasks.filter(isErrored).length;
 }
 function fence(label, body, language = "") {
-  return [`${label}:`, "```" + language, body.replace(/\n+$/, ""), "```"];
+  return [`${label}:`, "```" + language, stripTrailingNewlines(body), "```"];
 }
 function streamBlock(label, text, truncated) {
   return fence(truncated ? `${label} (showing latest 1 MiB)` : label, text);
 }
+function execCommandSection({ command, args, cwd, ...rest }) {
+  const lines = fence(
+    "command",
+    shellCommandLine({ command, ...args ? { args } : {}, ...cwd ? { cwd } : {} }),
+    "sh"
+  );
+  if (Object.keys(rest).length > 0) {
+    lines.push(...fence("details", JSON.stringify(rest, null, 2), "json"));
+  }
+  return lines;
+}
 function taskSection(t) {
   const lines = [`## ${t.name} — ${t.status}${t.duration ? ` (${t.duration})` : ""}`];
   if (t.description) lines.push(t.description);
@@ -26,7 +41,9 @@ function taskSection(t) {
   }
   if (t.stdout) lines.push(...streamBlock("stdout", t.stdout, t.stdoutTruncated));
   if (t.stderr) lines.push(...streamBlock("stderr", t.stderr, t.stderrTruncated));
-  if (t.details !== void 0) {
+  if (isTaskExecDetails(t.details) || isTaskProcessDetails(t.details)) {
+    lines.push(...execCommandSection({ ...t.details }));
+  } else if (t.details !== void 0) {
     lines.push(...fence("details", JSON.stringify(t.details, null, 2), "json"));
   }
   return lines;

package/dist/data/task-copy.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-copy.js","sources":["../../src/data/task-copy.ts"],"sourcesContent":["import type { TaskSnapshot } from \"./TaskSnapshot\";\nimport { bucketTasks } from \"./task-status\";\n\n// Builders that flatten a task run into pasteable text. Deliberately free of\n// React and of the clipboard so the exact output is unit-testable, and so the\n// rendered card and the copied text cannot drift apart.\n\n// isFailedOrWarn marks the statuses TaskGroupCard always keeps visible. Also\n// drives \"copy errors only\", so the two can never disagree.\nexport function isFailedOrWarn(t: TaskSnapshot): boolean {\n  return (\n    t.status === \"failed\" || t.status === \"FAIL\" || t.status === \"ERR\" || t.status === \"warning\"\n  );\n}\n\n// A task counts as errored for copy purposes when it either rests in a failing\n// status or carries an error string (a canceled dependency does the latter).\nfunction isErrored(t: TaskSnapshot): boolean {\n  return isFailedOrWarn(t) || Boolean(t.error);\n}\n\nexport function taskGroupErrorCount(tasks: TaskSnapshot[]): number {\n  return tasks.filter(isErrored).length;\n}\n\nfunction fence(label: string, body: string, language = \"\"): string[] {\n  return [`${label}:`, \"```\" + language, body.replace(/\\n+$/, \"\"), \"```\"];\n}\n\nfunction streamBlock(label: string, text: string, truncated: boolean | undefined): string[] {\n  // Mirrors the \"showing latest 1 MiB\" note TaskStream renders.\n  return fence(truncated ? `${label} (showing latest 1 MiB)` : label, text);\n}\n\nfunction taskSection(t: TaskSnapshot): string[] {\n  const lines = [`## ${t.name} — ${t.status}${t.duration ? ` (${t.duration})` : \"\"}`];\n  if (t.description) lines.push(t.description);\n  if (t.error) lines.push(`error: ${t.error}`);\n  // `message` carries the latest log line; only worth repeating when it differs.\n  if (t.message && t.message !== t.error) lines.push(`message: ${t.message}`);\n  const logs = t.logs ?? [];\n  if (logs.length > 0) {\n    lines.push(\"logs:\");\n    for (const l of logs) lines.push(`  ${l.level} ${l.message}`);\n  }\n  if (t.stdout) lines.push(...streamBlock(\"stdout\", t.stdout, t.stdoutTruncated));\n  if (t.stderr) lines.push(...streamBlock(\"stderr\", t.stderr, t.stderrTruncated));\n  // `details` is an open shape (TaskExecDetails carries arbitrary domain keys),\n  // so serialize it whole rather than narrowing to a known variant.\n  if (t.details !== undefined) {\n    lines.push(...fence(\"details\", JSON.stringify(t.details, null, 2), \"json\"));\n  }\n  return lines;\n}\n\nfunction groupHeader(group: TaskSnapshot, tasks: TaskSnapshot[]): string[] {\n  const counts = bucketTasks(tasks);\n  const total = group.total ?? tasks.length;\n  const summary = [`status: ${group.status}`];\n  if (total > 0) summary.push(`${counts.ok + counts.warn + counts.fail + counts.canceled}/${total}`);\n  if (group.kind) summary.push(`kind: ${group.kind}`);\n\n  const lines = [`# ${group.name}`, summary.join(\" · \")];\n  const labels = Object.entries(group.labels ?? {});\n  if (labels.length > 0) {\n    lines.push(`labels: ${labels.map(([k, v]) => `${k}=${v}`).join(\", \")}`);\n  }\n  const timing: string[] = [];\n  if (group.startedAt) timing.push(`started ${group.startedAt}`);\n  if (group.finishedAt) timing.push(`finished ${group.finishedAt}`);\n  if (timing.length > 0) lines.push(timing.join(\" · \"));\n  if (group.error) lines.push(`error: ${group.error}`);\n  return lines;\n}\n\nfunction joinBlocks(blocks: string[][]): string {\n  return `${blocks.map((block) => block.join(\"\\n\")).join(\"\\n\\n\")}\\n`;\n}\n\n/** The whole run — group context followed by every task, with logs, streams and details. */\nexport function taskGroupMarkdown(group: TaskSnapshot, tasks: TaskSnapshot[]): string {\n  return joinBlocks([groupHeader(group, tasks), ...tasks.map(taskSection)]);\n}\n\n/** Group context followed by only the failing/warning tasks. */\nexport function taskGroupErrors(group: TaskSnapshot, tasks: TaskSnapshot[]): string {\n  return joinBlocks([groupHeader(group, tasks), ...tasks.filter(isErrored).map(taskSection)]);\n}\n\n/** The raw snapshots, for feeding a tool rather than a human. */\nexport function taskGroupJson(group: TaskSnapshot, tasks: TaskSnapshot[]): string {\n  return JSON.stringify({ group, tasks }, null, 2);\n}\n\n/** A single task, for the per-row copy affordance. */\nexport function taskMarkdown(task: TaskSnapshot): string {\n  return joinBlocks([taskSection(task)]);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-copy.js","sources":["../../src/data/task-copy.ts"],"sourcesContent":["import { shellCommandLine } from \"../lib/shell-command\";\nimport { stripTrailingNewlines } from \"../lib/string\";\nimport { isTaskExecDetails } from \"./task-exec-details\";\nimport { isTaskProcessDetails } from \"./task-process-details\";\nimport type { TaskSnapshot } from \"./TaskSnapshot\";\nimport { bucketTasks } from \"./task-status\";\n\n// Builders that flatten a task run into pasteable text. Deliberately free of\n// React and of the clipboard so the exact output is unit-testable, and so the\n// rendered card and the copied text cannot drift apart.\n\n// isFailedOrWarn marks the statuses TaskGroupCard always keeps visible. Also\n// drives \"copy errors only\", so the two can never disagree.\nexport function isFailedOrWarn(t: TaskSnapshot): boolean {\n  return (\n    t.status === \"failed\" || t.status === \"FAIL\" || t.status === \"ERR\" || t.status === \"warning\"\n  );\n}\n\n// A task counts as errored for copy purposes when it either rests in a failing\n// status or carries an error string (a canceled dependency does the latter).\nfunction isErrored(t: TaskSnapshot): boolean {\n  return isFailedOrWarn(t) || Boolean(t.error);\n}\n\nexport function taskGroupErrorCount(tasks: TaskSnapshot[]): number {\n  return tasks.filter(isErrored).length;\n}\n\nfunction fence(label: string, body: string, language = \"\"): string[] {\n  return [`${label}:`, \"```\" + language, stripTrailingNewlines(body), \"```\"];\n}\n\nfunction streamBlock(label: string, text: string, truncated: boolean | undefined): string[] {\n  // Mirrors the \"showing latest 1 MiB\" note TaskStream renders.\n  return fence(truncated ? `${label} (showing latest 1 MiB)` : label, text);\n}\n\n// The command gets a pasteable `sh` fence; remaining domain keys still fence as JSON.\nfunction execCommandSection({ command, args, cwd, ...rest }: {\n  command: string;\n  args?: string[];\n  cwd?: string;\n  [key: string]: unknown;\n}): string[] {\n  const lines = fence(\n    \"command\",\n    shellCommandLine({ command, ...(args ? { args } : {}), ...(cwd ? { cwd } : {}) }),\n    \"sh\",\n  );\n  if (Object.keys(rest).length > 0) {\n    lines.push(...fence(\"details\", JSON.stringify(rest, null, 2), \"json\"));\n  }\n  return lines;\n}\n\nfunction taskSection(t: TaskSnapshot): string[] {\n  const lines = [`## ${t.name} — ${t.status}${t.duration ? ` (${t.duration})` : \"\"}`];\n  if (t.description) lines.push(t.description);\n  if (t.error) lines.push(`error: ${t.error}`);\n  // `message` carries the latest log line; only worth repeating when it differs.\n  if (t.message && t.message !== t.error) lines.push(`message: ${t.message}`);\n  const logs = t.logs ?? [];\n  if (logs.length > 0) {\n    lines.push(\"logs:\");\n    for (const l of logs) lines.push(`  ${l.level} ${l.message}`);\n  }\n  if (t.stdout) lines.push(...streamBlock(\"stdout\", t.stdout, t.stdoutTruncated));\n  if (t.stderr) lines.push(...streamBlock(\"stderr\", t.stderr, t.stderrTruncated));\n  if (isTaskExecDetails(t.details) || isTaskProcessDetails(t.details)) {\n    lines.push(...execCommandSection({ ...t.details }));\n  } else if (t.details !== undefined) {\n    // `details` is otherwise an open shape (arbitrary domain keys), so\n    // serialize it whole rather than narrowing to a known variant.\n    lines.push(...fence(\"details\", JSON.stringify(t.details, null, 2), \"json\"));\n  }\n  return lines;\n}\n\nfunction groupHeader(group: TaskSnapshot, tasks: TaskSnapshot[]): string[] {\n  const counts = bucketTasks(tasks);\n  const total = group.total ?? tasks.length;\n  const summary = [`status: ${group.status}`];\n  if (total > 0) summary.push(`${counts.ok + counts.warn + counts.fail + counts.canceled}/${total}`);\n  if (group.kind) summary.push(`kind: ${group.kind}`);\n\n  const lines = [`# ${group.name}`, summary.join(\" · \")];\n  const labels = Object.entries(group.labels ?? {});\n  if (labels.length > 0) {\n    lines.push(`labels: ${labels.map(([k, v]) => `${k}=${v}`).join(\", \")}`);\n  }\n  const timing: string[] = [];\n  if (group.startedAt) timing.push(`started ${group.startedAt}`);\n  if (group.finishedAt) timing.push(`finished ${group.finishedAt}`);\n  if (timing.length > 0) lines.push(timing.join(\" · \"));\n  if (group.error) lines.push(`error: ${group.error}`);\n  return lines;\n}\n\nfunction joinBlocks(blocks: string[][]): string {\n  return `${blocks.map((block) => block.join(\"\\n\")).join(\"\\n\\n\")}\\n`;\n}\n\n/** The whole run — group context followed by every task, with logs, streams and details. */\nexport function taskGroupMarkdown(group: TaskSnapshot, tasks: TaskSnapshot[]): string {\n  return joinBlocks([groupHeader(group, tasks), ...tasks.map(taskSection)]);\n}\n\n/** Group context followed by only the failing/warning tasks. */\nexport function taskGroupErrors(group: TaskSnapshot, tasks: TaskSnapshot[]): string {\n  return joinBlocks([groupHeader(group, tasks), ...tasks.filter(isErrored).map(taskSection)]);\n}\n\n/** The raw snapshots, for feeding a tool rather than a human. */\nexport function taskGroupJson(group: TaskSnapshot, tasks: TaskSnapshot[]): string {\n  return JSON.stringify({ group, tasks }, null, 2);\n}\n\n/** A single task, for the per-row copy affordance. */\nexport function taskMarkdown(task: TaskSnapshot): string {\n  return joinBlocks([taskSection(task)]);\n}\n"],"names":[],"mappings":"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"}

package/dist/data/task-metadata.cjs

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const collections = require("../lib/collections.cjs");
+function isScalar(value) {
+  return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+function metadataEntries(value) {
+  if (!collections.isPlainObject(value)) return [];
+  const entries = [];
+  for (const [key, item] of Object.entries(value)) {
+    if (!isScalar(item) || item === "") continue;
+    entries.push({ key, value: item, text: String(item) });
+  }
+  return entries;
+}
+function isFlatMetadata(value) {
+  return collections.isPlainObject(value) && Object.values(value).every(isScalar);
+}
+const LINK_KEYS = /* @__PURE__ */ new Set(["href", "url", "link"]);
+const HAS_SCHEME = /^[a-z][a-z0-9+.-]*:/i;
+const NAVIGABLE_URL = /^https?:\/\//i;
+const OFF_SITE_PATH = /^\/[/\\]/;
+function withoutBlanks(text) {
+  let stripped = "";
+  for (const character of text) if (character > " ") stripped += character;
+  return stripped;
+}
+function isMetadataLink(key, text) {
+  if (!LINK_KEYS.has(key) && !text.startsWith("/") && !text.startsWith("https://")) return false;
+  const destination = withoutBlanks(text);
+  return HAS_SCHEME.test(destination) ? NAVIGABLE_URL.test(destination) : !OFF_SITE_PATH.test(destination);
+}
+exports.isFlatMetadata = isFlatMetadata;
+exports.isMetadataLink = isMetadataLink;
+exports.metadataEntries = metadataEntries;
+//# sourceMappingURL=task-metadata.cjs.map

package/dist/data/task-metadata.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-metadata.cjs","sources":["../../src/data/task-metadata.ts"],"sourcesContent":["/**\n * Task metadata is whatever JSON the producer chose to attach to a snapshot, so\n * rendering it starts with reading its shape rather than assuming one. The split\n * these helpers make is between values that read as a label — a state, a model,\n * a session id — and values that do not, because only the first kind can go in a\n * row of chips without turning into `[object Object]`.\n */\n\nimport { isPlainObject } from \"../lib/collections\";\n\n/** A metadata value that renders as one short piece of text. */\nexport type MetadataScalar = string | number | boolean;\n\nexport interface MetadataEntry {\n  key: string;\n  value: MetadataScalar;\n  /** The text to render, and to test for a link. */\n  text: string;\n}\n\nfunction isScalar(value: unknown): value is MetadataScalar {\n  return typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\";\n}\n\n/**\n * The scalar entries of a metadata object, in the producer's own key order.\n * Empty strings are dropped: a producer that reports a field it has no value for\n * yet is saying nothing, and a blank chip reads as a rendering fault.\n */\nexport function metadataEntries(value: unknown): MetadataEntry[] {\n  if (!isPlainObject(value)) return [];\n  const entries: MetadataEntry[] = [];\n  for (const [key, item] of Object.entries(value)) {\n    if (!isScalar(item) || item === \"\") continue;\n    entries.push({ key, value: item, text: String(item) });\n  }\n  return entries;\n}\n\n/**\n * True when every value in the object is a scalar — the case a chip row or a\n * definition list can render completely, with nothing left over to fall back to\n * a JSON view for.\n */\nexport function isFlatMetadata(value: unknown): boolean {\n  return isPlainObject(value) && Object.values(value).every(isScalar);\n}\n\n/** Keys whose value is meant as a destination rather than a label. */\nconst LINK_KEYS = new Set([\"href\", \"url\", \"link\"]);\n\nconst HAS_SCHEME = /^[a-z][a-z0-9+.-]*:/i;\n\n/** The schemes that only ever navigate. `javascript:` and `data:` run instead. */\nconst NAVIGABLE_URL = /^https?:\\/\\//i;\n\n/** A leading `//` or `/\\` is somewhere else entirely, wearing a path's clothes. */\nconst OFF_SITE_PATH = /^\\/[/\\\\]/;\n\n/** A browser ignores spaces and control characters when reading an href, so a scheme is read from the same stripped form it would see. */\nfunction withoutBlanks(text: string): string {\n  let stripped = \"\";\n  for (const character of text) if (character > \" \") stripped += character;\n  return stripped;\n}\n\n/**\n * Whether a metadata value can be put in an `href`.\n *\n * The key says what the producer meant by a value; it does not say what the\n * value is. Metadata is whatever JSON reached this client over the task API or\n * the SSE stream, so a `url` of `javascript:…` is a script the page would run\n * on click rather than a place it would go. What may be linked is therefore\n * named rather than what may not: a relative reference, or an http(s) URL.\n * Anything else keeps rendering as the plain text it already was.\n */\nexport function isMetadataLink(key: string, text: string): boolean {\n  if (!LINK_KEYS.has(key) && !text.startsWith(\"/\") && !text.startsWith(\"https://\")) return false;\n  const destination = withoutBlanks(text);\n  return HAS_SCHEME.test(destination) ? NAVIGABLE_URL.test(destination) : !OFF_SITE_PATH.test(destination);\n}\n"],"names":["isPlainObject"],"mappings":";;;AAoBA,SAAS,SAAS,OAAyC;AACzD,SAAO,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU;AACpF;AAOO,SAAS,gBAAgB,OAAiC;AAC/D,MAAI,CAACA,YAAAA,cAAc,KAAK,UAAU,CAAA;AAClC,QAAM,UAA2B,CAAA;AACjC,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC/C,QAAI,CAAC,SAAS,IAAI,KAAK,SAAS,GAAI;AACpC,YAAQ,KAAK,EAAE,KAAK,OAAO,MAAM,MAAM,OAAO,IAAI,GAAG;AAAA,EACvD;AACA,SAAO;AACT;AAOO,SAAS,eAAe,OAAyB;AACtD,SAAOA,YAAAA,cAAc,KAAK,KAAK,OAAO,OAAO,KAAK,EAAE,MAAM,QAAQ;AACpE;AAGA,MAAM,YAAY,oBAAI,IAAI,CAAC,QAAQ,OAAO,MAAM,CAAC;AAEjD,MAAM,aAAa;AAGnB,MAAM,gBAAgB;AAGtB,MAAM,gBAAgB;AAGtB,SAAS,cAAc,MAAsB;AAC3C,MAAI,WAAW;AACf,aAAW,aAAa,KAAM,KAAI,YAAY,IAAK,aAAY;AAC/D,SAAO;AACT;AAYO,SAAS,eAAe,KAAa,MAAuB;AACjE,MAAI,CAAC,UAAU,IAAI,GAAG,KAAK,CAAC,KAAK,WAAW,GAAG,KAAK,CAAC,KAAK,WAAW,UAAU,EAAG,QAAO;AACzF,QAAM,cAAc,cAAc,IAAI;AACtC,SAAO,WAAW,KAAK,WAAW,IAAI,cAAc,KAAK,WAAW,IAAI,CAAC,cAAc,KAAK,WAAW;AACzG;;;;"}

package/dist/data/task-metadata.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Task metadata is whatever JSON the producer chose to attach to a snapshot, so
+ * rendering it starts with reading its shape rather than assuming one. The split
+ * these helpers make is between values that read as a label — a state, a model,
+ * a session id — and values that do not, because only the first kind can go in a
+ * row of chips without turning into `[object Object]`.
+ */
+/** A metadata value that renders as one short piece of text. */
+export type MetadataScalar = string | number | boolean;
+export interface MetadataEntry {
+    key: string;
+    value: MetadataScalar;
+    /** The text to render, and to test for a link. */
+    text: string;
+}
+/**
+ * The scalar entries of a metadata object, in the producer's own key order.
+ * Empty strings are dropped: a producer that reports a field it has no value for
+ * yet is saying nothing, and a blank chip reads as a rendering fault.
+ */
+export declare function metadataEntries(value: unknown): MetadataEntry[];
+/**
+ * True when every value in the object is a scalar — the case a chip row or a
+ * definition list can render completely, with nothing left over to fall back to
+ * a JSON view for.
+ */
+export declare function isFlatMetadata(value: unknown): boolean;
+/**
+ * Whether a metadata value can be put in an `href`.
+ *
+ * The key says what the producer meant by a value; it does not say what the
+ * value is. Metadata is whatever JSON reached this client over the task API or
+ * the SSE stream, so a `url` of `javascript:…` is a script the page would run
+ * on click rather than a place it would go. What may be linked is therefore
+ * named rather than what may not: a relative reference, or an http(s) URL.
+ * Anything else keeps rendering as the plain text it already was.
+ */
+export declare function isMetadataLink(key: string, text: string): boolean;
+//# sourceMappingURL=task-metadata.d.ts.map

package/dist/data/task-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-metadata.d.ts","sourceRoot":"","sources":["../../src/data/task-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,cAAc,CAAC;IACtB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,EAAE,CAQ/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAIjE"}

package/dist/data/task-metadata.js

@@ -0,0 +1,36 @@
+import { isPlainObject } from "../lib/collections.js";
+function isScalar(value) {
+  return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+function metadataEntries(value) {
+  if (!isPlainObject(value)) return [];
+  const entries = [];
+  for (const [key, item] of Object.entries(value)) {
+    if (!isScalar(item) || item === "") continue;
+    entries.push({ key, value: item, text: String(item) });
+  }
+  return entries;
+}
+function isFlatMetadata(value) {
+  return isPlainObject(value) && Object.values(value).every(isScalar);
+}
+const LINK_KEYS = /* @__PURE__ */ new Set(["href", "url", "link"]);
+const HAS_SCHEME = /^[a-z][a-z0-9+.-]*:/i;
+const NAVIGABLE_URL = /^https?:\/\//i;
+const OFF_SITE_PATH = /^\/[/\\]/;
+function withoutBlanks(text) {
+  let stripped = "";
+  for (const character of text) if (character > " ") stripped += character;
+  return stripped;
+}
+function isMetadataLink(key, text) {
+  if (!LINK_KEYS.has(key) && !text.startsWith("/") && !text.startsWith("https://")) return false;
+  const destination = withoutBlanks(text);
+  return HAS_SCHEME.test(destination) ? NAVIGABLE_URL.test(destination) : !OFF_SITE_PATH.test(destination);
+}
+export {
+  isFlatMetadata,
+  isMetadataLink,
+  metadataEntries
+};
+//# sourceMappingURL=task-metadata.js.map

package/dist/data/task-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-metadata.js","sources":["../../src/data/task-metadata.ts"],"sourcesContent":["/**\n * Task metadata is whatever JSON the producer chose to attach to a snapshot, so\n * rendering it starts with reading its shape rather than assuming one. The split\n * these helpers make is between values that read as a label — a state, a model,\n * a session id — and values that do not, because only the first kind can go in a\n * row of chips without turning into `[object Object]`.\n */\n\nimport { isPlainObject } from \"../lib/collections\";\n\n/** A metadata value that renders as one short piece of text. */\nexport type MetadataScalar = string | number | boolean;\n\nexport interface MetadataEntry {\n  key: string;\n  value: MetadataScalar;\n  /** The text to render, and to test for a link. */\n  text: string;\n}\n\nfunction isScalar(value: unknown): value is MetadataScalar {\n  return typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\";\n}\n\n/**\n * The scalar entries of a metadata object, in the producer's own key order.\n * Empty strings are dropped: a producer that reports a field it has no value for\n * yet is saying nothing, and a blank chip reads as a rendering fault.\n */\nexport function metadataEntries(value: unknown): MetadataEntry[] {\n  if (!isPlainObject(value)) return [];\n  const entries: MetadataEntry[] = [];\n  for (const [key, item] of Object.entries(value)) {\n    if (!isScalar(item) || item === \"\") continue;\n    entries.push({ key, value: item, text: String(item) });\n  }\n  return entries;\n}\n\n/**\n * True when every value in the object is a scalar — the case a chip row or a\n * definition list can render completely, with nothing left over to fall back to\n * a JSON view for.\n */\nexport function isFlatMetadata(value: unknown): boolean {\n  return isPlainObject(value) && Object.values(value).every(isScalar);\n}\n\n/** Keys whose value is meant as a destination rather than a label. */\nconst LINK_KEYS = new Set([\"href\", \"url\", \"link\"]);\n\nconst HAS_SCHEME = /^[a-z][a-z0-9+.-]*:/i;\n\n/** The schemes that only ever navigate. `javascript:` and `data:` run instead. */\nconst NAVIGABLE_URL = /^https?:\\/\\//i;\n\n/** A leading `//` or `/\\` is somewhere else entirely, wearing a path's clothes. */\nconst OFF_SITE_PATH = /^\\/[/\\\\]/;\n\n/** A browser ignores spaces and control characters when reading an href, so a scheme is read from the same stripped form it would see. */\nfunction withoutBlanks(text: string): string {\n  let stripped = \"\";\n  for (const character of text) if (character > \" \") stripped += character;\n  return stripped;\n}\n\n/**\n * Whether a metadata value can be put in an `href`.\n *\n * The key says what the producer meant by a value; it does not say what the\n * value is. Metadata is whatever JSON reached this client over the task API or\n * the SSE stream, so a `url` of `javascript:…` is a script the page would run\n * on click rather than a place it would go. What may be linked is therefore\n * named rather than what may not: a relative reference, or an http(s) URL.\n * Anything else keeps rendering as the plain text it already was.\n */\nexport function isMetadataLink(key: string, text: string): boolean {\n  if (!LINK_KEYS.has(key) && !text.startsWith(\"/\") && !text.startsWith(\"https://\")) return false;\n  const destination = withoutBlanks(text);\n  return HAS_SCHEME.test(destination) ? NAVIGABLE_URL.test(destination) : !OFF_SITE_PATH.test(destination);\n}\n"],"names":[],"mappings":";AAoBA,SAAS,SAAS,OAAyC;AACzD,SAAO,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU;AACpF;AAOO,SAAS,gBAAgB,OAAiC;AAC/D,MAAI,CAAC,cAAc,KAAK,UAAU,CAAA;AAClC,QAAM,UAA2B,CAAA;AACjC,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC/C,QAAI,CAAC,SAAS,IAAI,KAAK,SAAS,GAAI;AACpC,YAAQ,KAAK,EAAE,KAAK,OAAO,MAAM,MAAM,OAAO,IAAI,GAAG;AAAA,EACvD;AACA,SAAO;AACT;AAOO,SAAS,eAAe,OAAyB;AACtD,SAAO,cAAc,KAAK,KAAK,OAAO,OAAO,KAAK,EAAE,MAAM,QAAQ;AACpE;AAGA,MAAM,YAAY,oBAAI,IAAI,CAAC,QAAQ,OAAO,MAAM,CAAC;AAEjD,MAAM,aAAa;AAGnB,MAAM,gBAAgB;AAGtB,MAAM,gBAAgB;AAGtB,SAAS,cAAc,MAAsB;AAC3C,MAAI,WAAW;AACf,aAAW,aAAa,KAAM,KAAI,YAAY,IAAK,aAAY;AAC/D,SAAO;AACT;AAYO,SAAS,eAAe,KAAa,MAAuB;AACjE,MAAI,CAAC,UAAU,IAAI,GAAG,KAAK,CAAC,KAAK,WAAW,GAAG,KAAK,CAAC,KAAK,WAAW,UAAU,EAAG,QAAO;AACzF,QAAM,cAAc,cAAc,IAAI;AACtC,SAAO,WAAW,KAAK,WAAW,IAAI,cAAc,KAAK,WAAW,IAAI,CAAC,cAAc,KAAK,WAAW;AACzG;"}

package/dist/data/task-streams.cjs

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const emptyTaskStreams = {
+  stdoutTruncated: false,
+  stderrTruncated: false,
+  stdoutEnd: 0,
+  stderrEnd: 0
+};
+const encoder = new TextEncoder();
+function utf8Length(data) {
+  return encoder.encode(data).byteLength;
+}
+function applyTaskOutputDelta(current, delta) {
+  const held = delta.stream === "stdout" ? current.stdout : current.stderr;
+  const end = delta.stream === "stdout" ? current.stdoutEnd : current.stderrEnd;
+  const continues = delta.reset !== true && held !== void 0 && end === delta.offset;
+  const text = continues ? `${held}${delta.data}` : delta.data;
+  const wasTruncated = delta.stream === "stdout" ? current.stdoutTruncated : current.stderrTruncated;
+  const truncated = delta.truncated ?? (continues && wasTruncated);
+  const streamEnd = delta.offset + utf8Length(delta.data);
+  return delta.stream === "stdout" ? { ...current, stdout: text, stdoutTruncated: truncated, stdoutEnd: streamEnd } : { ...current, stderr: text, stderrTruncated: truncated, stderrEnd: streamEnd };
+}
+function withTaskStreams(snapshot, streams) {
+  if (!streams) return snapshot;
+  const merged = { ...snapshot };
+  if (streams.stdout !== void 0) {
+    merged.stdout = streams.stdout;
+    merged.stdoutTruncated = streams.stdoutTruncated;
+  }
+  if (streams.stderr !== void 0) {
+    merged.stderr = streams.stderr;
+    merged.stderrTruncated = streams.stderrTruncated;
+  }
+  return merged;
+}
+exports.applyTaskOutputDelta = applyTaskOutputDelta;
+exports.emptyTaskStreams = emptyTaskStreams;
+exports.withTaskStreams = withTaskStreams;
+//# sourceMappingURL=task-streams.cjs.map

package/dist/data/task-streams.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-streams.cjs","sources":["../../src/data/task-streams.ts"],"sourcesContent":["import type { TaskSnapshot } from \"./TaskSnapshot\";\n\n/**\n * A task's stdout/stderr arrive as append-only deltas on their own SSE frames,\n * never on the task frames — clicky strips them there deliberately, so the tail\n * of a long-running process is not re-sent every time a duration ticks over.\n *\n * That makes where a client keeps the accumulated text a correctness question,\n * not a style one. Kept on the snapshot object, it is destroyed the next time a\n * task frame replaces that object, and since the server only sends what a client\n * has not seen it is never sent again — the output appears, vanishes a moment\n * later, and only flickers back when the process happens to write more. So it is\n * kept here instead, beside the snapshots rather than inside them, and merged in\n * at the boundary.\n */\nexport interface TaskStreams {\n  stdout?: string;\n  stderr?: string;\n  stdoutTruncated: boolean;\n  stderrTruncated: boolean;\n  /** Absolute stream offset one past the last byte held, per stream. */\n  stdoutEnd: number;\n  stderrEnd: number;\n}\n\nexport const emptyTaskStreams: TaskStreams = {\n  stdoutTruncated: false,\n  stderrTruncated: false,\n  stdoutEnd: 0,\n  stderrEnd: 0,\n};\n\n/**\n * One `event: output` frame. `offset` is an ABSOLUTE position in the task's\n * stream, not a length into what this client holds: on an append it is where\n * `data` belongs, and on a `reset` it is where the server's retained tail now\n * begins. `truncated` says bytes ahead of that point are gone for good.\n */\nexport interface TaskOutputDelta {\n  id: string;\n  groupId?: string;\n  stream: \"stdout\" | \"stderr\";\n  data: string;\n  offset: number;\n  reset?: boolean;\n  truncated?: boolean;\n}\n\nconst encoder = new TextEncoder();\n\n/**\n * How far `data` advances the stream. Offsets are byte positions in the\n * process's own output, and a JS string measures UTF-16 code units — so `\"é\"`\n * counts as one there and as the two bytes the server actually wrote. Measuring\n * the wrong unit puts the client's end short of the next delta's start, and\n * every following frame is then read as a gap and replaces the text it should\n * have continued.\n */\nfunction utf8Length(data: string): number {\n  return encoder.encode(data).byteLength;\n}\n\n/**\n * Applies one delta to what a task's streams already hold.\n *\n * Appending is only correct where the two actually meet — the client's own end\n * is exactly the delta's start. Anything else is a replacement: an explicit\n * `reset`, or a gap opened by a retained window that rolled past what this\n * client last saw. Concatenating across such a gap would silently splice\n * together two pieces of output that never ran together.\n *\n * Truncation carries across an append: dropping the head of a stream is not\n * undone by writing more to its tail, so a frame that simply says nothing about\n * it leaves the flag as it was, and only an explicit value changes it.\n */\nexport function applyTaskOutputDelta(current: TaskStreams, delta: TaskOutputDelta): TaskStreams {\n  const held = delta.stream === \"stdout\" ? current.stdout : current.stderr;\n  const end = delta.stream === \"stdout\" ? current.stdoutEnd : current.stderrEnd;\n  const continues = delta.reset !== true && held !== undefined && end === delta.offset;\n  const text = continues ? `${held}${delta.data}` : delta.data;\n  const wasTruncated = delta.stream === \"stdout\" ? current.stdoutTruncated : current.stderrTruncated;\n  const truncated = delta.truncated ?? (continues && wasTruncated);\n  const streamEnd = delta.offset + utf8Length(delta.data);\n\n  return delta.stream === \"stdout\"\n    ? { ...current, stdout: text, stdoutTruncated: truncated, stdoutEnd: streamEnd }\n    : { ...current, stderr: text, stderrTruncated: truncated, stderrEnd: streamEnd };\n}\n\n/**\n * Projects accumulated streams back onto a snapshot for rendering. The offset\n * bookkeeping stays here: it is how this client tracks its own position, not\n * something a consumer of a snapshot has any use for.\n */\nexport function withTaskStreams(snapshot: TaskSnapshot, streams: TaskStreams | undefined): TaskSnapshot {\n  if (!streams) return snapshot;\n  const merged: TaskSnapshot = { ...snapshot };\n  if (streams.stdout !== undefined) {\n    merged.stdout = streams.stdout;\n    merged.stdoutTruncated = streams.stdoutTruncated;\n  }\n  if (streams.stderr !== undefined) {\n    merged.stderr = streams.stderr;\n    merged.stderrTruncated = streams.stderrTruncated;\n  }\n  return merged;\n}\n"],"names":[],"mappings":";;AAyBO,MAAM,mBAAgC;AAAA,EAC3C,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,WAAW;AAAA,EACX,WAAW;AACb;AAkBA,MAAM,UAAU,IAAI,YAAA;AAUpB,SAAS,WAAW,MAAsB;AACxC,SAAO,QAAQ,OAAO,IAAI,EAAE;AAC9B;AAeO,SAAS,qBAAqB,SAAsB,OAAqC;AAC9F,QAAM,OAAO,MAAM,WAAW,WAAW,QAAQ,SAAS,QAAQ;AAClE,QAAM,MAAM,MAAM,WAAW,WAAW,QAAQ,YAAY,QAAQ;AACpE,QAAM,YAAY,MAAM,UAAU,QAAQ,SAAS,UAAa,QAAQ,MAAM;AAC9E,QAAM,OAAO,YAAY,GAAG,IAAI,GAAG,MAAM,IAAI,KAAK,MAAM;AACxD,QAAM,eAAe,MAAM,WAAW,WAAW,QAAQ,kBAAkB,QAAQ;AACnF,QAAM,YAAY,MAAM,cAAc,aAAa;AACnD,QAAM,YAAY,MAAM,SAAS,WAAW,MAAM,IAAI;AAEtD,SAAO,MAAM,WAAW,WACpB,EAAE,GAAG,SAAS,QAAQ,MAAM,iBAAiB,WAAW,WAAW,UAAA,IACnE,EAAE,GAAG,SAAS,QAAQ,MAAM,iBAAiB,WAAW,WAAW,UAAA;AACzE;AAOO,SAAS,gBAAgB,UAAwB,SAAgD;AACtG,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,SAAuB,EAAE,GAAG,SAAA;AAClC,MAAI,QAAQ,WAAW,QAAW;AAChC,WAAO,SAAS,QAAQ;AACxB,WAAO,kBAAkB,QAAQ;AAAA,EACnC;AACA,MAAI,QAAQ,WAAW,QAAW;AAChC,WAAO,SAAS,QAAQ;AACxB,WAAO,kBAAkB,QAAQ;AAAA,EACnC;AACA,SAAO;AACT;;;;"}

package/dist/data/task-streams.d.ts

@@ -0,0 +1,60 @@
+import { TaskSnapshot } from './TaskSnapshot';
+/**
+ * A task's stdout/stderr arrive as append-only deltas on their own SSE frames,
+ * never on the task frames — clicky strips them there deliberately, so the tail
+ * of a long-running process is not re-sent every time a duration ticks over.
+ *
+ * That makes where a client keeps the accumulated text a correctness question,
+ * not a style one. Kept on the snapshot object, it is destroyed the next time a
+ * task frame replaces that object, and since the server only sends what a client
+ * has not seen it is never sent again — the output appears, vanishes a moment
+ * later, and only flickers back when the process happens to write more. So it is
+ * kept here instead, beside the snapshots rather than inside them, and merged in
+ * at the boundary.
+ */
+export interface TaskStreams {
+    stdout?: string;
+    stderr?: string;
+    stdoutTruncated: boolean;
+    stderrTruncated: boolean;
+    /** Absolute stream offset one past the last byte held, per stream. */
+    stdoutEnd: number;
+    stderrEnd: number;
+}
+export declare const emptyTaskStreams: TaskStreams;
+/**
+ * One `event: output` frame. `offset` is an ABSOLUTE position in the task's
+ * stream, not a length into what this client holds: on an append it is where
+ * `data` belongs, and on a `reset` it is where the server's retained tail now
+ * begins. `truncated` says bytes ahead of that point are gone for good.
+ */
+export interface TaskOutputDelta {
+    id: string;
+    groupId?: string;
+    stream: "stdout" | "stderr";
+    data: string;
+    offset: number;
+    reset?: boolean;
+    truncated?: boolean;
+}
+/**
+ * Applies one delta to what a task's streams already hold.
+ *
+ * Appending is only correct where the two actually meet — the client's own end
+ * is exactly the delta's start. Anything else is a replacement: an explicit
+ * `reset`, or a gap opened by a retained window that rolled past what this
+ * client last saw. Concatenating across such a gap would silently splice
+ * together two pieces of output that never ran together.
+ *
+ * Truncation carries across an append: dropping the head of a stream is not
+ * undone by writing more to its tail, so a frame that simply says nothing about
+ * it leaves the flag as it was, and only an explicit value changes it.
+ */
+export declare function applyTaskOutputDelta(current: TaskStreams, delta: TaskOutputDelta): TaskStreams;
+/**
+ * Projects accumulated streams back onto a snapshot for rendering. The offset
+ * bookkeeping stays here: it is how this client tracks its own position, not
+ * something a consumer of a snapshot has any use for.
+ */
+export declare function withTaskStreams(snapshot: TaskSnapshot, streams: TaskStreams | undefined): TaskSnapshot;
+//# sourceMappingURL=task-streams.d.ts.map

package/dist/data/task-streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-streams.d.ts","sourceRoot":"","sources":["../../src/data/task-streams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,gBAAgB,EAAE,WAK9B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAgBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,GAAG,WAAW,CAY9F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,CAYtG"}

package/dist/data/task-streams.js

@@ -0,0 +1,39 @@
+const emptyTaskStreams = {
+  stdoutTruncated: false,
+  stderrTruncated: false,
+  stdoutEnd: 0,
+  stderrEnd: 0
+};
+const encoder = new TextEncoder();
+function utf8Length(data) {
+  return encoder.encode(data).byteLength;
+}
+function applyTaskOutputDelta(current, delta) {
+  const held = delta.stream === "stdout" ? current.stdout : current.stderr;
+  const end = delta.stream === "stdout" ? current.stdoutEnd : current.stderrEnd;
+  const continues = delta.reset !== true && held !== void 0 && end === delta.offset;
+  const text = continues ? `${held}${delta.data}` : delta.data;
+  const wasTruncated = delta.stream === "stdout" ? current.stdoutTruncated : current.stderrTruncated;
+  const truncated = delta.truncated ?? (continues && wasTruncated);
+  const streamEnd = delta.offset + utf8Length(delta.data);
+  return delta.stream === "stdout" ? { ...current, stdout: text, stdoutTruncated: truncated, stdoutEnd: streamEnd } : { ...current, stderr: text, stderrTruncated: truncated, stderrEnd: streamEnd };
+}
+function withTaskStreams(snapshot, streams) {
+  if (!streams) return snapshot;
+  const merged = { ...snapshot };
+  if (streams.stdout !== void 0) {
+    merged.stdout = streams.stdout;
+    merged.stdoutTruncated = streams.stdoutTruncated;
+  }
+  if (streams.stderr !== void 0) {
+    merged.stderr = streams.stderr;
+    merged.stderrTruncated = streams.stderrTruncated;
+  }
+  return merged;
+}
+export {
+  applyTaskOutputDelta,
+  emptyTaskStreams,
+  withTaskStreams
+};
+//# sourceMappingURL=task-streams.js.map

package/dist/data/task-streams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-streams.js","sources":["../../src/data/task-streams.ts"],"sourcesContent":["import type { TaskSnapshot } from \"./TaskSnapshot\";\n\n/**\n * A task's stdout/stderr arrive as append-only deltas on their own SSE frames,\n * never on the task frames — clicky strips them there deliberately, so the tail\n * of a long-running process is not re-sent every time a duration ticks over.\n *\n * That makes where a client keeps the accumulated text a correctness question,\n * not a style one. Kept on the snapshot object, it is destroyed the next time a\n * task frame replaces that object, and since the server only sends what a client\n * has not seen it is never sent again — the output appears, vanishes a moment\n * later, and only flickers back when the process happens to write more. So it is\n * kept here instead, beside the snapshots rather than inside them, and merged in\n * at the boundary.\n */\nexport interface TaskStreams {\n  stdout?: string;\n  stderr?: string;\n  stdoutTruncated: boolean;\n  stderrTruncated: boolean;\n  /** Absolute stream offset one past the last byte held, per stream. */\n  stdoutEnd: number;\n  stderrEnd: number;\n}\n\nexport const emptyTaskStreams: TaskStreams = {\n  stdoutTruncated: false,\n  stderrTruncated: false,\n  stdoutEnd: 0,\n  stderrEnd: 0,\n};\n\n/**\n * One `event: output` frame. `offset` is an ABSOLUTE position in the task's\n * stream, not a length into what this client holds: on an append it is where\n * `data` belongs, and on a `reset` it is where the server's retained tail now\n * begins. `truncated` says bytes ahead of that point are gone for good.\n */\nexport interface TaskOutputDelta {\n  id: string;\n  groupId?: string;\n  stream: \"stdout\" | \"stderr\";\n  data: string;\n  offset: number;\n  reset?: boolean;\n  truncated?: boolean;\n}\n\nconst encoder = new TextEncoder();\n\n/**\n * How far `data` advances the stream. Offsets are byte positions in the\n * process's own output, and a JS string measures UTF-16 code units — so `\"é\"`\n * counts as one there and as the two bytes the server actually wrote. Measuring\n * the wrong unit puts the client's end short of the next delta's start, and\n * every following frame is then read as a gap and replaces the text it should\n * have continued.\n */\nfunction utf8Length(data: string): number {\n  return encoder.encode(data).byteLength;\n}\n\n/**\n * Applies one delta to what a task's streams already hold.\n *\n * Appending is only correct where the two actually meet — the client's own end\n * is exactly the delta's start. Anything else is a replacement: an explicit\n * `reset`, or a gap opened by a retained window that rolled past what this\n * client last saw. Concatenating across such a gap would silently splice\n * together two pieces of output that never ran together.\n *\n * Truncation carries across an append: dropping the head of a stream is not\n * undone by writing more to its tail, so a frame that simply says nothing about\n * it leaves the flag as it was, and only an explicit value changes it.\n */\nexport function applyTaskOutputDelta(current: TaskStreams, delta: TaskOutputDelta): TaskStreams {\n  const held = delta.stream === \"stdout\" ? current.stdout : current.stderr;\n  const end = delta.stream === \"stdout\" ? current.stdoutEnd : current.stderrEnd;\n  const continues = delta.reset !== true && held !== undefined && end === delta.offset;\n  const text = continues ? `${held}${delta.data}` : delta.data;\n  const wasTruncated = delta.stream === \"stdout\" ? current.stdoutTruncated : current.stderrTruncated;\n  const truncated = delta.truncated ?? (continues && wasTruncated);\n  const streamEnd = delta.offset + utf8Length(delta.data);\n\n  return delta.stream === \"stdout\"\n    ? { ...current, stdout: text, stdoutTruncated: truncated, stdoutEnd: streamEnd }\n    : { ...current, stderr: text, stderrTruncated: truncated, stderrEnd: streamEnd };\n}\n\n/**\n * Projects accumulated streams back onto a snapshot for rendering. The offset\n * bookkeeping stays here: it is how this client tracks its own position, not\n * something a consumer of a snapshot has any use for.\n */\nexport function withTaskStreams(snapshot: TaskSnapshot, streams: TaskStreams | undefined): TaskSnapshot {\n  if (!streams) return snapshot;\n  const merged: TaskSnapshot = { ...snapshot };\n  if (streams.stdout !== undefined) {\n    merged.stdout = streams.stdout;\n    merged.stdoutTruncated = streams.stdoutTruncated;\n  }\n  if (streams.stderr !== undefined) {\n    merged.stderr = streams.stderr;\n    merged.stderrTruncated = streams.stderrTruncated;\n  }\n  return merged;\n}\n"],"names":[],"mappings":"AAyBO,MAAM,mBAAgC;AAAA,EAC3C,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,WAAW;AAAA,EACX,WAAW;AACb;AAkBA,MAAM,UAAU,IAAI,YAAA;AAUpB,SAAS,WAAW,MAAsB;AACxC,SAAO,QAAQ,OAAO,IAAI,EAAE;AAC9B;AAeO,SAAS,qBAAqB,SAAsB,OAAqC;AAC9F,QAAM,OAAO,MAAM,WAAW,WAAW,QAAQ,SAAS,QAAQ;AAClE,QAAM,MAAM,MAAM,WAAW,WAAW,QAAQ,YAAY,QAAQ;AACpE,QAAM,YAAY,MAAM,UAAU,QAAQ,SAAS,UAAa,QAAQ,MAAM;AAC9E,QAAM,OAAO,YAAY,GAAG,IAAI,GAAG,MAAM,IAAI,KAAK,MAAM;AACxD,QAAM,eAAe,MAAM,WAAW,WAAW,QAAQ,kBAAkB,QAAQ;AACnF,QAAM,YAAY,MAAM,cAAc,aAAa;AACnD,QAAM,YAAY,MAAM,SAAS,WAAW,MAAM,IAAI;AAEtD,SAAO,MAAM,WAAW,WACpB,EAAE,GAAG,SAAS,QAAQ,MAAM,iBAAiB,WAAW,WAAW,UAAA,IACnE,EAAE,GAAG,SAAS,QAAQ,MAAM,iBAAiB,WAAW,WAAW,UAAA;AACzE;AAOO,SAAS,gBAAgB,UAAwB,SAAgD;AACtG,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,SAAuB,EAAE,GAAG,SAAA;AAClC,MAAI,QAAQ,WAAW,QAAW;AAChC,WAAO,SAAS,QAAQ;AACxB,WAAO,kBAAkB,QAAQ;AAAA,EACnC;AACA,MAAI,QAAQ,WAAW,QAAW;AAChC,WAAO,SAAS,QAAQ;AACxB,WAAO,kBAAkB,QAAQ;AAAA,EACnC;AACA,SAAO;AACT;"}

package/dist/data/version-info.cjs

@@ -15,9 +15,9 @@ function detectMode() {
 }
 function getVersionInfo() {
   return {
-    commit: read(() => "db149da3", ""),
-    tag: read(() => "clicky-ui@0.3.34", ""),
-    date: read(() => "2026-09-08T19:28:58.240Z", ""),
+    commit: read(() => "eb303aa4", ""),
+    tag: read(() => "clicky-ui@0.3.36", ""),
+    date: read(() => "2026-09-22T15:00:46.963Z", ""),
     dirty: read(() => true, false),
     mode: detectMode()
   };

package/dist/data/version-info.js

@@ -13,9 +13,9 @@ function detectMode() {
 }
 function getVersionInfo() {
   return {
-    commit: read(() => "db149da3", ""),
-    tag: read(() => "clicky-ui@0.3.34", ""),
-    date: read(() => "2026-09-08T19:28:25.266Z", ""),
+    commit: read(() => "eb303aa4", ""),
+    tag: read(() => "clicky-ui@0.3.36", ""),
+    date: read(() => "2026-09-22T15:00:06.348Z", ""),
     dirty: read(() => true, false),
     mode: detectMode()
   };