larkup 0.4.12 → 0.4.14

package/.next/standalone/apps/web/public/icons/vercel copy.svg

@@ -0,0 +1 @@
+<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Vercel</title><path d="M12 0l12 20.785H0L12 0z"></path></svg>

package/.next/standalone/apps/web/public/icons/vercel.svg

@@ -0,0 +1 @@
+<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Vercel</title><path d="M12 0l12 20.785H0L12 0z"></path></svg>

package/.next/standalone/apps/web/public/icons/webcontainers.svg

@@ -0,0 +1,11 @@
+<svg width="398" height="468" viewBox="0 0 398 468" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M290.354 55.3912L344.755 0.990234C360.154 16.3897 360.154 41.3571 344.755 56.7565L323.966 77.5454C313.582 69.0795 302.326 61.6428 290.354 55.3912ZM72.4057 384.871C28.1909 348.452 0 293.28 0 231.525C0 121.857 88.9037 32.953 198.572 32.953C231.684 32.953 262.903 41.0576 290.354 55.3912L184.169 161.576C168.769 176.976 168.769 201.943 184.169 217.342L323.966 77.5454C368.624 113.957 397.144 169.411 397.144 231.525C397.144 341.193 308.24 430.097 198.572 430.097C165.089 430.097 133.541 421.81 105.869 407.175L212.051 300.992C227.451 285.593 227.451 260.625 212.051 245.226L72.4057 384.871ZM72.4057 384.871C82.737 393.381 93.9431 400.867 105.869 407.175L46.0328 467.011C30.6334 451.611 30.6334 426.644 46.0328 411.244L72.4057 384.871Z" fill="#E9FAF8"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M290.354 55.3912L344.755 0.990234C360.154 16.3897 360.154 41.3571 344.755 56.7565L323.966 77.5454C313.582 69.0795 302.326 61.6428 290.354 55.3912ZM72.4057 384.871C28.1909 348.452 0 293.28 0 231.525C0 121.857 88.9037 32.953 198.572 32.953C231.684 32.953 262.903 41.0576 290.354 55.3912L184.169 161.576C168.769 176.976 168.769 201.943 184.169 217.342L323.966 77.5454C368.624 113.957 397.144 169.411 397.144 231.525C397.144 341.193 308.24 430.097 198.572 430.097C165.089 430.097 133.541 421.81 105.869 407.175L212.051 300.992C227.451 285.593 227.451 260.625 212.051 245.226L72.4057 384.871ZM72.4057 384.871C82.737 393.381 93.9431 400.867 105.869 407.175L46.0328 467.011C30.6334 451.611 30.6334 426.644 46.0328 411.244L72.4057 384.871Z" fill="url(#paint0_linear_2393_3253)"/>
+<defs>
+<linearGradient id="paint0_linear_2393_3253" x1="-172.158" y1="768.688" x2="-494.602" y2="-606.181" gradientUnits="userSpaceOnUse">
+<stop stop-color="#00196F"/>
+<stop offset="0.330483" stop-color="#13B0D9"/>
+<stop offset="0.61175" stop-color="#9AF3FA"/>
+</linearGradient>
+</defs>
+</svg>

package/.next/standalone/apps/web/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Vercel</title><path d="M12 0l12 20.785H0L12 0z"></path></svg>

package/.next/standalone/apps/web/scripts/prepare-standalone.mjs

@@ -0,0 +1,153 @@
+import { cpSync, existsSync, lstatSync, mkdirSync, readdirSync, realpathSync, rmSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+
+const standaloneRoot = path.resolve('.next/standalone');
+const appRoot = path.join(standaloneRoot, 'apps/web');
+
+if (!existsSync(standaloneRoot)) {
+  process.exit(0);
+}
+
+removeDanglingSymlinks(standaloneRoot);
+
+rmSync(path.join(appRoot, '.env.local'), { force: true });
+rmSync(path.join(appRoot, 'public'), { force: true, recursive: true });
+
+copyDirectory('.next/static', path.join(appRoot, '.next/static'));
+copyDirectory('public', path.join(appRoot, 'public'));
+copyBundledFfprobe();
+
+pruneOtherPlatformNativePackages();
+removePrivateRuntimeState(standaloneRoot);
+removeEnvFiles(standaloneRoot);
+removeBuildCaches(standaloneRoot);
+removeDanglingSymlinks(standaloneRoot);
+
+function copyDirectory(source, destination) {
+  if (!existsSync(source)) return;
+
+  mkdirSync(destination, { recursive: true });
+  cpSync(source, destination, { recursive: true });
+}
+
+/**
+ * The ffprobe installer resolves its platform package dynamically, which Next's
+ * output tracer cannot see. Copy that one platform package beside the traced
+ * wrapper so CLI/desktop installs can probe video without relying on PATH.
+ */
+function copyBundledFfprobe() {
+  const requireFromApp = createRequire(import.meta.url);
+  const platformPackage = `${process.platform}-${process.arch}`;
+  const standaloneWrapper = path.join(appRoot, 'node_modules/@ffprobe-installer/ffprobe');
+  if (!existsSync(standaloneWrapper)) return;
+  try {
+    const bundled = requireFromApp('@ffprobe-installer/ffprobe');
+    const wrapperRoot = realpathSync(standaloneWrapper);
+    copyDirectory(
+      path.dirname(bundled.path),
+      path.join(path.dirname(wrapperRoot), platformPackage),
+    );
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Could not package ffprobe for the standalone server: ${message}`);
+  }
+}
+
+function pruneOtherPlatformNativePackages() {
+  const packageStore = path.join(standaloneRoot, 'node_modules/.pnpm');
+  if (!existsSync(packageStore)) return;
+
+  const libc =
+    process.platform === 'linux' && !process.report.getReport().header.glibcVersionRuntime
+      ? 'musl'
+      : 'gnu';
+  const napiPlatform =
+    process.platform === 'linux'
+      ? `linux-${process.arch}-${libc}`
+      : process.platform === 'win32'
+        ? `win32-${process.arch}-msvc`
+        : `${process.platform}-${process.arch}`;
+  const sharpPlatform =
+    process.platform === 'linux' && libc === 'musl'
+      ? `linuxmusl-${process.arch}`
+      : `${process.platform}-${process.arch}`;
+  const keepPrefixes = [
+    `@lancedb+lancedb-${napiPlatform}@`,
+    `@napi-rs+canvas-${napiPlatform}@`,
+    `@img+sharp-${sharpPlatform}@`,
+    `@img+sharp-libvips-${sharpPlatform}@`,
+  ];
+
+  for (const entry of readdirSync(packageStore)) {
+    const isNativePackage = /^(?:@lancedb\+lancedb-|@napi-rs\+canvas-|@img\+sharp-)/.test(entry);
+    if (isNativePackage && !keepPrefixes.some((prefix) => entry.startsWith(prefix))) {
+      rmSync(path.join(packageStore, entry), { force: true, recursive: true });
+    }
+  }
+}
+
+function removePrivateRuntimeState(directory) {
+  for (const entry of readdirSync(directory, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+
+    const entryPath = path.join(directory, entry.name);
+    if (entry.name === '.larkup' || entry.name === '.larkupdb') {
+      rmSync(entryPath, { force: true, recursive: true });
+      continue;
+    }
+    removePrivateRuntimeState(entryPath);
+  }
+}
+
+/**
+ * Next traces workspace siblings into the standalone tree, so a publish from a
+ * working copy would carry private env files and local project state straight
+ * into a public tarball. CI publishes from a clean checkout where these do not
+ * exist; these scrubbers make a local publish safe too.
+ */
+function removeEnvFiles(directory) {
+  for (const entry of readdirSync(directory, { withFileTypes: true })) {
+    const entryPath = path.join(directory, entry.name);
+    if (entry.isDirectory()) {
+      removeEnvFiles(entryPath);
+      continue;
+    }
+    if (/^\.env($|\.)/.test(entry.name) && entry.name !== '.env.example') {
+      rmSync(entryPath, { force: true });
+    }
+  }
+}
+
+function removeBuildCaches(directory) {
+  for (const entry of readdirSync(directory, { withFileTypes: true })) {
+    const entryPath = path.join(directory, entry.name);
+    if (!entry.isDirectory()) continue;
+
+    if (entry.name === '.venv' || entry.name === '.turbo') {
+      rmSync(entryPath, { force: true, recursive: true });
+      continue;
+    }
+
+    if (entry.name === '.next') {
+      rmSync(path.join(entryPath, 'cache'), { force: true, recursive: true });
+      rmSync(path.join(entryPath, 'dev'), { force: true, recursive: true });
+    }
+
+    removeBuildCaches(entryPath);
+  }
+}
+
+function removeDanglingSymlinks(directory) {
+  for (const entry of readdirSync(directory, { withFileTypes: true })) {
+    const entryPath = path.join(directory, entry.name);
+    const stat = lstatSync(entryPath);
+
+    if (stat.isSymbolicLink()) {
+      if (!existsSync(entryPath)) rmSync(entryPath, { force: true });
+      continue;
+    }
+
+    if (stat.isDirectory()) removeDanglingSymlinks(entryPath);
+  }
+}

package/.next/standalone/apps/web/server.js

@@ -0,0 +1,44 @@
+performance.mark('next-start');
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import module from 'node:module'
+const require = module.createRequire(import.meta.url)
+const __dirname = fileURLToPath(new URL('.', import.meta.url))
+
+
+const dir = path.join(__dirname)
+
+process.env.NODE_ENV = 'production'
+process.chdir(__dirname)
+
+const currentPort = parseInt(process.env.PORT, 10) || 3000
+const hostname = process.env.HOSTNAME || '0.0.0.0'
+
+let keepAliveTimeout = parseInt(process.env.KEEP_ALIVE_TIMEOUT, 10)
+const nextConfig = {"env":{"NEXT_PUBLIC_APP_VERSION":"0.4.14"},"typescript":{"ignoreBuildErrors":true},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.mjs","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"instrumentationClientInject":[],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/private/tmp/larkup-release-0.4.14","enablePrerenderSourceMaps":true,"cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":true,"coldCacheBadge":false,"devValidationWorker":true,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"dynamicOnHover":false,"useOffline":false,"varyParams":true,"optimisticRouting":true,"instrumentationClientRouterTransitionEvents":false,"prefetchInlining":{"maxSize":2048,"maxBundleSize":10240},"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":9,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptOperationCache":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"devMemoryThresholdRestart":true,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"requestInsights":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"useTypeScriptCli":true,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":true,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"serverComponentsHmrCancellation":false,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":true,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","turbopackMemoryEvictionMode":"auto","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"useCacheTimeout":54,"instantInsights":{"validationLevel":"warning"},"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.mjs","transpilePackages":["@larkup/connections","@larkup/core","@larkup/vector-stores","@larkup/scraper","@larkup/marketplace","@larkup/sandbox"],"serverExternalPackages":["@lancedb/lancedb","@ffmpeg-installer/ffmpeg","@ffprobe-installer/ffprobe","chromadb","@chroma-core/default-embed","dockerode","node-ssh","nodejs-whisper","@napi-rs/canvas","pdf-parse"],"outputFileTracingExcludes":{"/*":[".next/dev/**/*",".next/standalone/**/*","../desktop/src-tauri/target/**/*"]},"turbopack":{"ignoreIssue":[{"path":"**/ffmpeg-spawn.js","title":"Module not found"}],"root":"/private/tmp/larkup-release-0.4.14"},"repoRoot":"/private/tmp/larkup-release-0.4.14","distDirRoot":".next","supportsImmutableAssets":false,"_originalRewrites":{"beforeFiles":[],"afterFiles":[{"source":"/uploads/:path*","destination":"/api/uploads/:path*"}],"fallback":[]}}
+
+process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig)
+
+require('next')
+const { startServer } = require('next/dist/server/lib/start-server')
+
+if (
+  Number.isNaN(keepAliveTimeout) ||
+  !Number.isFinite(keepAliveTimeout) ||
+  keepAliveTimeout < 0
+) {
+  keepAliveTimeout = undefined
+}
+
+startServer({
+  dir,
+  isDev: false,
+  config: nextConfig,
+  hostname,
+  port: currentPort,
+  allowRetry: false,
+  keepAliveTimeout,
+}).catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/.next/standalone/apps/web/store/chat-store.ts

@@ -0,0 +1,19 @@
+import { create } from 'zustand';
+import { persist } from 'zustand/middleware';
+
+interface ChatStore {
+  selectedModel: string;
+  setSelectedModel: (model: string) => void;
+}
+
+export const useChatStore = create<ChatStore>()(
+  persist(
+    (set) => ({
+      selectedModel: '',
+      setSelectedModel: (model) => set({ selectedModel: model }),
+    }),
+    {
+      name: 'larkup-chat-store',
+    },
+  ),
+);

package/.next/standalone/apps/web/store/connections-store.ts

@@ -0,0 +1,276 @@
+import { create } from 'zustand';
+import { mutate as globalMutate } from 'swr';
+import { toast } from 'sonner';
+import type { ChannelSummary } from '@larkup/connections';
+import { readDeploymentApiKey } from '@/lib/deployments';
+
+const LOCAL_SERVER_KEY_STORAGE = 'larkup-server-api-key';
+const MASKED = '••••••••';
+
+export interface ConnectionRecord {
+  id: string;
+  enabled: boolean;
+  /** OAuth connections rely on the managed proxy for inbound signature verification. */
+  managed?: boolean;
+  settings: Record<string, string>;
+  target: { mode: 'local' | 'remote'; endpoint: string; apiKey?: string };
+  provider?: { identity?: string; externalId?: string; testUrl?: string; testUrlLabel?: string };
+}
+
+/** One selectable entry in the "Agent target" dropdown — the local runtime or one deployed Agent Server. */
+export interface AgentTarget {
+  key: string;
+  mode: 'local' | 'remote';
+  label: string;
+  endpoint: string;
+  sublabel: string;
+  icon?: string;
+  deploymentId?: string;
+}
+
+function localServerApiKey() {
+  return typeof window === 'undefined'
+    ? ''
+    : window.localStorage.getItem(LOCAL_SERVER_KEY_STORAGE) ?? '';
+}
+
+function autoloadApiKey(target: AgentTarget) {
+  if (target.mode === 'local') return localServerApiKey();
+  return (target.deploymentId && readDeploymentApiKey(target.deploymentId)) || '';
+}
+
+/** A masked secret is a display-only sentinel, not a real value — blank the
+ * field instead of dumping literal dots into it. The "Saved" placeholder
+ * (driven by `current`, which still holds the mask) tells the operator a
+ * value already exists without ever showing it back to them. */
+function blankMaskedValues(settings: Record<string, string>) {
+  return Object.fromEntries(
+    Object.entries(settings).map(([key, value]) => [key, value === MASKED ? '' : value]),
+  );
+}
+
+export interface WebhookRegistration {
+  ok: boolean;
+  detail: string;
+}
+
+interface ConnectionFormState {
+  active: ChannelSummary | null;
+  current: ConnectionRecord | undefined;
+  settings: Record<string, string>;
+  /** Per-field secret visibility, keyed by configField.key — independent of `showApiKey`. */
+  visibleFields: Record<string, boolean>;
+  mode: 'local' | 'remote';
+  targetKey: string;
+  endpoint: string;
+  apiKey: string;
+  showApiKey: boolean;
+  enabled: boolean;
+  managed: boolean;
+  saving: boolean;
+  removing: boolean;
+  testing: boolean;
+  /** Result of telling the provider where to send updates, set right after a successful save. */
+  webhookRegistration: WebhookRegistration | null;
+}
+
+interface ConnectionFormActions {
+  /** Opens the sheet for a channel, seeding the form from its saved connection (if any). */
+  open: (
+    channel: ChannelSummary,
+    current: ConnectionRecord | undefined,
+    targets: AgentTarget[],
+    localEndpoint: string,
+  ) => void;
+  close: () => void;
+  selectTarget: (target: AgentTarget) => void;
+  setEndpoint: (endpoint: string) => void;
+  setApiKey: (apiKey: string) => void;
+  toggleShowApiKey: () => void;
+  setFieldValue: (key: string, value: string) => void;
+  /** Fills a field with a random string — for any `configField.canGenerate` secret. */
+  generateFieldValue: (key: string) => void;
+  toggleFieldVisibility: (key: string) => void;
+  setEnabled: (enabled: boolean) => void;
+  setManaged: (managed: boolean) => void;
+  applyManagedOAuth: (fields: Record<string, string>) => Promise<void>;
+  save: () => Promise<void>;
+  remove: () => Promise<void>;
+  test: () => Promise<void>;
+}
+
+const CONNECTIONS_KEY = '/api/connections';
+
+export const useConnectionFormStore = create<ConnectionFormState & ConnectionFormActions>()(
+  (set, get) => ({
+    active: null,
+    current: undefined,
+    settings: {},
+    visibleFields: {},
+    mode: 'local',
+    targetKey: 'local',
+    endpoint: '',
+    apiKey: '',
+    showApiKey: false,
+    enabled: true,
+    managed: false,
+    saving: false,
+    removing: false,
+    testing: false,
+    webhookRegistration: null,
+
+    open: (channel, current, targets, localEndpoint) => {
+      const savedMode = current?.target.mode ?? 'local';
+      const savedEndpoint = current?.target.endpoint ?? localEndpoint;
+      const matched =
+        savedMode === 'remote'
+          ? targets.find((target) => target.mode === 'remote' && target.endpoint === savedEndpoint)
+          : targets[0];
+      set({
+        active: channel,
+        current,
+        settings: blankMaskedValues(current?.settings ?? {}),
+        visibleFields: {},
+        enabled: current?.enabled ?? true,
+        managed: current?.managed ?? false,
+        showApiKey: false,
+        webhookRegistration: null,
+        mode: savedMode,
+        endpoint: savedEndpoint,
+        targetKey: matched?.key ?? 'local',
+        apiKey:
+          current?.target.apiKey === MASKED ? '' : current?.target.apiKey ?? localServerApiKey(),
+      });
+    },
+
+    close: () => set({ active: null, current: undefined, webhookRegistration: null }),
+
+    selectTarget: (target) =>
+      set({
+        targetKey: target.key,
+        mode: target.mode,
+        endpoint: target.endpoint,
+        apiKey: autoloadApiKey(target),
+      }),
+
+    setEndpoint: (endpoint) => set({ endpoint }),
+    setApiKey: (apiKey) => set({ apiKey }),
+    toggleShowApiKey: () => set((state) => ({ showApiKey: !state.showApiKey })),
+    setFieldValue: (key, value) =>
+      set((state) => ({ settings: { ...state.settings, [key]: value } })),
+    generateFieldValue: (key) => {
+      const value = Array.from({ length: 2 }, () => Math.random().toString(36).slice(2, 15)).join(
+        '',
+      );
+      set((state) => ({
+        settings: { ...state.settings, [key]: value },
+        visibleFields: { ...state.visibleFields, [key]: true },
+      }));
+    },
+    toggleFieldVisibility: (key) =>
+      set((state) => ({
+        visibleFields: { ...state.visibleFields, [key]: !state.visibleFields[key] },
+      })),
+    setEnabled: (enabled) => set({ enabled }),
+    setManaged: (managed) => set({ managed }),
+    applyManagedOAuth: async (fields) => {
+      set((state) => ({
+        settings: { ...state.settings, ...fields },
+        managed: true,
+      }));
+      await get().save();
+    },
+
+    save: async () => {
+      const { active, current, enabled, managed, settings, mode, endpoint, apiKey } = get();
+      if (!active) return;
+      set({ saving: true, webhookRegistration: null });
+      try {
+        const response = await fetch(CONNECTIONS_KEY, {
+          method: 'PUT',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({
+            id: active.id,
+            enabled,
+            managed,
+            settings,
+            target: { mode, endpoint, apiKey: apiKey || current?.target.apiKey },
+          }),
+        });
+        const result = await response.json();
+        if (!response.ok) throw new Error(result.error ?? 'Could not save the channel.');
+        await globalMutate(CONNECTIONS_KEY);
+        toast.success(`${active.name} is connected to this Agent.`, { position: 'bottom-left' });
+        // Stay open and re-seed from the saved record instead of closing —
+        // the webhook URL and "go live" status below are exactly what an
+        // operator needs to see right after saving, not something to hunt
+        // for by reopening the sheet.
+        const saved: ConnectionRecord = result.connection;
+        set({
+          current: saved,
+          settings: blankMaskedValues(saved.settings),
+          apiKey: saved.target.apiKey === MASKED ? '' : apiKey,
+          webhookRegistration: result.webhookRegistration ?? null,
+        });
+      } catch (error) {
+        toast.error(error instanceof Error ? error.message : 'Could not save the channel.', {
+          position: 'bottom-left',
+        });
+      } finally {
+        set({ saving: false });
+      }
+    },
+
+    remove: async () => {
+      const { active } = get();
+      if (!active) return;
+      set({ removing: true });
+      try {
+        const response = await fetch(`${CONNECTIONS_KEY}/${active.id}`, { method: 'DELETE' });
+        const result = await response.json();
+        if (!response.ok) throw new Error(result.error ?? 'Could not remove the connection.');
+        await globalMutate(CONNECTIONS_KEY);
+        toast.success(`${active.name} was disconnected.`, { position: 'bottom-left' });
+        get().close();
+      } catch (error) {
+        toast.error(error instanceof Error ? error.message : 'Could not remove the connection.', {
+          position: 'bottom-left',
+        });
+      } finally {
+        set({ removing: false });
+      }
+    },
+
+    test: async () => {
+      const { active, current, settings, mode, endpoint, apiKey, managed } = get();
+      if (!active) return;
+      set({ testing: true });
+      try {
+        const response = await fetch(CONNECTIONS_KEY, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({
+            id: active.id,
+            managed,
+            settings,
+            target: { mode, endpoint, apiKey: apiKey || current?.target.apiKey },
+          }),
+        });
+        const result = await response.json();
+        if (!response.ok) throw new Error(result.error ?? 'Could not test this channel.');
+        if (result.channel.status !== 'ok') throw new Error(result.channel.detail);
+        if (!result.runtime.ok)
+          throw new Error('The selected endpoint is not a reachable Agent Server.');
+        toast.success(`${result.channel.detail} Agent: ${result.runtime.name}.`, {
+          position: 'bottom-left',
+        });
+      } catch (error) {
+        toast.error(error instanceof Error ? error.message : 'Could not test this channel.', {
+          position: 'bottom-left',
+        });
+      } finally {
+        set({ testing: false });
+      }
+    },
+  }),
+);