@narumitw/pi-sync 0.54.3 → 0.56.0

package/src/ui/agent-mode-setting.ts

@@ -0,0 +1,91 @@
+import { isDeepStrictEqual } from "node:util";
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { requireSettings, updateLocalConfig } from "../settings/settings-store.js";
+import { captureMutationOwner } from "../sync/sync-local.js";
+import { confirmMergeReview } from "./merge-review.js";
+import { safeTerminalText } from "./terminal-text.js";
+
+export const AGENT_MODE_DESCRIPTION =
+  "This setup, experimental: one autonomous merged sync next startup and on Sync now. Sends eligible conflict text to the selected Pi model; may incur costs and replace/delete selected local and remote content without transfer prompts. No automatic reload. Unsupported conflicts pause.";
+
+export const CONTINUOUS_DESCRIPTION =
+  "This setup, experimental: recurring sync while Pi is open. Requires Agent mode. Watches selected files, checks the remote every 60–66 seconds, and retries temporary failures. Local changes and retries can cause extra requests between polls. May disclose conflict text and incur model/storage costs. No automatic reload.";
+
+export function saveContinuousMode(
+  ctx: ExtensionCommandContext,
+  setupName: string,
+  enabled: boolean,
+  signal?: AbortSignal,
+) {
+  return saveAgentMode(ctx, setupName, enabled, signal, "continuous");
+}
+
+export async function saveAgentMode(
+  ctx: ExtensionCommandContext,
+  setupName: string,
+  enabled: boolean,
+  signal?: AbortSignal,
+  preference: "agentMode" | "continuous" = "agentMode",
+) {
+  const validate = captureMutationOwner(ctx, signal);
+  const settings = await requireSettings();
+  validate();
+  const setup = settings.syncSetups[setupName];
+  if (!setup || settings.activeSyncSetup !== setupName) throw new Error("Current sync setup changed; reopen Settings.");
+  const continuous = preference === "continuous";
+  const label = continuous ? "Continuous sync" : "Agent mode";
+  if (enabled && continuous && !setup.sync.agentMode) throw new Error("Enable Agent mode before Continuous sync.");
+  if (Boolean(setup.sync[preference]) === enabled) return true;
+  if (enabled) {
+    const summary = [
+      `Setup: ${safeTerminalText(setupName)}`,
+      `Storage connection: ${safeTerminalText(setup.storage.connection)}`,
+      `Storage path: ${safeTerminalText(setup.storage.path)}`,
+      ...(setup.storage.bucket ? [`Bucket: ${safeTerminalText(String(setup.storage.bucket))}`] : []),
+      ...(setup.storage.branch ? [`Branch: ${safeTerminalText(String(setup.storage.branch))}`] : []),
+      `Included paths: ${setup.sync.include.map(safeTerminalText).join(", ")}`,
+      continuous ? CONTINUOUS_DESCRIPTION : AGENT_MODE_DESCRIPTION,
+      ...(continuous
+        ? [
+            "Upgrade all Pi processes sharing this agent directory before enabling Continuous sync. Monitoring starts after the /sync command or manager closes. An elected idle local session uses its selected Pi model; another session can use a different provider/model. Each computer is a separate replica.",
+            "Automatic requests are limited to two per candidate and two per replica binding in a rolling 15-minute window, across restarts. Network/storage checks and requests may incur costs. Retries start at five seconds and grow to five minutes. These are request bounds, not a currency cap.",
+          ]
+        : setup.sync.continuous
+          ? ["The saved Continuous sync preference will resume monitoring after the /sync command or manager closes."]
+          : []),
+      "Only bounded Markdown/plain-text conflicts and atomic global settings choices are eligible. Model errors can change intended behavior. Session histories, code, deletion conflicts and path collisions are not model-resolved.",
+      "The existing baseline, selection, secret-scan and publication checks remain. Pi Sync cannot exclude arbitrary concurrent local writers. Disabling does not undo completed transfers or provider charges. No transfer starts from Settings.",
+    ].join("\n\n");
+    if (
+      !(await confirmMergeReview(
+        ctx,
+        `Enable experimental ${label}?`,
+        summary,
+        signal,
+        () => !signal?.aborted,
+        `Enable ${label}`,
+        summary.split("\n"),
+      ))
+    )
+      return false;
+    validate();
+  }
+  await updateLocalConfig((current) => {
+    validate();
+    if (
+      current.activeSyncSetup !== setupName ||
+      !isDeepStrictEqual(current.syncSetups[setupName], setup) ||
+      !isDeepStrictEqual(
+        current.storageConnections[setup.storage.connection],
+        settings.storageConnections[setup.storage.connection],
+      )
+    )
+      throw new Error("Sync setup or connection changed during Agent mode review; reopen Settings.");
+    return {
+      ...current,
+      syncSetups: { ...current.syncSetups, [setupName]: { ...setup, sync: { ...setup.sync, [preference]: enabled } } },
+    };
+  }, signal);
+  // The atomic writer has committed. Later cancellation cannot undo this save.
+  return true;
+}

package/src/ui/manager-state.ts

@@ -163,6 +163,8 @@ export async function describeManagerState(
       `Included: ${selection.builtIns.length} built-in group${selection.builtIns.length === 1 ? "" : "s"} · ${selection.custom.length} extra path${selection.custom.length === 1 ? "" : "s"} · Sessions ${selection.sessions ? "on" : "off"}`,
       `Automatic sync: ${automaticSyncSummary(config.automatic)}`,
       `Startup transfer: ${startupTransferSummary(config)}`,
+      `Agent mode: ${config.agentMode ? "On (experimental; autonomous merged sync)" : "Off"}`,
+      ...(config.continuous ? await (await import("../sync/continuous-record.js")).continuousStatusLines(config) : []),
       `Last applied: ${lastAppliedSnapshot}`,
       ...(noSyncedContent
         ? ["", "No included content is selected. Choose included content in Settings before syncing."]

package/src/ui/remote-selection-ui.ts

@@ -11,6 +11,7 @@ import {
 import { SyncSetupReviewChangedError, updateSyncSetup } from "../settings/settings-management.js";
 import type { AnySyncConfig, PartialConfig } from "../settings/settings-types.js";
 import { readSnapshotForHead } from "../sync/remote-snapshot.js";
+import { throwIfAborted } from "../sync/signals.js";
 import { errorMessage } from "../sync/sync-errors.js";
 import {
   compareSyncInclude,
@@ -240,6 +241,8 @@ async function showSelectionDifference(
             include: [...state.decision.remoteInclude],
             automatic: review.config.automatic,
             automaticTransfer: review.config.automaticTransfer,
+            agentMode: review.config.agentMode,
+            continuous: review.config.continuous,
             onSwitch: review.config.onSwitch,
             showStatus: review.config.showStatus,
           };
@@ -592,6 +595,8 @@ function sameContinuationReview(left: PartialConfig, right: PartialConfig) {
     left.storagePath === right.storagePath &&
     left.bucket === right.bucket &&
     left.branch === right.branch &&
+    Boolean(left.agentMode) === Boolean(right.agentMode) &&
+    Boolean(left.continuous) === Boolean(right.continuous) &&
     sameSyncInclude(left.include, right.include)
   );
 }
@@ -639,8 +644,3 @@ function runWithOptionalStateAccess<T>(
 function combineSignals(sessionSignal: AbortSignal | undefined, actionSignal: AbortSignal) {
   return sessionSignal ? AbortSignal.any([sessionSignal, actionSignal]) : actionSignal;
 }
-
-function throwIfAborted(signal: AbortSignal) {
-  if (!signal.aborted) return;
-  throw signal.reason instanceof Error ? signal.reason : new DOMException("The operation was aborted", "AbortError");
-}

package/src/ui/settings-ui.ts

@@ -12,6 +12,12 @@ import {
   setupSwitchActionLabel,
 } from "../sync/setup-switch.js";
 import { captureMutationOwner } from "../sync/sync-local.js";
+import {
+  AGENT_MODE_DESCRIPTION,
+  CONTINUOUS_DESCRIPTION,
+  saveAgentMode,
+  saveContinuousMode,
+} from "./agent-mode-setting.js";
 import type { RunRoute } from "./cancellable-operation.js";
 import { dispatchManagerResult } from "./manager-result-dispatcher.js";
 import { boundedSettingsUI } from "./settings-frame.js";
@@ -71,6 +77,8 @@ export async function showSyncSettings(
   type Action =
     | "automatic"
     | "automatic-transfer"
+    | "agent-mode"
+    | "continuous"
     | "merge-settings"
     | "local-fields"
     | "content-policy"
@@ -87,7 +95,10 @@ export async function showSyncSettings(
   type Screen = "categories" | Group;
   const groups: Record<Group, { label: string; ids: readonly string[] }> = {
     content: { label: "Sync content", ids: ["include", "remoteInclude", "localFields"] },
-    behavior: { label: "Sync behavior", ids: ["automatic", "automaticTransfer", "onSwitch"] },
+    behavior: {
+      label: "Sync behavior",
+      ids: ["automatic", "automaticTransfer", "agentMode", "continuous", "onSwitch"],
+    },
     storage: { label: "Storage & setups", ids: ["storageLocation", "setups", "connections"] },
     advanced: { label: "Advanced", ids: ["mergeSettings", "contentPolicy", "skipSecretScan", "showStatus", "debug"] },
     all: { label: "All settings (search)", ids: [] },
@@ -174,6 +185,22 @@ export async function showSyncSettings(
             values: ["On", "Off"],
             action: "automatic-transfer",
           },
+          {
+            id: "agentMode",
+            label: "Agent mode (experimental)",
+            description: AGENT_MODE_DESCRIPTION,
+            currentValue: state.agentMode ? "On" : "Off",
+            values: ["On", "Off"],
+            action: "agent-mode",
+          },
+          {
+            id: "continuous",
+            label: "Continuous sync (experimental)",
+            description: `${CONTINUOUS_DESCRIPTION}${state.continuous && !state.agentMode ? " Saved On, but paused until Agent mode is enabled." : ""}`,
+            currentValue: state.continuous ? "On" : "Off",
+            values: ["On", "Off"],
+            action: "continuous",
+          },
           {
             id: "onSwitch",
             label: "On setup switch",
@@ -413,6 +440,61 @@ export async function showSyncSettings(
           return { kind: "rejected" };
         }
       },
+      "agent-mode": async ({ value, signal: actionSignal }) => {
+        const mutationSignal = signal ? AbortSignal.any([signal, actionSignal]) : actionSignal;
+        const validate = captureMutationOwner(ctx, mutationSignal);
+        try {
+          const saved = await saveAgentMode(ctx, setupName, value === "On", mutationSignal);
+          if (!saved) return { kind: "rejected" };
+          try {
+            validate();
+            ctx.ui.notify(
+              "Agent mode saved. Applies to subsequent sync and the next session start; no transfer started.",
+              "info",
+            );
+          } catch {
+            // The save committed. A closed or replaced UI must not report a failed save.
+            // The next Settings read shows the persisted value.
+          }
+          return { kind: "stay" };
+        } catch (error) {
+          try {
+            validate();
+          } catch {
+            return { kind: "rejected" };
+          }
+          notifySaveFailure(ctx, error);
+          return { kind: "rejected" };
+        }
+      },
+      continuous: async ({ value, signal: actionSignal }) => {
+        const mutationSignal = signal ? AbortSignal.any([signal, actionSignal]) : actionSignal;
+        const validate = captureMutationOwner(ctx, mutationSignal);
+        try {
+          const saved = await saveContinuousMode(ctx, setupName, value === "On", mutationSignal);
+          if (!saved) return { kind: "rejected" };
+          try {
+            validate();
+            ctx.ui.notify(
+              value === "On"
+                ? "Continuous sync enabled. Monitoring starts after the /sync command or manager closes; completed work is not undone."
+                : "Continuous sync disabled. Completed work is not undone.",
+              "info",
+            );
+          } catch {
+            /* committed save; do not use stale UI */
+          }
+          return { kind: "stay" };
+        } catch (error) {
+          try {
+            validate();
+          } catch {
+            return { kind: "rejected" };
+          }
+          notifySaveFailure(ctx, error);
+          return { kind: "rejected" };
+        }
+      },
       "automatic-transfer": async ({ value, signal: actionSignal }) => {
         const automaticTransfer = value === "On";
         const mutationSignal = signal ? AbortSignal.any([signal, actionSignal]) : actionSignal;

package/src/ui/setup/s3-credentials-ui.ts

@@ -1,4 +1,5 @@
 import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { throwIfAborted } from "../../sync/signals.js";
 import { promptSecret } from "../secret-input.js";
 import { requiredValueInput } from "./text-input.js";
 
@@ -70,8 +71,3 @@ export async function chooseS3Credentials(
     ready: true,
   };
 }
-
-function throwIfAborted(signal?: AbortSignal) {
-  if (!signal?.aborted) return;
-  throw signal.reason instanceof Error ? signal.reason : new DOMException("The operation was aborted", "AbortError");
-}

package/src/ui/setup/setup-name-ui.ts

@@ -1,5 +1,6 @@
 import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 import { validateConfigName } from "../../settings/settings-validation.js";
+import { throwIfAborted } from "../../sync/signals.js";
 import { errorMessage } from "../../sync/sync-errors.js";
 import { safeTerminalText } from "../terminal-text.js";
 
@@ -10,11 +11,7 @@ export async function promptInitialSetupName(ctx: ExtensionCommandContext, signa
     const guidance = ctx.mode === "tui" ? ctx.ui.theme.fg("muted", hint) : hint;
     // This compact prompt owns its default hint; the general helper would repeat it.
     const value = await ctx.ui.input(`Sync setup name\n${guidance}`, undefined, { signal });
-    if (signal?.aborted) {
-      throw signal.reason instanceof Error
-        ? signal.reason
-        : new DOMException("The operation was aborted", "AbortError");
-    }
+    throwIfAborted(signal);
     if (value === undefined) return undefined;
     const name = value.trim() || "default";
     try {

package/src/ui/setup/setup-switcher.ts

@@ -129,6 +129,8 @@ export async function showSetupSwitcher(
       `Included content: ${config.include.length} paths`,
       `Automatic sync: ${automaticSyncSummary(config.automatic)} · Sessions: ${config.include.includes("sessions") ? "On" : "Off"}`,
       `Automatic transfer at startup: ${config.automaticTransfer ? "On — may upload, replace, or delete selected files; no reload" : "Off"}`,
+      `Agent mode: ${config.agentMode ? "On (experimental; autonomous merged sync)" : "Off"}`,
+      `Continuous sync: ${config.continuous ? (config.agentMode ? "On (experimental; recurring requests and transfers)" : "Saved On; paused until Agent mode is enabled") : "Off"}`,
       "",
       switchEffect,
     ].join("\n"),

package/src/ui/sync-setups-ui.ts

@@ -3,6 +3,7 @@ import { defineMenu, runMenu } from "@narumitw/pi-tui-kit";
 import { loadConfig } from "../settings/config.js";
 import { readLocalConfigObject } from "../settings/settings-store.js";
 import { ownRecord } from "../settings/settings-validation.js";
+import { throwIfAborted } from "../sync/signals.js";
 import { syncErrorGuidance } from "../sync/sync-error-guidance.js";
 import { syncIncludeSelection } from "../sync/sync-policy.js";
 import { safeTerminalText } from "./terminal-text.js";
@@ -24,11 +25,6 @@ export async function countValidSyncSetups(setups: Record<string, unknown> | und
   return count;
 }
 
-function throwIfAborted(signal?: AbortSignal) {
-  if (!signal?.aborted) return;
-  throw signal.reason instanceof Error ? signal.reason : new DOMException("The operation was aborted", "AbortError");
-}
-
 type SyncSetupActions = {
   add(signal?: AbortSignal): Promise<void>;
   edit(name: string, signal?: AbortSignal): Promise<void>;
@@ -197,6 +193,8 @@ async function loadSetupMenuState(selectedName: string | undefined, signal?: Abo
       `Sessions: ${selection.sessions ? "On — privacy-sensitive" : "Off"}`,
       `Automatic sync: ${config.automatic ? "On" : "Off"}`,
       `Automatic transfer at startup: ${config.automaticTransfer ? "On — may upload, replace, or delete selected files; no reload" : "Off"}`,
+      `Agent mode: ${config.agentMode ? "On (experimental; autonomous merged sync)" : "Off"}`,
+      `Continuous sync: ${config.continuous ? (config.agentMode ? "On (experimental; recurring requests and transfers)" : "Saved On; paused until Agent mode is enabled") : "Off"}`,
       isCurrent
         ? "Edit included content and automatic sync in /sync → Settings."
         : "To edit included content or automatic sync, make this setup current, then open /sync → Settings.",