@abot-ai/runtime 1.5.0 → 1.6.0

package/src/runtime/scheduler/README.md

@@ -21,6 +21,19 @@ settling into a restarted generation. Startup marks previously running requests
 Jobs to their next future occurrence. It never retries an interrupted or failed
 request or backfills missed occurrences.
 
+Automation session reconciliation runs after startup recovery under the same
+exclusive ownership, before dispatch is enabled; lazy service startup uses this
+boundary too. The file adapter retires only complete persisted `automationOrigin`
+records whose exact session ID has no issued active handle. Each pass scans at
+most 256 regular JSON records and retires at most 64 internal sessions, advancing
+a cursor through ordinary records and failed candidates. Attachments are removed
+before the transcript so failed cleanup keeps its durable ownership marker.
+Attempt deletion first installs its existing tombstone, blocking late transcript
+writes while attachment cleanup waits. Cleanup failures are reported without
+disabling scheduled work, and existing five-minute maintenance can try later.
+Ordinary conversations, canonical run results and source snapshots are untouched;
+injected adapters participate only through the optional trusted recovery hook.
+
 A session deletion reserves its start barrier synchronously, including while
 startup is queued. Passing the running-state check confirms deletion; a rejected
 lifecycle call releases only its own reservation. A storage failure after
@@ -45,6 +58,9 @@ is uncertain. The owned store rejects further cached reads, writes and cleanup
 until explicitly released and reacquired; it does not retry a mutation or dispatch
 an unconfirmed claim. Both old and new files remain available. Reacquisition validates
 and syncs the visible head and its directory dependencies before cleanup.
+Automation result files follow the same boundary: uncertain publication preserves
+their bytes, and existing retention maintenance reclaims unreferenced owned files
+only after reading a durable journal head. In-flight publications remain protected.
 These barriers rely on the filesystem and device honoring fsync; they are not a
 backup or repair mechanism for pre-existing corruption.
 
@@ -112,6 +128,17 @@ interval cannot block another Job or startup recovery. The Web editor retains
 the exact saved interval anchor when its displayed field is unchanged, including
 seconds, milliseconds and the selected occurrence of a repeated local time.
 
+Automation draft readiness uses the same next-occurrence and interval-range
+checks as scheduler admission, including the publication clock and time zone.
+New or changed elapsed one-shot dates produce a normal validation issue before
+publication; unchanged authored timing keeps its published timer deadline or
+implicit interval/folder polling anchor across title and graph edits. Actual
+duration, anchor or trigger-kind edits establish new timing. Time-zone metadata
+changes reschedule calendar forms only. The exact retained publication identifies
+unchanged timing, and a concurrent Job revision change rejects publication atomically.
+Manually replaying a frozen run validates its schedule shape without requiring
+a new future scheduled occurrence.
+
 Calendar conversion uses `Intl.DateTimeFormat` from the host's IANA time-zone data.
 Missing wall times/days are skipped; repeated local times select their first
 occurrence once. Intervals preserve elapsed-time cadence across DST.
@@ -170,3 +197,39 @@ admission and reject a deleted session before executing its request.
 
 The model and Web layers share this service. Natural-language interpretation,
 model choice, conversation projection, and UI rendering do not belong here.
+
+## Automation folder retention and capacity
+
+Folder input history, including baseline exclusions and consumed-version dedup
+records, is bounded to 32 MiB of metadata per automation across all of its source
+IDs and roots. Reaching that bound stops intake for that automation; changing a
+source ID does not reset it, and unrelated automations can continue. History is
+preserved rather than silently making old file versions eligible again. This
+does not promise indefinite intake for one automation without a capacity stop.
+Retained input snapshots additionally share environment limits of 1,000 records,
+32 MiB of snapshot-record metadata and 256 MiB of file bytes.
+
+Snapshots, including held failed/interrupted inputs, can retire after every
+referencing report expires at 90 days and no unresolved effect remains. Fulfilled
+late settlements (`succeeded` or `failed`) resolve that retention blocker while
+the original uncertain outcome remains historical evidence. Missing or rejected
+late settlements continue protecting the affected payloads. A newer
+replay or active execution keeps its input snapshot. Root-specific baseline
+exclusions preserve the original snapshot and replay identity when a source
+changes to an overlapping directory. A batch searches for a feasible minimum
+file count within its 32 MiB byte limit; oversized candidates remain pending.
+
+New source snapshots are preceded by a durable preparation marker. Existing
+scheduler maintenance and source preparation reconcile these markers: a committed
+input/run preserves its snapshots, an active preparation is protected, and a
+marker abandoned by a crashed process authorizes removal of only that candidate's
+attachments. Unmarked attachment owners are never inferred to be automation
+orphans; ordinary conversation attachments remain outside this cleanup.
+
+Automation run reads add a transient output summary from the frozen graph's
+terminal producers, including separate parallel tails. At most four saved
+outputs are previewed with an explicit omitted count and the existing 4,000
+character limit per text/data part; full step evidence remains a separate read.
+These previews preserve step status and distinguish available, expired and
+unavailable output. They neither infer a business outcome from model text nor
+extend retention by copying output into the persisted compact report.

package/dist/src/web-ui/app/components/passive-learning/proposal-notifications.js

@@ -1,106 +0,0 @@
-const MAX_SEEN_DELIVERIES = 100;
-
-function isProposalDelivery(message, environmentId) {
-  if (message?.type !== "learning.changed") return false;
-  if (message.environmentId !== environmentId) return false;
-  if (message.event?.type !== "proposal_delivered") return false;
-  return [message.event.proposalId, message.event.sessionId].every(
-    (id) =>
-      typeof id === "string" &&
-      id.length > 0 &&
-      id.length <= 256 &&
-      !/[\u0000-\u001f\u007f]/u.test(id),
-  );
-}
-
-/** Live deliveries alone announce themselves. Restored snapshots never produce a toast. */
-export function createProposalNotifications({
-  getEnvironmentId,
-  openSession,
-  getDocument = () => document,
-}) {
-  const seen = new Set();
-  let root;
-  let current;
-  let ownerDocument;
-
-  function syncVisibility() {
-    if (!root) return;
-    root.hidden = !current || ownerDocument.visibilityState === "hidden";
-  }
-
-  function hide() {
-    current = undefined;
-    if (root) root.hidden = true;
-  }
-
-  async function handleClick(event) {
-    const button = event.target.closest("button");
-    if (!button || !root?.contains(button)) return;
-    if (button.matches("[data-proposal-notice-close]")) {
-      hide();
-      return;
-    }
-    if (!button.matches("[data-proposal-notice-open]")) return;
-    const proposal = current;
-    if (!proposal || proposal.environmentId !== getEnvironmentId()) {
-      hide();
-      return;
-    }
-    button.disabled = true;
-    try {
-      const opened = await openSession(
-        proposal.sessionId,
-        proposal.environmentId,
-      );
-      if (current === proposal && opened !== false) hide();
-    } catch {
-      if (current !== proposal) return;
-      root.querySelector("[data-proposal-notice-description]").textContent =
-        "The conversation could not be opened. You can also find it in Chats.";
-    } finally {
-      if (current === proposal) button.disabled = false;
-    }
-  }
-
-  function mount() {
-    if (root) return;
-    const doc = getDocument();
-    ownerDocument = doc;
-    root = doc.createElement("aside");
-    root.className = "co-worker-proposal-toast";
-    root.setAttribute("role", "status");
-    root.setAttribute("aria-live", "polite");
-    root.setAttribute("aria-atomic", "true");
-    root.addEventListener("click", handleClick);
-    doc.addEventListener?.("visibilitychange", syncVisibility);
-    doc.body.append(root);
-  }
-
-  return Object.freeze({
-    handleRealtime(message) {
-      const environmentId = getEnvironmentId();
-      if (!isProposalDelivery(message, environmentId)) return;
-      const key = JSON.stringify([environmentId, message.event.proposalId]);
-      if (seen.has(key)) return;
-      seen.add(key);
-      if (seen.size > MAX_SEEN_DELIVERIES)
-        seen.delete(seen.values().next().value);
-      mount();
-      current = { environmentId, sessionId: message.event.sessionId };
-      root.innerHTML = `<div class="co-worker-proposal-toast-copy"><p>ABot Spark has a suggestion</p>
-        <span data-proposal-notice-description>A new conversation is ready when you are.</span>
-        <button type="button" class="home-text-button" data-proposal-notice-open>Read suggestion ↗</button></div>
-        <button type="button" class="home-text-button" data-proposal-notice-close aria-label="Dismiss notification">×</button>`;
-      syncVisibility();
-    },
-    environmentChanged: hide,
-    dispose() {
-      hide();
-      root?.removeEventListener("click", handleClick);
-      ownerDocument?.removeEventListener?.("visibilitychange", syncVisibility);
-      root?.remove();
-      root = undefined;
-    },
-  });
-}

package/dist/src/web-ui/app/components/passive-learning/proposal-read-state.js

@@ -1,23 +0,0 @@
-import { isSessionReadStateUnavailable } from "../../lib/session-read-state.js";
-
-function hasReadProposalConversation(proposal, sessions) {
-  const session = sessions.find((item) => item.id === proposal.sessionId);
-  if (!session || isSessionReadStateUnavailable(session)) return false;
-  // Each proposal starts its own conversation. Any confirmed assistant read
-  // boundary in that conversation includes the opening proposal.
-  return Boolean(session.lastReadMessageId ?? session.readState?.lastReadMessageId);
-}
-
-/** Invitations reflect confirmed reads without changing the stored proposal history. */
-export function visibleProposalSnapshot(snapshot, sessionSnapshot) {
-  if (!snapshot.status?.proactive) return snapshot;
-  if (!sessionSnapshot) return snapshot;
-  if (sessionSnapshot.environmentId !== snapshot.environmentId) return snapshot;
-  const proposals = (snapshot.status.proactive.proposals ?? []).filter(
-    (proposal) => !hasReadProposalConversation(proposal, sessionSnapshot.sessions),
-  );
-  return {
-    ...snapshot,
-    status: { ...snapshot.status, proactive: { ...snapshot.status.proactive, proposals } },
-  };
-}

package/dist/src/web-ui/app/components/passive-learning/proposal-view.js

@@ -1,23 +0,0 @@
-import { escapeAttribute, escapeHtml } from "../../lib/text-format.js";
-const renderKeys = new WeakMap();
-
-export function renderLearningProposals(root, snapshot, { limit = 3 } = {}) {
-  const container = root.querySelector("[data-learning-proposals]");
-  if (!container) return;
-  const proposals = [...(snapshot.status?.proactive?.proposals ?? [])].reverse().filter((item) => item.status === "delivered").slice(0, limit);
-  const key = JSON.stringify([snapshot.environmentId, proposals, snapshot.dismissingProposalId, snapshot.proposalError]);
-  if (renderKeys.get(container) === key) return;
-  renderKeys.set(container, key);
-  container.innerHTML = proposals.map((item) => `<article class="co-worker-proposal"><div class="co-worker-proposal-icon" aria-hidden="true">✦</div><div><span class="co-worker-eyebrow">ABot Spark · conversation ready</span><h4 dir="auto">${escapeHtml(item.title)}</h4><p dir="auto">${escapeHtml(item.message)}</p><div class="co-worker-proposal-actions"><button type="button" data-learning-proposal-open="${escapeAttribute(item.id)}">Open conversation ↗</button><button type="button" data-learning-proposal-dismiss="${escapeAttribute(item.id)}"${snapshot.dismissingProposalId ? " disabled" : ""}>Not now</button></div></div></article>`).join("") + (snapshot.proposalError ? `<p role="status">${escapeHtml(snapshot.proposalError)}</p>` : "");
-}
-
-export function handleProposalClick(root, event, actions = {}) {
-  const open = event.target.closest("[data-learning-proposal-open]");
-  if (open && root.contains(open)) { void actions.openProposal?.(open.dataset.learningProposalOpen); return true; }
-  const dismiss = event.target.closest("[data-learning-proposal-dismiss]");
-  if (dismiss && root.contains(dismiss)) {
-    if (!dismiss.disabled) void actions.dismissProposal?.(dismiss.dataset.learningProposalDismiss);
-    return true;
-  }
-  return false;
-}

package/dist/src/web-ui/app/components/spark-conversation-actions.js

@@ -1,62 +0,0 @@
-export function createSparkConversationActions({
-  getScope,
-  getMessages,
-  getActiveRequestId = () => "",
-  preferences,
-  archiveSession,
-  onArchived = () => {},
-  notify = () => {},
-  documentRoot = document,
-}) {
-  function canReview(message, scope) {
-    if (!scope.environmentId || !scope.sessionId || !preferences) return false;
-    if (getActiveRequestId() || message.streaming || !message.sparkProposalId) return false;
-    const messages = getMessages();
-    if (messages.some((item) => item.role === "user")) return false;
-    if (messages.find((item) => item.role === "assistant") !== message) return false;
-    if (preferences.loadSessionSidebar(scope.environmentId).archivedSessionIds.includes(scope.sessionId)) return false;
-    return !preferences.hasKeptSparkConversation(scope.environmentId, scope.sessionId);
-  }
-
-  function createNode(message, { onKept = () => {} } = {}) {
-    const scope = getScope();
-    if (!canReview(message, scope)) return null;
-    const row = documentRoot.createElement("div");
-    row.className = "spark-conversation-actions";
-    row.setAttribute("role", "group");
-    row.setAttribute("aria-label", "ABot Spark conversation");
-
-    function choose(action) {
-      const current = getScope();
-      if (current.environmentId !== scope.environmentId || current.sessionId !== scope.sessionId) return;
-      if (!canReview(message, scope)) return;
-      try {
-        if (action === "keep") {
-          preferences.keepSparkConversation(scope.environmentId, scope.sessionId);
-          row.hidden = true;
-          onKept();
-          notify("Conversation kept", "success");
-          return;
-        }
-        if (archiveSession?.(scope.sessionId) !== true) return;
-        row.hidden = true;
-        onArchived();
-      } catch {
-        notify("Could not save your choice in this browser. Please try again.", "failed");
-      }
-    }
-
-    for (const [action, label] of [["keep", "Keep"], ["archive", "Not interested"]]) {
-      const button = documentRoot.createElement("button");
-      button.type = "button";
-      button.textContent = label;
-      button.className = "spark-conversation-choice";
-      if (action === "archive") button.title = "Archive this conversation in this browser";
-      button.addEventListener("click", () => choose(action));
-      row.appendChild(button);
-    }
-    return row;
-  }
-
-  return { createNode };
-}

package/dist/src/web-ui/app/services/spark-conversation-preferences.js

@@ -1,27 +0,0 @@
-const storageKey = "abot-web.keptSparkConversations";
-const receiptLimit = 500;
-
-export function createSparkConversationPreferences(storage) {
-  function receipts() {
-    try {
-      const value = JSON.parse(storage.getItem(storageKey) || "[]");
-      return Array.isArray(value)
-        ? value.filter((key) => typeof key === "string").slice(-receiptLimit)
-        : [];
-    } catch {
-      return [];
-    }
-  }
-
-  const keyFor = (environmentId, sessionId) => JSON.stringify([environmentId, sessionId]);
-  return {
-    hasKeptSparkConversation(environmentId, sessionId) {
-      return receipts().includes(keyFor(environmentId, sessionId));
-    },
-    keepSparkConversation(environmentId, sessionId) {
-      const key = keyFor(environmentId, sessionId);
-      const kept = receipts().filter((value) => value !== key);
-      storage.setItem(storageKey, JSON.stringify([...kept, key].slice(-receiptLimit)));
-    },
-  };
-}

package/dist/src/web-ui/app/styles/29-spark-conversation.css

@@ -1,19 +0,0 @@
-.spark-conversation-actions {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 8px;
-  margin-top: 14px;
-}
-
-.spark-conversation-actions[hidden] { display: none; }
-
-.spark-conversation-choice {
-  min-height: 32px;
-  padding: 5px 11px;
-  border-color: var(--line);
-  background: var(--panel-soft);
-  color: var(--text);
-  font-size: var(--font-size-sm);
-  font-weight: 400;
-  box-shadow: none;
-}