@alfe.ai/openclaw-sync 0.1.10 → 0.2.0

package/README.md

@@ -58,3 +58,8 @@ pnpm --filter @alfe.ai/openclaw-sync test
 - **micromatch** — glob pattern matching
 
 See [SKILL.md](./SKILL.md) for full CLI usage, storage classes, conflict resolution, and programmatic API docs.
+
+## Links
+
+- 🌐 Website: <https://alfe.ai>
+- 📚 Docs: <https://docs.alfe.ai>

package/dist/cli/index.cjs

@@ -29,7 +29,8 @@ function buildClient() {
 			apiKey: config.apiKey,
 			apiUrl: config.apiUrl
 		}),
-		workspacePath: config.workspacePath
+		workspacePath: config.workspacePath,
+		runtime: config.runtime
 	};
 }
 const program = new commander.Command();
@@ -49,10 +50,11 @@ program.command("register").description("Register this agent with the sync servi
 });
 program.command("push").description("Push local changes to remote").option("-q, --quiet", "Suppress output").option("-f, --filter <prefix>", "Only push files matching this prefix").action(async (opts) => {
 	try {
-		const { client, workspacePath } = buildClient();
+		const { client, workspacePath, runtime } = buildClient();
 		await require_sync_engine.createSyncEngine({
 			workspacePath,
-			client
+			client,
+			runtime
 		}).push(void 0, {
 			quiet: opts.quiet,
 			filter: opts.filter
@@ -64,10 +66,11 @@ program.command("push").description("Push local changes to remote").option("-q,
 });
 program.command("pull").description("Pull remote changes to local").option("-q, --quiet", "Suppress output").action(async (opts) => {
 	try {
-		const { client, workspacePath } = buildClient();
+		const { client, workspacePath, runtime } = buildClient();
 		await require_sync_engine.createSyncEngine({
 			workspacePath,
-			client
+			client,
+			runtime
 		}).pull({ quiet: opts.quiet });
 	} catch (err) {
 		console.error(err instanceof Error ? err.message : String(err));
@@ -137,8 +140,8 @@ program.command("conflicts").description("List conflict files in the workspace")
 });
 program.command("prune").description("Delete cloud files matching .alfesyncignore. Dry-run by default; pass --yes to actually delete.").option("-y, --yes", "Actually delete files (default is dry-run)").action(async (opts) => {
 	try {
-		const { client, workspacePath } = buildClient();
-		const ignorePatterns = await require_sync_engine.loadIgnorePatterns(workspacePath);
+		const { client, workspacePath, runtime } = buildClient();
+		const ignorePatterns = await require_sync_engine.loadIgnorePatterns(workspacePath, runtime);
 		const remoteManifest = await client.syncGetManifest();
 		const ignoredPaths = [];
 		for (const [path, entry] of Object.entries(remoteManifest.files)) if (require_sync_engine.shouldIgnore(path, ignorePatterns)) ignoredPaths.push({
@@ -162,7 +165,8 @@ program.command("prune").description("Delete cloud files matching .alfesyncignor
 		console.log(`Deleting ${String(ignoredPaths.length)} file(s) from cloud (${formatBytes(totalSize)})...`);
 		const result = await require_sync_engine.createSyncEngine({
 			workspacePath,
-			client
+			client,
+			runtime
 		}).pushDeletes(ignoredPaths.map((e) => e.path), { quiet: true });
 		console.log(`Prune complete: ${String(result.pushed)} deleted, ${String(result.errors)} failed.`);
 	} catch (err) {

package/dist/cli/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { l as diffManifests, o as loadIgnorePatterns, s as shouldIgnore, t as createSyncEngine, u as readManifest } from "../sync-engine.js";
+import { c as shouldIgnore, d as diffManifests, f as readManifest, s as loadIgnorePatterns, t as createSyncEngine } from "../sync-engine.js";
 import { readdir } from "node:fs/promises";
 import { join } from "node:path";
 import { configExists, resolveConfig } from "@alfe.ai/config";
@@ -29,7 +29,8 @@ function buildClient() {
 			apiKey: config.apiKey,
 			apiUrl: config.apiUrl
 		}),
-		workspacePath: config.workspacePath
+		workspacePath: config.workspacePath,
+		runtime: config.runtime
 	};
 }
 const program = new Command();
@@ -49,10 +50,11 @@ program.command("register").description("Register this agent with the sync servi
 });
 program.command("push").description("Push local changes to remote").option("-q, --quiet", "Suppress output").option("-f, --filter <prefix>", "Only push files matching this prefix").action(async (opts) => {
 	try {
-		const { client, workspacePath } = buildClient();
+		const { client, workspacePath, runtime } = buildClient();
 		await createSyncEngine({
 			workspacePath,
-			client
+			client,
+			runtime
 		}).push(void 0, {
 			quiet: opts.quiet,
 			filter: opts.filter
@@ -64,10 +66,11 @@ program.command("push").description("Push local changes to remote").option("-q,
 });
 program.command("pull").description("Pull remote changes to local").option("-q, --quiet", "Suppress output").action(async (opts) => {
 	try {
-		const { client, workspacePath } = buildClient();
+		const { client, workspacePath, runtime } = buildClient();
 		await createSyncEngine({
 			workspacePath,
-			client
+			client,
+			runtime
 		}).pull({ quiet: opts.quiet });
 	} catch (err) {
 		console.error(err instanceof Error ? err.message : String(err));
@@ -137,8 +140,8 @@ program.command("conflicts").description("List conflict files in the workspace")
 });
 program.command("prune").description("Delete cloud files matching .alfesyncignore. Dry-run by default; pass --yes to actually delete.").option("-y, --yes", "Actually delete files (default is dry-run)").action(async (opts) => {
 	try {
-		const { client, workspacePath } = buildClient();
-		const ignorePatterns = await loadIgnorePatterns(workspacePath);
+		const { client, workspacePath, runtime } = buildClient();
+		const ignorePatterns = await loadIgnorePatterns(workspacePath, runtime);
 		const remoteManifest = await client.syncGetManifest();
 		const ignoredPaths = [];
 		for (const [path, entry] of Object.entries(remoteManifest.files)) if (shouldIgnore(path, ignorePatterns)) ignoredPaths.push({
@@ -162,7 +165,8 @@ program.command("prune").description("Delete cloud files matching .alfesyncignor
 		console.log(`Deleting ${String(ignoredPaths.length)} file(s) from cloud (${formatBytes(totalSize)})...`);
 		const result = await createSyncEngine({
 			workspacePath,
-			client
+			client,
+			runtime
 		}).pushDeletes(ignoredPaths.map((e) => e.path), { quiet: true });
 		console.log(`Prune complete: ${String(result.pushed)} deleted, ${String(result.errors)} failed.`);
 	} catch (err) {

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["resolveAlfeConfig"],"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * AlfeSync CLI — `alfesync` command-line interface.\n *\n * Credentials come from `~/.alfe/config.toml` (set up via `alfe login`).\n * No separate sync init step is required.\n *\n * Commands:\n *   register   - Idempotently register this agent with the sync service\n *   push       - Push local changes to remote\n *   pull       - Pull remote changes to local\n *   status     - Show sync status and pending changes\n *   conflicts  - List conflict files\n *   prune      - Delete cloud files matching .alfesyncignore (dry-run by default)\n *   restore    - Restore agent workspace from remote\n */\n\nimport { Command } from \"commander\";\nimport { join } from \"node:path\";\nimport { readdir } from \"node:fs/promises\";\nimport { AgentApiClient } from \"@alfe.ai/agent-api-client\";\nimport { resolveConfig as resolveAlfeConfig, configExists } from \"@alfe.ai/config\";\nimport { createSyncEngine } from \"../sync-engine.js\";\nimport { readManifest, diffManifests } from \"../manifest.js\";\nimport { loadIgnorePatterns, shouldIgnore } from \"../ignore.js\";\n\nfunction buildClient(): { client: AgentApiClient; workspacePath: string } {\n  if (!configExists()) {\n    throw new Error(\"Alfe not configured — run `alfe login` first.\");\n  }\n  const config = resolveAlfeConfig();\n  return {\n    client: new AgentApiClient({ apiKey: config.apiKey, apiUrl: config.apiUrl }),\n    workspacePath: config.workspacePath,\n  };\n}\n\nconst program = new Command();\n\nprogram\n  .name(\"alfesync\")\n  .description(\"AlfeSync — agent workspace backup and sync\")\n  .version(\"1.0.0\");\n\n// ─── register ─────────────────────────────────────────────\n\nprogram\n  .command(\"register\")\n  .description(\"Register this agent with the sync service (idempotent)\")\n  .option(\"-n, --display-name <name>\", \"Display name for the agent\")\n  .action(async (opts: { displayName?: string }) => {\n    try {\n      const { client, workspacePath } = buildClient();\n      const result = await client.syncRegister(\n        opts.displayName ? { displayName: opts.displayName } : undefined,\n      );\n      console.log(\"✓ Agent registered with AlfeSync\");\n      console.log(`  Agent:     ${result.agent.agentId}`);\n      console.log(`  Org:       ${result.agent.tenantId}`);\n      console.log(`  Workspace: ${workspacePath}`);\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── push ─────────────────────────────────────────────────\n\nprogram\n  .command(\"push\")\n  .description(\"Push local changes to remote\")\n  .option(\"-q, --quiet\", \"Suppress output\")\n  .option(\"-f, --filter <prefix>\", \"Only push files matching this prefix\")\n  .action(async (opts: { quiet?: boolean; filter?: string }) => {\n    try {\n      const { client, workspacePath } = buildClient();\n      const engine = createSyncEngine({ workspacePath, client });\n      await engine.push(undefined, { quiet: opts.quiet, filter: opts.filter });\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── pull ─────────────────────────────────────────────────\n\nprogram\n  .command(\"pull\")\n  .description(\"Pull remote changes to local\")\n  .option(\"-q, --quiet\", \"Suppress output\")\n  .action(async (opts: { quiet?: boolean }) => {\n    try {\n      const { client, workspacePath } = buildClient();\n      const engine = createSyncEngine({ workspacePath, client });\n      await engine.pull({ quiet: opts.quiet });\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── status ───────────────────────────────────────────────\n\nprogram\n  .command(\"status\")\n  .description(\"Show sync status and pending changes\")\n  .action(async () => {\n    try {\n      const { client, workspacePath } = buildClient();\n      const [localManifest, remoteManifest, stats] = await Promise.all([\n        readManifest(workspacePath),\n        client.syncGetManifest(),\n        client.syncGetStats(),\n      ]);\n      const diff = diffManifests(localManifest, remoteManifest);\n\n      console.log(\"AlfeSync Status\");\n      console.log(\"═══════════════\");\n      console.log(`Agent:          ${stats.agentId}`);\n      console.log(`Workspace:      ${workspacePath}`);\n      console.log(\"\");\n\n      console.log(\"Storage:\");\n      console.log(`  Standard:     ${formatBytes(stats.standardBytes)}`);\n      console.log(`  Glacier IR:   ${formatBytes(stats.glacierBytes)}`);\n      console.log(`  Total files:  ${String(stats.fileCount)}`);\n      console.log(`  Last sync:    ${stats.lastSyncAt ?? \"never\"}`);\n      console.log(\"\");\n\n      console.log(\"Pending Changes:\");\n      console.log(`  To push:      ${String(diff.toPush.length)}`);\n      console.log(`  To pull:      ${String(diff.toPull.length)}`);\n      console.log(`  Conflicts:    ${String(diff.conflicts.length)}`);\n\n      if (diff.toPush.length > 0) {\n        console.log(\"\");\n        console.log(\"Files to push:\");\n        for (const p of diff.toPush.slice(0, 20)) console.log(`  ↑ ${p}`);\n        if (diff.toPush.length > 20) {\n          console.log(`  ... and ${String(diff.toPush.length - 20)} more`);\n        }\n      }\n\n      if (diff.toPull.length > 0) {\n        console.log(\"\");\n        console.log(\"Files to pull:\");\n        for (const p of diff.toPull.slice(0, 20)) console.log(`  ↓ ${p}`);\n        if (diff.toPull.length > 20) {\n          console.log(`  ... and ${String(diff.toPull.length - 20)} more`);\n        }\n      }\n\n      if (diff.conflicts.length > 0) {\n        console.log(\"\");\n        console.log(\"Conflicts:\");\n        for (const p of diff.conflicts) console.log(`  ⚡ ${p}`);\n      }\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── conflicts ────────────────────────────────────────────\n\nprogram\n  .command(\"conflicts\")\n  .description(\"List conflict files in the workspace\")\n  .action(async () => {\n    try {\n      const { workspacePath } = buildClient();\n      const conflicts = await findConflictFiles(workspacePath);\n      if (conflicts.length === 0) {\n        console.log(\"No conflict files found.\");\n        return;\n      }\n      console.log(`Found ${String(conflicts.length)} conflict file(s):`);\n      for (const f of conflicts) console.log(`  ⚡ ${f}`);\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── prune ────────────────────────────────────────────────\n\nprogram\n  .command(\"prune\")\n  .description(\n    \"Delete cloud files matching .alfesyncignore. Dry-run by default; pass --yes to actually delete.\",\n  )\n  .option(\"-y, --yes\", \"Actually delete files (default is dry-run)\")\n  .action(async (opts: { yes?: boolean }) => {\n    try {\n      const { client, workspacePath } = buildClient();\n      const ignorePatterns = await loadIgnorePatterns(workspacePath);\n      const remoteManifest = await client.syncGetManifest();\n\n      const ignoredPaths: { path: string; size: number }[] = [];\n      for (const [path, entry] of Object.entries(remoteManifest.files)) {\n        if (shouldIgnore(path, ignorePatterns)) {\n          ignoredPaths.push({ path, size: entry.size });\n        }\n      }\n\n      if (ignoredPaths.length === 0) {\n        console.log(\"Nothing to prune — no cloud files match .alfesyncignore.\");\n        return;\n      }\n\n      const totalSize = ignoredPaths.reduce((s, e) => s + e.size, 0);\n\n      if (!opts.yes) {\n        console.log(\n          `Dry-run: ${String(ignoredPaths.length)} cloud file(s) would be deleted (${formatBytes(totalSize)}).`,\n        );\n        console.log(\"\");\n        for (const { path, size } of ignoredPaths.slice(0, 50)) {\n          console.log(`  ✗ ${path} (${formatBytes(size)})`);\n        }\n        if (ignoredPaths.length > 50) {\n          console.log(`  ... and ${String(ignoredPaths.length - 50)} more`);\n        }\n        console.log(\"\");\n        console.log(\"Re-run with --yes to delete these files from the cloud.\");\n        return;\n      }\n\n      console.log(\n        `Deleting ${String(ignoredPaths.length)} file(s) from cloud (${formatBytes(totalSize)})...`,\n      );\n      const engine = createSyncEngine({ workspacePath, client });\n      const result = await engine.pushDeletes(\n        ignoredPaths.map((e) => e.path),\n        { quiet: true },\n      );\n      console.log(\n        `Prune complete: ${String(result.pushed)} deleted, ${String(result.errors)} failed.`,\n      );\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── restore ──────────────────────────────────────────────\n\nprogram\n  .command(\"restore\")\n  .description(\"Restore agent workspace from remote backup\")\n  .option(\"-m, --mode <mode>\", \"Restore mode: full, active, memory\", \"full\")\n  .option(\"-q, --quiet\", \"Suppress output\")\n  .action(async (opts: { mode?: string; quiet?: boolean }) => {\n    try {\n      const { client, workspacePath } = buildClient();\n      const mode = opts.mode as \"full\" | \"active\" | \"memory\";\n      if (![\"full\", \"active\", \"memory\"].includes(mode)) {\n        console.error(\"Error: mode must be full, active, or memory\");\n        process.exit(1);\n      }\n\n      if (!opts.quiet) console.log(`Restoring workspace (mode: ${mode})...`);\n      const bundle = await client.syncReconstruct({ mode });\n\n      if (!opts.quiet) {\n        console.log(\n          `Downloading ${String(bundle.fileCount)} files (${formatBytes(bundle.totalSize)})...`,\n        );\n      }\n\n      const { writeFile, mkdir } = await import(\"node:fs/promises\");\n      const { dirname } = await import(\"node:path\");\n\n      let downloaded = 0;\n      let errors = 0;\n      for (const file of bundle.files) {\n        try {\n          const response = await fetch(file.url);\n          if (!response.ok) throw new Error(`HTTP ${String(response.status)}`);\n          const buffer = Buffer.from(await response.arrayBuffer());\n          const absolutePath = join(workspacePath, file.path);\n          await mkdir(dirname(absolutePath), { recursive: true });\n          await writeFile(absolutePath, buffer);\n          downloaded++;\n          if (!opts.quiet) console.log(`  ↓ ${file.path} (${formatBytes(file.size)})`);\n        } catch (err) {\n          errors++;\n          if (!opts.quiet) {\n            console.error(\n              `  ✗ ${file.path}: ${err instanceof Error ? err.message : String(err)}`,\n            );\n          }\n        }\n      }\n\n      if (!opts.quiet) {\n        console.log(\n          `\\nRestore complete: ${String(downloaded)} files downloaded, ${String(errors)} errors.`,\n        );\n      }\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── Helpers ──────────────────────────────────────────────\n\nasync function findConflictFiles(dir: string, base?: string): Promise<string[]> {\n  const results: string[] = [];\n  const entries = await readdir(dir, { withFileTypes: true });\n  for (const entry of entries) {\n    if (entry.name === \"node_modules\" || entry.name === \".git\") continue;\n    const fullPath = join(dir, entry.name);\n    const relativePath = base ? join(base, entry.name) : entry.name;\n    if (entry.isDirectory()) {\n      const sub = await findConflictFiles(fullPath, relativePath);\n      results.push(...sub);\n    } else if (entry.name.includes(\".conflict-\")) {\n      results.push(relativePath);\n    }\n  }\n  return results;\n}\n\nfunction formatBytes(bytes: number): string {\n  if (bytes < 1024) return `${String(bytes)} B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;\n  if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n  return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GB`;\n}\n\n// ─── Run ──────────────────────────────────────────────────\n\nprogram.parse();\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["resolveAlfeConfig"],"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * AlfeSync CLI — `alfesync` command-line interface.\n *\n * Credentials come from `~/.alfe/config.toml` (set up via `alfe login`).\n * No separate sync init step is required.\n *\n * Commands:\n *   register   - Idempotently register this agent with the sync service\n *   push       - Push local changes to remote\n *   pull       - Pull remote changes to local\n *   status     - Show sync status and pending changes\n *   conflicts  - List conflict files\n *   prune      - Delete cloud files matching .alfesyncignore (dry-run by default)\n *   restore    - Restore agent workspace from remote\n */\n\nimport { Command } from \"commander\";\nimport { join } from \"node:path\";\nimport { readdir } from \"node:fs/promises\";\nimport { AgentApiClient } from \"@alfe.ai/agent-api-client\";\nimport { resolveConfig as resolveAlfeConfig, configExists } from \"@alfe.ai/config\";\nimport { createSyncEngine } from \"../sync-engine.js\";\nimport { readManifest, diffManifests } from \"../manifest.js\";\nimport { loadIgnorePatterns, shouldIgnore } from \"../ignore.js\";\n\nfunction buildClient(): { client: AgentApiClient; workspacePath: string; runtime: string } {\n  if (!configExists()) {\n    throw new Error(\"Alfe not configured — run `alfe login` first.\");\n  }\n  const config = resolveAlfeConfig();\n  return {\n    client: new AgentApiClient({ apiKey: config.apiKey, apiUrl: config.apiUrl }),\n    workspacePath: config.workspacePath,\n    runtime: config.runtime,\n  };\n}\n\nconst program = new Command();\n\nprogram\n  .name(\"alfesync\")\n  .description(\"AlfeSync — agent workspace backup and sync\")\n  .version(\"1.0.0\");\n\n// ─── register ─────────────────────────────────────────────\n\nprogram\n  .command(\"register\")\n  .description(\"Register this agent with the sync service (idempotent)\")\n  .option(\"-n, --display-name <name>\", \"Display name for the agent\")\n  .action(async (opts: { displayName?: string }) => {\n    try {\n      const { client, workspacePath } = buildClient();\n      const result = await client.syncRegister(\n        opts.displayName ? { displayName: opts.displayName } : undefined,\n      );\n      console.log(\"✓ Agent registered with AlfeSync\");\n      console.log(`  Agent:     ${result.agent.agentId}`);\n      console.log(`  Org:       ${result.agent.tenantId}`);\n      console.log(`  Workspace: ${workspacePath}`);\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── push ─────────────────────────────────────────────────\n\nprogram\n  .command(\"push\")\n  .description(\"Push local changes to remote\")\n  .option(\"-q, --quiet\", \"Suppress output\")\n  .option(\"-f, --filter <prefix>\", \"Only push files matching this prefix\")\n  .action(async (opts: { quiet?: boolean; filter?: string }) => {\n    try {\n      const { client, workspacePath, runtime } = buildClient();\n      const engine = createSyncEngine({ workspacePath, client, runtime });\n      await engine.push(undefined, { quiet: opts.quiet, filter: opts.filter });\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── pull ─────────────────────────────────────────────────\n\nprogram\n  .command(\"pull\")\n  .description(\"Pull remote changes to local\")\n  .option(\"-q, --quiet\", \"Suppress output\")\n  .action(async (opts: { quiet?: boolean }) => {\n    try {\n      const { client, workspacePath, runtime } = buildClient();\n      const engine = createSyncEngine({ workspacePath, client, runtime });\n      await engine.pull({ quiet: opts.quiet });\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── status ───────────────────────────────────────────────\n\nprogram\n  .command(\"status\")\n  .description(\"Show sync status and pending changes\")\n  .action(async () => {\n    try {\n      const { client, workspacePath } = buildClient();\n      const [localManifest, remoteManifest, stats] = await Promise.all([\n        readManifest(workspacePath),\n        client.syncGetManifest(),\n        client.syncGetStats(),\n      ]);\n      const diff = diffManifests(localManifest, remoteManifest);\n\n      console.log(\"AlfeSync Status\");\n      console.log(\"═══════════════\");\n      console.log(`Agent:          ${stats.agentId}`);\n      console.log(`Workspace:      ${workspacePath}`);\n      console.log(\"\");\n\n      console.log(\"Storage:\");\n      console.log(`  Standard:     ${formatBytes(stats.standardBytes)}`);\n      console.log(`  Glacier IR:   ${formatBytes(stats.glacierBytes)}`);\n      console.log(`  Total files:  ${String(stats.fileCount)}`);\n      console.log(`  Last sync:    ${stats.lastSyncAt ?? \"never\"}`);\n      console.log(\"\");\n\n      console.log(\"Pending Changes:\");\n      console.log(`  To push:      ${String(diff.toPush.length)}`);\n      console.log(`  To pull:      ${String(diff.toPull.length)}`);\n      console.log(`  Conflicts:    ${String(diff.conflicts.length)}`);\n\n      if (diff.toPush.length > 0) {\n        console.log(\"\");\n        console.log(\"Files to push:\");\n        for (const p of diff.toPush.slice(0, 20)) console.log(`  ↑ ${p}`);\n        if (diff.toPush.length > 20) {\n          console.log(`  ... and ${String(diff.toPush.length - 20)} more`);\n        }\n      }\n\n      if (diff.toPull.length > 0) {\n        console.log(\"\");\n        console.log(\"Files to pull:\");\n        for (const p of diff.toPull.slice(0, 20)) console.log(`  ↓ ${p}`);\n        if (diff.toPull.length > 20) {\n          console.log(`  ... and ${String(diff.toPull.length - 20)} more`);\n        }\n      }\n\n      if (diff.conflicts.length > 0) {\n        console.log(\"\");\n        console.log(\"Conflicts:\");\n        for (const p of diff.conflicts) console.log(`  ⚡ ${p}`);\n      }\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── conflicts ────────────────────────────────────────────\n\nprogram\n  .command(\"conflicts\")\n  .description(\"List conflict files in the workspace\")\n  .action(async () => {\n    try {\n      const { workspacePath } = buildClient();\n      const conflicts = await findConflictFiles(workspacePath);\n      if (conflicts.length === 0) {\n        console.log(\"No conflict files found.\");\n        return;\n      }\n      console.log(`Found ${String(conflicts.length)} conflict file(s):`);\n      for (const f of conflicts) console.log(`  ⚡ ${f}`);\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── prune ────────────────────────────────────────────────\n\nprogram\n  .command(\"prune\")\n  .description(\n    \"Delete cloud files matching .alfesyncignore. Dry-run by default; pass --yes to actually delete.\",\n  )\n  .option(\"-y, --yes\", \"Actually delete files (default is dry-run)\")\n  .action(async (opts: { yes?: boolean }) => {\n    try {\n      const { client, workspacePath, runtime } = buildClient();\n      const ignorePatterns = await loadIgnorePatterns(workspacePath, runtime);\n      const remoteManifest = await client.syncGetManifest();\n\n      const ignoredPaths: { path: string; size: number }[] = [];\n      for (const [path, entry] of Object.entries(remoteManifest.files)) {\n        if (shouldIgnore(path, ignorePatterns)) {\n          ignoredPaths.push({ path, size: entry.size });\n        }\n      }\n\n      if (ignoredPaths.length === 0) {\n        console.log(\"Nothing to prune — no cloud files match .alfesyncignore.\");\n        return;\n      }\n\n      const totalSize = ignoredPaths.reduce((s, e) => s + e.size, 0);\n\n      if (!opts.yes) {\n        console.log(\n          `Dry-run: ${String(ignoredPaths.length)} cloud file(s) would be deleted (${formatBytes(totalSize)}).`,\n        );\n        console.log(\"\");\n        for (const { path, size } of ignoredPaths.slice(0, 50)) {\n          console.log(`  ✗ ${path} (${formatBytes(size)})`);\n        }\n        if (ignoredPaths.length > 50) {\n          console.log(`  ... and ${String(ignoredPaths.length - 50)} more`);\n        }\n        console.log(\"\");\n        console.log(\"Re-run with --yes to delete these files from the cloud.\");\n        return;\n      }\n\n      console.log(\n        `Deleting ${String(ignoredPaths.length)} file(s) from cloud (${formatBytes(totalSize)})...`,\n      );\n      const engine = createSyncEngine({ workspacePath, client, runtime });\n      const result = await engine.pushDeletes(\n        ignoredPaths.map((e) => e.path),\n        { quiet: true },\n      );\n      console.log(\n        `Prune complete: ${String(result.pushed)} deleted, ${String(result.errors)} failed.`,\n      );\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── restore ──────────────────────────────────────────────\n\nprogram\n  .command(\"restore\")\n  .description(\"Restore agent workspace from remote backup\")\n  .option(\"-m, --mode <mode>\", \"Restore mode: full, active, memory\", \"full\")\n  .option(\"-q, --quiet\", \"Suppress output\")\n  .action(async (opts: { mode?: string; quiet?: boolean }) => {\n    try {\n      const { client, workspacePath } = buildClient();\n      const mode = opts.mode as \"full\" | \"active\" | \"memory\";\n      if (![\"full\", \"active\", \"memory\"].includes(mode)) {\n        console.error(\"Error: mode must be full, active, or memory\");\n        process.exit(1);\n      }\n\n      if (!opts.quiet) console.log(`Restoring workspace (mode: ${mode})...`);\n      const bundle = await client.syncReconstruct({ mode });\n\n      if (!opts.quiet) {\n        console.log(\n          `Downloading ${String(bundle.fileCount)} files (${formatBytes(bundle.totalSize)})...`,\n        );\n      }\n\n      const { writeFile, mkdir } = await import(\"node:fs/promises\");\n      const { dirname } = await import(\"node:path\");\n\n      let downloaded = 0;\n      let errors = 0;\n      for (const file of bundle.files) {\n        try {\n          const response = await fetch(file.url);\n          if (!response.ok) throw new Error(`HTTP ${String(response.status)}`);\n          const buffer = Buffer.from(await response.arrayBuffer());\n          const absolutePath = join(workspacePath, file.path);\n          await mkdir(dirname(absolutePath), { recursive: true });\n          await writeFile(absolutePath, buffer);\n          downloaded++;\n          if (!opts.quiet) console.log(`  ↓ ${file.path} (${formatBytes(file.size)})`);\n        } catch (err) {\n          errors++;\n          if (!opts.quiet) {\n            console.error(\n              `  ✗ ${file.path}: ${err instanceof Error ? err.message : String(err)}`,\n            );\n          }\n        }\n      }\n\n      if (!opts.quiet) {\n        console.log(\n          `\\nRestore complete: ${String(downloaded)} files downloaded, ${String(errors)} errors.`,\n        );\n      }\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\n// ─── Helpers ──────────────────────────────────────────────\n\nasync function findConflictFiles(dir: string, base?: string): Promise<string[]> {\n  const results: string[] = [];\n  const entries = await readdir(dir, { withFileTypes: true });\n  for (const entry of entries) {\n    if (entry.name === \"node_modules\" || entry.name === \".git\") continue;\n    const fullPath = join(dir, entry.name);\n    const relativePath = base ? join(base, entry.name) : entry.name;\n    if (entry.isDirectory()) {\n      const sub = await findConflictFiles(fullPath, relativePath);\n      results.push(...sub);\n    } else if (entry.name.includes(\".conflict-\")) {\n      results.push(relativePath);\n    }\n  }\n  return results;\n}\n\nfunction formatBytes(bytes: number): string {\n  if (bytes < 1024) return `${String(bytes)} B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;\n  if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n  return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GB`;\n}\n\n// ─── Run ──────────────────────────────────────────────────\n\nprogram.parse();\n"],"mappings":"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"}

package/dist/defaults/common.alfesyncignore

@@ -0,0 +1,43 @@
+# AlfeSync default ignores — applied to EVERY runtime.
+#
+# Source of truth for the sync's baseline ignore set (previously the hardcoded
+# DEFAULT_IGNORES array). Entries are full micromatch globs, NOT gitignore
+# shorthand — they are used verbatim (the workspace `.alfesyncignore` is the
+# gitignore-shorthand surface). Match a name at any depth with a `**/` prefix;
+# `matchBase` is never used (it breaks deep `**/X/**` in micromatch 4.x).
+#
+# Categories:
+#   VCS / build / package metadata; OS + editor noise; sync-internal backstop;
+#   secrets (never sync); OpenClaw config-rotation backups; Chromium/Electron
+#   browser caches (zero restore value, tens of MB); language churn.
+
+**/.alfesync/**
+# shared/ mirrors org/team/project files (OrgFilesBucket) into the workspace via
+# shared-sync — the PRIVATE backup must not re-store them into SyncBucket, or a
+# rebuild would restore stale shared files from the wrong bucket. Root-anchored
+# to the runtime home; a nested user `workspace/shared/` still syncs.
+shared/**
+**/node_modules/**
+**/*.tmp
+**/.DS_Store
+**/.git/**
+**/.sst/**
+**/.build/**
+**/dist/**
+**/.env
+**/.env.*
+**/openclaw.json.bak*
+**/openclaw.json.clobbered.*
+**/openclaw.json.preserve.*
+**/Cache/**
+**/Code Cache/**
+**/GPUCache/**
+**/CacheStorage/**
+**/Service Worker/CacheStorage/**
+**/blob_storage/**
+**/Crashpad/**
+**/ShaderCache/**
+**/component_crx_cache/**
+**/__pycache__/**
+**/*.pyc
+**/*.log

package/dist/defaults/hermes.alfesyncignore

@@ -0,0 +1,14 @@
+# AlfeSync default ignores — Hermes runtime only.
+#
+# The sync watches the Hermes runtime HOME (~/.hermes), whose top level holds
+# the Python venv and the installed agent code as siblings of user files.
+# Large / high-churn / regenerable — never sync.
+#
+# `.venv/` is matched at any depth (nested venvs are common); `hermes-agent/`
+# is root-anchored to the runtime home. Full micromatch globs, used verbatim.
+# (`__pycache__` and `*.pyc` are already covered by the common set.)
+
+# Python virtual environment
+**/.venv/**
+# Hermes runtime code installed by the installer: ~/.hermes/hermes-agent/...
+hermes-agent/**

package/dist/defaults/openclaw.alfesyncignore

@@ -0,0 +1,17 @@
+# AlfeSync default ignores — OpenClaw runtime only.
+#
+# The sync watches the OpenClaw runtime HOME (~/.openclaw), whose top level
+# holds runtime-internal dirs as siblings of the agent-owned `workspace/`.
+# These are large, high-churn, and have zero restore value — if synced they
+# exhaust the OS inotify watch limit and crash-loop the runtime.
+#
+# Root-anchored (no `**/` prefix) so they only match the runtime home's top
+# level — a user dir named `plugins/` deeper in the workspace still syncs.
+# Full micromatch globs, used verbatim.
+
+# npm plugin registry (OpenClaw 2026.5+): ~/.openclaw/npm/node_modules/...
+npm/**
+# Plugin extension installs (OpenClaw 2026.4): ~/.openclaw/extensions/...
+extensions/**
+# Plugin install metadata (installs.json etc.): ~/.openclaw/plugins/...
+plugins/**

package/dist/index.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sync_engine = require("./sync-engine.cjs");
 const require_plugin = require("./plugin2.cjs");
+exports.DEFAULT_IGNORES = require_sync_engine.DEFAULT_IGNORES;
 exports.computeFileHash = require_sync_engine.computeFileHash;
 exports.createSharedSyncEngine = require_plugin.createSharedSyncEngine;
 exports.createSyncEngine = require_sync_engine.createSyncEngine;
@@ -12,6 +13,7 @@ exports.plugin = require_plugin.plugin;
 exports.readManifest = require_sync_engine.readManifest;
 exports.removeManifestEntry = require_sync_engine.removeManifestEntry;
 exports.shouldIgnore = require_sync_engine.shouldIgnore;
+exports.shouldIgnoreDir = require_sync_engine.shouldIgnoreDir;
 exports.startWatcher = require_plugin.startWatcher;
 exports.updateManifestEntry = require_sync_engine.updateManifestEntry;
 exports.uploadFiles = require_sync_engine.uploadFiles;

package/dist/index.d.cts

@@ -81,8 +81,10 @@ declare function diffManifests(local: LocalManifest, remote: RemoteManifest): Ma
 //# sourceMappingURL=manifest.d.ts.map
 //#endregion
 //#region src/ignore.d.ts
-declare function loadIgnorePatterns(workspacePath: string): Promise<string[]>;
+declare const DEFAULT_IGNORES: string[];
+declare function loadIgnorePatterns(workspacePath: string, runtime?: string): Promise<string[]>;
 declare function shouldIgnore(relativePath: string, patterns: string[]): boolean;
+declare function shouldIgnoreDir(relativeDir: string, patterns: string[]): boolean;
 declare function filterIgnored(paths: string[], patterns: string[]): string[];
 //# sourceMappingURL=ignore.d.ts.map
 //#endregion
@@ -93,6 +95,15 @@ interface AgentApiClientConfig {
   apiKey: string;
   apiUrl: string;
 }
+interface RemoteSessionInfo {
+  sessionId: string;
+  agentId: string;
+  surface: "browser" | "terminal";
+  status: "agent_driving" | "awaiting_human" | "human_in_control" | "resuming" | "completed" | "expired" | "failed";
+  url?: string;
+  instructions?: string;
+  requestedAt?: string;
+}
 interface SyncAgentInfo {
   agentId: string;
   tenantId: string;
@@ -233,6 +244,79 @@ interface KnowledgeDoc {
   createdAt: string;
   updatedAt: string;
 }
+/** Voice settings — core agent config. Mirrors `VoiceConfig` in `@alfe/types`. */
+interface AgentVoiceConfig {
+  /** ElevenLabs voice ID; platform default when unset. */
+  voiceId?: string;
+  ttsModel?: string;
+  enabled?: boolean;
+}
+/**
+ * The agent's own public identity, as returned by `updateSelf`, `generateAvatar`,
+ * `presignAvatar`'s finalize (`finalizeAvatar`). This is the public agent
+ * projection; only the identity-relevant fields are typed here — the response
+ * carries the full public agent record.
+ */
+interface AgentSelf {
+  agentId: string;
+  tenantId: string;
+  name: string;
+  avatarUrl?: string;
+  voiceConfig?: AgentVoiceConfig;
+  status: string;
+}
+/** Result of `presignAvatar` — the agent PUTs bytes to `uploadUrl`, then finalizes with `s3Key`. */
+interface AgentAvatarPresign {
+  /** Presigned PUT URL to upload the image bytes to. */
+  uploadUrl: string;
+  /** Object key — echoed back to `finalizeAvatar`. */
+  s3Key: string;
+  /** Stable public URL the avatar will be served from once finalized. */
+  publicUrl: string;
+  /** ISO expiry of the presigned PUT URL. */
+  expiresAt: string;
+}
+/** A voice in the platform catalogue (ElevenLabs), from `listVoices`. */
+interface AgentVoice {
+  id: string;
+  name: string;
+  previewUrl: string;
+  description: string;
+  labels: Record<string, string>;
+  category: string;
+}
+/** The ElevenLabs models with a pricing row — the TTS endpoint rejects any other value. */
+type VoiceTtsModel = "eleven_turbo_v2_5" | "eleven_multilingual_v2";
+interface VoiceTtsArgs {
+  /** Text to synthesize (1–5000 chars — the endpoint enforces this). */
+  text: string;
+  /** ElevenLabs voice id; platform default when unset. */
+  voiceId?: string;
+  /** TTS model; `eleven_turbo_v2_5` (lower latency) when unset. */
+  model?: VoiceTtsModel;
+}
+/** Raw synthesized audio plus its PCM framing (from the response headers). */
+interface VoiceTtsResult {
+  /** Raw little-endian PCM samples — no container. Wrap in WAV to make a playable file. */
+  audio: Buffer;
+  /** Samples per second (e.g. 24000). */
+  sampleRate: number;
+  /** Channel count (mono = 1). */
+  channels: number;
+  /** Bits per sample (e.g. 16). */
+  bitDepth: number;
+}
+interface VoiceSttArgs {
+  /** Raw linear16 (16-bit little-endian) mono PCM samples — no WAV/container header. */
+  audio: Uint8Array;
+  /** Sample rate of `audio` in Hz (8000–48000). */
+  sampleRate: number;
+}
+interface VoiceSttResult {
+  text: string;
+  /** Deepgram confidence in (0,1]. */
+  confidence: number;
+}
 declare class AgentApiClient {
   private readonly apiKey;
   private readonly apiUrl;
@@ -756,6 +840,35 @@ declare class AgentApiClient {
   }): Promise<{
     recorded: boolean;
   }>;
+  /** Update the agent's own name and/or voice config. Returns the updated agent. */
+  updateSelf(update: {
+    name?: string;
+    voiceConfig?: AgentVoiceConfig;
+  }): Promise<AgentSelf>;
+  /**
+   * Generate the agent's own avatar from a text prompt. The image is generated,
+   * stored, and set on the agent server-side; returns the updated agent.
+   */
+  generateAvatar(args: {
+    prompt: string;
+  }): Promise<AgentSelf>;
+  /**
+   * Get a presigned PUT URL to upload a new avatar image. Upload the bytes to
+   * `uploadUrl`, then call `finalizeAvatar(s3Key)` to set it on the agent.
+   */
+  presignAvatar(args: {
+    mimeType: string;
+    size: number;
+  }): Promise<AgentAvatarPresign>;
+  /**
+   * Finalize an avatar upload — validates ownership + size, then sets the
+   * agent's `avatarUrl` server-side. Returns the updated agent.
+   */
+  finalizeAvatar(s3Key: string): Promise<AgentSelf>;
+  /** List the platform voice catalogue (ElevenLabs) so the agent can pick its own voice. */
+  listVoices(): Promise<{
+    voices: AgentVoice[];
+  }>;
   /**
    * Mint a fresh AES-256 data key for a specific (secret, field) pair. The
    * encryption context is rebuilt server-side from `auth.tenantId` + the body
@@ -1250,6 +1363,46 @@ declare class AgentApiClient {
     operation: string;
     summary?: string;
   }): Promise<void>;
+  requestBrowserTakeover(args: {
+    instructions: string;
+    url?: string;
+    conversationId?: string;
+  }): Promise<{
+    sessionId: string;
+    status: string;
+  }>;
+  getRemoteSession(sessionId: string): Promise<RemoteSessionInfo>;
+  completeRemoteSession(sessionId: string): Promise<{
+    ok: boolean;
+  }>;
+  /**
+   * Issue a request that returns the raw `Response` (no JSON parsing, no
+   * forced Content-Type). The caller sets `Content-Type`/`Accept` on `headers`
+   * and reads the body itself (`arrayBuffer()` / `json()`).
+   *
+   * A single retry fires only on the same transient statuses `request()`
+   * retries (authorizer-timeout 500 + LB 502/503/504) and transient network
+   * errors — before the route handler runs — so re-issuing a POST does not
+   * risk a duplicate side effect. Voice TTS/STT are effectively idempotent
+   * (re-synthesize / re-transcribe) and meter server-side keyed on the
+   * gateway requestId, so a retried transcription doesn't double-bill.
+   */
+  private rawFetch;
+  /**
+   * Text-to-speech. Returns raw PCM audio bytes plus their framing — the
+   * voice service defaults to 24 kHz / mono / 16-bit. Wrap in a WAV container
+   * to produce a playable file. Metered per character against the tenant
+   * credit pool server-side; TTS completes regardless of metering outcome.
+   */
+  tts(args: VoiceTtsArgs): Promise<VoiceTtsResult>;
+  /**
+   * Speech-to-text. Accepts raw linear16 (16-bit LE) mono PCM — NOT a WAV or
+   * other container (the endpoint transcribes with a fixed linear16 encoding,
+   * so a container header would be transcribed as noise). Strip any WAV header
+   * and pass `sampleRate` from it before calling. Metered by transcribed
+   * duration against the tenant credit pool server-side.
+   */
+  stt(args: VoiceSttArgs): Promise<VoiceSttResult>;
 }
 //# sourceMappingURL=index.d.ts.map
 //#endregion
@@ -1264,6 +1417,11 @@ interface SyncResult {
 interface SyncEngineOptions {
   workspacePath: string;
   client: AgentApiClient;
+  /**
+   * Active agent runtime — selects the per-runtime default ignore set used by
+   * every scan (push / fullSync / firstRunReconcile). Default: "openclaw".
+   */
+  runtime?: string;
 }
 /**
  * Construct a sync engine bound to a workspace + agent API client.
@@ -1273,10 +1431,12 @@ interface SyncEngineOptions {
  */
 declare function createSyncEngine({
   workspacePath,
-  client
+  client,
+  runtime
 }: SyncEngineOptions): {
   workspacePath: string;
   client: AgentApiClient;
+  runtime: string;
   /**
    * Upload changed files. Pass `paths` for an explicit list, or omit
    * to scan the workspace for anything that drifted from the manifest.
@@ -1299,6 +1459,36 @@ declare function createSyncEngine({
   fullSync(options?: {
     quiet?: boolean;
   }): Promise<SyncResult>;
+  /**
+   * First-run reconcile for realtime activation.
+   *
+   * Distinguishes a genuinely NEW agent (empty cloud state → push-only
+   * seed, today's behaviour) from a REBUILD / reconnect (cloud already
+   * holds this agent's last-synced state → restore cloud → local, cloud
+   * wins, THEN seed only the files that are new locally).
+   *
+   * Why not `push(undefined)`? On a from-scratch VM rebuild the local
+   * manifest is gone and `alfe setup` has just re-seeded the persona
+   * templates (SOUL.md, IDENTITY.md, …) onto a fresh disk. With no
+   * manifest, `detectLocalChanges()` classifies every seeded template as
+   * "new", so a blind push uploads those fresh seeds OVER the agent's
+   * edited cloud copy — the agent's edits are lost on every rebuild. This
+   * is the persona-durability gap this method closes.
+   *
+   * Why not `fullSync()`? With an empty local manifest it double-counts
+   * each on-disk seed as BOTH a push candidate (`detectLocalChanges`) and
+   * a pull candidate (remote-only in `diffManifests`, since the local
+   * manifest has no entry for it). fullSync pushes before it pulls, so it
+   * would still clobber the cloud edit before restoring it locally.
+   *
+   * Conflict direction: for a rebuild the CLOUD copy is authoritative for
+   * anything it holds. We do not write `.conflict-<ts>` markers here — a
+   * fresh setup seed losing to the agent's own prior edit is the intended
+   * outcome, not a conflict.
+   */
+  firstRunReconcile(options?: {
+    quiet?: boolean;
+  }): Promise<SyncResult>;
   /**
    * Pull a known list of files (used for relay-driven notifications,
    * where we already know which paths changed remotely).
@@ -1306,6 +1496,20 @@ declare function createSyncEngine({
   pullFiles(paths: string[], options?: {
     quiet?: boolean;
   }): Promise<SyncResult>;
+  /**
+   * Purge cloud files that match the current (per-runtime) ignore set.
+   *
+   * Self-heals workspaces whose cloud copy still holds runtime-internal junk
+   * (node_modules, the openclaw npm cache, …) that a pre-fix ignore engine
+   * uploaded before it was correctly ignored. Bounded to ignored paths only,
+   * so it can never delete a legitimately-synced file, and it deletes the
+   * cloud copy directly (not via the watcher) so the rolling-window delete
+   * brake — which guards against a buggy `rm -rf` — does not apply.
+   */
+  pruneIgnored(options?: {
+    quiet?: boolean;
+    limit?: number;
+  }): Promise<SyncResult>;
   /**
    * Delete a file locally and from the manifest. Used when the sync relay
    * tells us a file was removed remotely.
@@ -1326,6 +1530,12 @@ type SyncEngine = ReturnType<typeof createSyncEngine>;
  */
 interface WatcherOptions {
   workspacePath: string;
+  /**
+   * Active agent runtime — selects the per-runtime default ignore set so the
+   * watcher never descends into runtime-internal dirs (openclaw `npm/`,
+   * hermes `.venv/`, …). Default: "openclaw".
+   */
+  runtime?: string;
   /** Debounce delay per file in milliseconds. Default: 2000 */
   debounceMs?: number;
   /** Callback invoked with batches of changed relative paths */
@@ -1411,5 +1621,5 @@ interface SharedSyncEngine {
 }
 declare function createSharedSyncEngine(config: SharedSyncConfig, log: PluginLogger): SharedSyncEngine;
 //#endregion
-export { type DownloadResult, type LocalManifest, type ManifestDiff, type ManifestEntry, type RemoteManifest, type RetryOptions, type SharedScope, type SharedSyncConfig, type SharedSyncEngine, type SyncEngine, type SyncPluginConfig, type SyncResult, type UploadResult, type WatcherOptions, computeFileHash, createSharedSyncEngine, createSyncEngine, diffManifests, downloadFiles, filterIgnored, loadIgnorePatterns, plugin, readManifest, removeManifestEntry, shouldIgnore, startWatcher, updateManifestEntry, uploadFiles, withRetry, writeManifest };
+export { DEFAULT_IGNORES, type DownloadResult, type LocalManifest, type ManifestDiff, type ManifestEntry, type RemoteManifest, type RetryOptions, type SharedScope, type SharedSyncConfig, type SharedSyncEngine, type SyncEngine, type SyncPluginConfig, type SyncResult, type UploadResult, type WatcherOptions, computeFileHash, createSharedSyncEngine, createSyncEngine, diffManifests, downloadFiles, filterIgnored, loadIgnorePatterns, plugin, readManifest, removeManifestEntry, shouldIgnore, shouldIgnoreDir, startWatcher, updateManifestEntry, uploadFiles, withRetry, writeManifest };
 //# sourceMappingURL=index.d.cts.map