@agent-native/core 0.211.0 → 0.211.1-nightly-20261020213022

package/dist/server/collab-plugin.js

@@ -1,6 +1,7 @@
 import { defineEventHandler, getMethod, setResponseStatus, } from "h3";
 import { postAwareness, getActiveUsers } from "../collab/awareness.js";
 import { getCollabEmitter } from "../collab/emitter.js";
+import { LiveCopyError } from "../collab/live-copy.js";
 import { getCollabState, postCollabUpdate, postCollabText, postCollabSearchReplace, } from "../collab/routes.js";
 import { hasCollabState } from "../collab/storage.js";
 import { postCollabJson, getCollabJson, postCollabPatch, } from "../collab/struct-routes.js";
@@ -98,7 +99,67 @@ export function createCollabSourceSeeder(options) {
         }
     };
 }
+// Worker and capacity failures are the server's, so a client may retry them;
+// a task that broke its contract is a server bug, not a bad edit.
+const RETRYABLE_TASK_FAILURES = new Set([
+    "unavailable",
+    "closed",
+    "queue_full",
+    "queue_timeout",
+    "deadline_exceeded",
+    "memory_exceeded",
+    "worker_crashed",
+    "startup_failed",
+]);
+export function liveCopyErrorStatus(error) {
+    switch (error.code) {
+        case "write_refused":
+        case "read_refused":
+        case "not_live_copy":
+        case "not_seeded":
+        case "version_conflict":
+            return 409;
+        case "state_too_large":
+            return 413;
+        case "malformed_state":
+        case "unsupported_content":
+        case "derive_refused":
+        case "build_refused":
+            return 422;
+        case "derive_failed":
+        case "build_failed":
+            if (RETRYABLE_TASK_FAILURES.has(error.reason ?? ""))
+                return 503;
+            if (error.reason === "input_too_large" ||
+                error.reason === "output_too_large") {
+                return 413;
+            }
+            return 500;
+    }
+}
+function collabErrorResponse(event, error) {
+    if (error instanceof LiveCopyError) {
+        setResponseStatus(event, liveCopyErrorStatus(error));
+        return {
+            error: error.message,
+            code: `live_copy_${error.code}`,
+            ...(error.reason !== undefined ? { reason: error.reason } : {}),
+        };
+    }
+    return null;
+}
 export function createCollabPlugin(options = {}) {
+    if ("onContentSync" in options) {
+        throw new Error("createCollabPlugin no longer accepts onContentSync; it was never called. Use liveCopy (defineLiveCopy) to derive a document's text when its live copy changes.");
+    }
+    if (options.liveCopy) {
+        if (options.autoSeed !== false) {
+            throw new Error("createCollabPlugin liveCopy requires autoSeed: false; seed live copies with seedLiveCopy.");
+        }
+        if (options.contentType === "json") {
+            throw new Error('createCollabPlugin liveCopy derives text from an XML fragment and cannot be combined with contentType: "json".');
+        }
+    }
     const normalizedAccess = normalizeCollabAccess(options);
     const { table = "documents", contentColumn = "content", idColumn = "id", autoSeed = true, maxPayloadBytes = DEFAULT_MAX_PAYLOAD_BYTES, } = options;
     const resolveSourceIdFromCollabDocumentId = options.resolveSourceIdFromCollabDocumentId ?? ((docId) => docId);
@@ -355,26 +416,34 @@ export function createCollabPlugin(options = {}) {
                     (action === "search-replace" && method === "POST") ||
                     (action === "json" && (method === "GET" || method === "POST")) ||
                     (action === "patch" && method === "POST");
-                if (needsSeed)
-                    await ensureDocumentSeeded(docId);
-                if (action === "state" && method === "GET")
-                    return getCollabState(event);
-                if (action === "update" && method === "POST")
-                    return postCollabUpdate(event);
-                if (action === "text" && method === "POST")
-                    return postCollabText(event);
-                if (action === "search-replace" && method === "POST")
-                    return postCollabSearchReplace(event);
-                if (action === "json" && method === "POST")
-                    return postCollabJson(event);
-                if (action === "json" && method === "GET")
-                    return getCollabJson(event);
-                if (action === "patch" && method === "POST")
-                    return postCollabPatch(event);
-                if (action === "awareness" && method === "POST")
-                    return postAwareness(event);
-                if (action === "users" && method === "GET")
-                    return getActiveUsers(event);
+                try {
+                    if (needsSeed)
+                        await ensureDocumentSeeded(docId);
+                    if (action === "state" && method === "GET")
+                        return await getCollabState(event);
+                    if (action === "update" && method === "POST")
+                        return await postCollabUpdate(event);
+                    if (action === "text" && method === "POST")
+                        return await postCollabText(event);
+                    if (action === "search-replace" && method === "POST")
+                        return await postCollabSearchReplace(event);
+                    if (action === "json" && method === "POST")
+                        return await postCollabJson(event);
+                    if (action === "json" && method === "GET")
+                        return await getCollabJson(event);
+                    if (action === "patch" && method === "POST")
+                        return await postCollabPatch(event);
+                    if (action === "awareness" && method === "POST")
+                        return await postAwareness(event);
+                    if (action === "users" && method === "GET")
+                        return await getActiveUsers(event);
+                }
+                catch (error) {
+                    const response = collabErrorResponse(event, error);
+                    if (response)
+                        return response;
+                    throw error;
+                }
                 setResponseStatus(event, 404);
                 return { error: "Not found" };
             });

package/dist/server/realtime-token.d.ts

@@ -54,8 +54,8 @@ export declare function createRealtimeTokenHandler(): import("h3").EventHandlerW
     expiresAt?: undefined;
     ttlSeconds?: undefined;
 } | {
+    error?: undefined;
     token: string;
     expiresAt: string;
     ttlSeconds: number;
-    error?: undefined;
 }>>;

package/dist/shared/optional-node-builtins.d.ts

@@ -2,4 +2,5 @@ import type { AsyncLocalStorage } from "node:async_hooks";
 import type { EventEmitter } from "node:events";
 export type AsyncLocalStorageCtor = new <T>() => AsyncLocalStorage<T>;
 export declare function getAsyncLocalStorageCtor(): AsyncLocalStorageCtor | undefined;
+export declare function getWorkerThreads(): typeof import("node:worker_threads") | undefined;
 export declare function createEventEmitter(): EventEmitter;

package/dist/shared/optional-node-builtins.js

@@ -11,6 +11,9 @@ function nodeBuiltin(name) {
 export function getAsyncLocalStorageCtor() {
     return nodeBuiltin("node:async_hooks")?.AsyncLocalStorage;
 }
+export function getWorkerThreads() {
+    return nodeBuiltin("node:worker_threads");
+}
 export function createEventEmitter() {
     const Ctor = nodeBuiltin("node:events")?.EventEmitter;
     if (Ctor)

package/dist/tracking/providers.d.ts

@@ -1,2 +1,3 @@
+export declare const AGENT_NATIVE_ANALYTICS_PROVIDER = "agent-native-analytics";
 export declare function sendPostHogEvent(name: string, properties: Record<string, unknown>, distinctId: string): boolean;
 export declare function registerBuiltinProviders(): void;

package/dist/tracking/providers.js

@@ -6,6 +6,7 @@ import { reshapeTrackedExceptionProperties } from "./posthog-exception.js";
 import { registerTrackingProvider } from "./registry.js";
 const POSTHOG_DEFAULT_HOST = "https://us.i.posthog.com";
 const AGENT_NATIVE_ANALYTICS_DEFAULT_ENDPOINT = "https://analytics.agent-native.com/track";
+export const AGENT_NATIVE_ANALYTICS_PROVIDER = "agent-native-analytics";
 const BATCH_INTERVAL_MS = 10_000;
 const MAX_BATCH_SIZE = 50;
 const QUEUE_KEY = Symbol.for("@agent-native/core/tracking.queue");
@@ -323,7 +324,7 @@ function createWebhookProvider(url, authHeader) {
 function createAgentNativeAnalyticsProvider(publicKey, endpoint) {
     const flushImmediately = agentNativeAnalyticsFlushesImmediately();
     return {
-        name: "agent-native-analytics",
+        name: AGENT_NATIVE_ANALYTICS_PROVIDER,
         acceptsTestIdentityExceptions: true,
         track(event) {
             enqueue(endpoint, JSON.stringify({

package/dist/triggers/actions/manage-automation.d.ts

@@ -13,7 +13,6 @@ declare const _default: import("../../action.js").ActionDefinition<{
     executionEngine?: string;
     executionCwd?: string;
 }, {
-    deleted?: undefined;
     created: boolean;
     name: string;
     scope: "organization" | "personal";
@@ -24,6 +23,7 @@ declare const _default: import("../../action.js").ActionDefinition<{
     reasoningEffort: "auto" | "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh";
     webhookPath: string;
     nextRun: string;
+    deleted?: undefined;
     enabled?: undefined;
     executionHostId?: undefined;
     executionEngine?: undefined;
@@ -45,11 +45,11 @@ declare const _default: import("../../action.js").ActionDefinition<{
     nextRun?: undefined;
     webhookPath?: undefined;
 } | {
-    deleted?: undefined;
     created?: undefined;
     scope?: undefined;
     triggerType?: undefined;
     event?: undefined;
+    deleted?: undefined;
     name: string;
     enabled: boolean;
     schedule: string;

package/dist/vite/bounded-task-plugin.d.ts

@@ -0,0 +1,22 @@
+interface PluginContext {
+    resolve(source: string, importer?: string, options?: {
+        skipSelf?: boolean;
+    }): Promise<{
+        id: string;
+        external?: boolean | string;
+    } | null>;
+    addWatchFile(file: string): void;
+}
+/**
+ * `import source from "./tasks.ts?bounded-task"` yields the module bundled
+ * into a `BoundedTaskSource` at build time, so deployed servers never run
+ * esbuild. Registered for Vite (dev and client builds) and the production
+ * Nitro build.
+ */
+export declare function boundedTaskSourcePlugin(): {
+    name: string;
+    enforce: "pre";
+    resolveId(this: PluginContext, source: string, importer?: string): Promise<string>;
+    load(this: PluginContext, id: string): Promise<string>;
+};
+export {};

package/dist/vite/bounded-task-plugin.js

@@ -0,0 +1,44 @@
+import path from "node:path";
+import { bundleBoundedTaskSource } from "../collab/bounded-task-bundle.js";
+const QUERY = "?bounded-task";
+const RESOLVED_PREFIX = "\0agent-native-bounded-task:";
+/**
+ * `import source from "./tasks.ts?bounded-task"` yields the module bundled
+ * into a `BoundedTaskSource` at build time, so deployed servers never run
+ * esbuild. Registered for Vite (dev and client builds) and the production
+ * Nitro build.
+ */
+export function boundedTaskSourcePlugin() {
+    return {
+        name: "agent-native-bounded-task-source",
+        enforce: "pre",
+        async resolveId(source, importer) {
+            if (!source.endsWith(QUERY))
+                return null;
+            const request = source.slice(0, -QUERY.length);
+            const resolved = await this.resolve(request, importer, {
+                skipSelf: true,
+            });
+            if (!resolved || resolved.external) {
+                throw new Error(`Cannot resolve bounded task module ${request}${importer ? ` from ${importer}` : ""}`);
+            }
+            return RESOLVED_PREFIX + resolved.id.split("?")[0];
+        },
+        async load(id) {
+            if (!id.startsWith(RESOLVED_PREFIX))
+                return null;
+            const entry = id.slice(RESOLVED_PREFIX.length);
+            const bundled = await bundleBoundedTaskSource(entry, {
+                name: path.basename(entry).replace(/\.[^.]+$/, ""),
+            });
+            for (const input of bundled.inputs)
+                this.addWatchFile(input);
+            const source = {
+                kind: bundled.kind,
+                name: bundled.name,
+                code: bundled.code,
+            };
+            return `export default Object.freeze(${JSON.stringify(source)});\n`;
+        },
+    };
+}

package/dist/vite/client.js

@@ -29,6 +29,7 @@ import { AGENT_NATIVE_TYPEGEN_ENV, formatRuntimeConfigReport, getRuntimeConfigRe
 import { actionTypesPlugin } from "./action-types-plugin.js";
 import { createAgentNativeConfigContext, loadAgentNativeConfigFile, loadWorkspaceAgentNativeConfigFile, readAgentNativeJsonConfig, resolveFirstRunOnboardingBuildReplacement, resolveHarnessBuildReplacement, writeAgentNativeBuildConfigMarker, } from "./agent-native-config-loader.js";
 import { agentsBundlePlugin } from "./agents-bundle-plugin.js";
+import { boundedTaskSourcePlugin } from "./bounded-task-plugin.js";
 import { migrationDiagnosticPlugin } from "./migration-diagnostic-plugin.js";
 import { motionSourceProvenancePlugin } from "./motion-source-provenance-plugin.js";
 import { resolveAgentNativePackageVersions } from "./package-versions.js";
@@ -3657,6 +3658,7 @@ function createAgentNativePlugins(options, { command, includeReactTransform, use
         appChangelogRawPlugin(),
         actionTypesPlugin(),
         agentsBundlePlugin({ agentNativeConfig: options.agentNativeConfig }),
+        boundedTaskSourcePlugin(),
         authClientAssetPlugin(cwd),
         autoReloadOnOptimizeDep(),
         fullReloadOnOptimizeDep504(),

package/dist/vitest-config.js

@@ -1,3 +1,4 @@
+import { boundedTaskSourcePlugin } from "./vite/bounded-task-plugin.js";
 const DEFAULT_MAX_WORKERS = "25%";
 const ENV_KEYS = ["VITEST_CONCURRENCY", "AGENT_NATIVE_VITEST_CONCURRENCY"];
 export function resolveMaxWorkers(env = process.env, fallback = DEFAULT_MAX_WORKERS) {
@@ -25,6 +26,8 @@ export function resolveMaxWorkers(env = process.env, fallback = DEFAULT_MAX_WORK
     return count;
 }
 const vitestBaseConfig = {
+    // App tests import server modules that load `?bounded-task` sources.
+    plugins: [boundedTaskSourcePlugin()],
     test: {
         maxWorkers: resolveMaxWorkers(),
         // Vitest's 5 s default only holds while a worker has a core to itself.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.211.0",
+  "version": "0.211.1-nightly-20261020213022",
   "description": "The agentic application framework for building autonomous agents with intuitive UIs",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -403,6 +403,7 @@
     },
     "./router": "./dist/router/index.js",
     "./collab": "./dist/collab/index.js",
+    "./collab/live-copy-tasks": "./dist/collab/live-copy-tasks.js",
     "./a2a": "./dist/a2a/index.js",
     "./mcp": "./dist/mcp/index.js",
     "./mcp/fetch": "./dist/mcp/fetch-handler.js",
@@ -711,7 +712,7 @@
     "yaml": "^2.9.0",
     "yjs": "^13.6.33",
     "zod": "^4.3.6",
-    "@agent-native/agentkit": "^0.211.0",
+    "@agent-native/agentkit": "^0.211.1-nightly-20261020213022",
     "@agent-native/recap-cli": "^0.5.78"
   },
   "devDependencies": {
@@ -782,7 +783,7 @@
     "xlsx": "^0.18.5"
   },
   "peerDependencies": {
-    "@agent-native/core-corpus": ">=0.196.0",
+    "@agent-native/core-corpus": "0.211.1-nightly-20261020213022",
     "@ai-sdk/anthropic": ">=3",
     "@ai-sdk/cohere": ">=3",
     "@ai-sdk/google": ">=3",