veryfront 0.1.402 → 0.1.404

package/esm/src/observability/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,eAAe,EACf,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,KAAK,WAAW,EAChB,SAAS,EACT,KAAK,aAAa,EAClB,cAAc,EACd,QAAQ,EACR,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,KAAK,aAAa,EAClB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,UAAU,EACf,YAAY,GACb,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,KAAK,QAAQ,EACb,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,SAAS,IAAI,eAAe,EACjC,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,eAAe,EACf,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,KAAK,WAAW,EAChB,SAAS,EACT,KAAK,aAAa,EAClB,cAAc,EACd,QAAQ,EACR,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,KAAK,aAAa,EAClB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,UAAU,EACf,YAAY,GACb,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,KAAK,QAAQ,EACb,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,SAAS,IAAI,eAAe,EACjC,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,uBAAuB,EACvB,KAAK,aAAa,EAClB,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAC"}

package/esm/src/observability/index.js

@@ -10,3 +10,4 @@ export { initAutoInstrumentation, instrument, instrumentBatch, instrumentErrorHa
 export { initializeOTLP, isOTLPEnabled, shutdownOTLP, } from "./tracing/otlp-setup.js";
 export { ErrorCollector, getErrorCollector, parseCompileError, resetErrorCollector, } from "./error-collector.js";
 export { getLogBuffer, interceptConsole, LogBuffer, resetLogBuffer, } from "./log-buffer.js";
+export { createFileLogSubscriber, FileLogSubscriber, parseMaxSize, } from "./file-log-subscriber.js";

package/esm/src/server/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/src/server/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,KAAK,eAAe,EAAqC,MAAM,wBAAwB,CAAC;AAsCjG,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,OAAO,EAAE,cAAc,CAAC;IAExB,2BAA2B;IAC3B,MAAM,EAAE,eAAe,CAAC;IAExB,wCAAwC;IACxC,cAAc,EAAE,OAAO,CAAC;IAExB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,eAAe,EAAE,eAAe,CAAC;IAEjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAmED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,EAC3C,SAAS,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,GAClC,OAAO,CAAC,eAAe,CAAC,CAO1B;AAkDD,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAqJ1B;AAED,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAa1B;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAyB1B"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/src/server/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,KAAK,eAAe,EAAqC,MAAM,wBAAwB,CAAC;AA4CjG,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,OAAO,EAAE,cAAc,CAAC;IAExB,2BAA2B;IAC3B,MAAM,EAAE,eAAe,CAAC;IAExB,wCAAwC;IACxC,cAAc,EAAE,OAAO,CAAC;IAExB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,eAAe,EAAE,eAAe,CAAC;IAEjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAgHD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,EAC3C,SAAS,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,GAClC,OAAO,CAAC,eAAe,CAAC,CAO1B;AAkDD,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAmK1B;AAED,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAa1B;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAyB1B"}

package/esm/src/server/bootstrap.js

@@ -16,6 +16,8 @@ import { initializeEsbuild } from "../platform/compat/esbuild.js";
 import { logger } from "../utils/index.js";
 import { isDebugEnabled } from "../utils/constants/env.js";
 import { getEnvSource, hasEnvLoaded, loadEnv, markEnvLoaded, supportsEnvFiles, } from "../utils/env-loader.js";
+import { getLogBuffer } from "../observability/log-buffer.js";
+import { createFileLogSubscriber, } from "../observability/file-log-subscriber.js";
 import { ReloadNotifier } from "./reload-notifier.js";
 import { clearDomainCache } from "./utils/domain-lookup.js";
 const bootstrapLog = logger.component("bootstrap");
@@ -60,14 +62,51 @@ function wireTracingShim() {
         bootstrapLog.debug("[bootstrap] no TracingExporter extension — using no-op tracer");
     }
 }
-function combineDispose(extensionLoader, fsDispose) {
+const DEFAULT_FILE_LOG_PATH = ".veryfront/logs/server.log";
+const DEFAULT_FILE_LOG_MAX_SIZE = "10mb";
+const DEFAULT_FILE_LOG_MAX_FILES = 5;
+const DEFAULT_FILE_LOG_LEVEL = "warn";
+const DEFAULT_FILE_LOG_FORMAT = "json";
+function maybeAttachFileLogSubscriber(config) {
+    const fileConfig = config.observability?.logging?.file;
+    if (!fileConfig?.enabled)
+        return null;
+    const resolved = {
+        enabled: true,
+        path: fileConfig.path ?? DEFAULT_FILE_LOG_PATH,
+        maxSize: fileConfig.maxSize ?? DEFAULT_FILE_LOG_MAX_SIZE,
+        maxFiles: fileConfig.maxFiles ?? DEFAULT_FILE_LOG_MAX_FILES,
+        level: fileConfig.level ?? DEFAULT_FILE_LOG_LEVEL,
+        format: fileConfig.format ?? DEFAULT_FILE_LOG_FORMAT,
+    };
+    const subscriber = createFileLogSubscriber(resolved);
+    const unsubscribe = getLogBuffer().subscribe(subscriber.getSubscriber());
+    bootstrapLog.debug("[bootstrap] File log subscriber attached", {
+        path: resolved.path,
+        level: resolved.level,
+        format: resolved.format,
+    });
+    return { subscriber, unsubscribe };
+}
+async function teardownFileLog(handle) {
+    if (!handle)
+        return;
+    handle.unsubscribe();
+    await handle.subscriber.close();
+}
+function combineDispose(extensionLoader, fsDispose, fileLogHandle) {
     return async () => {
         try {
             await extensionLoader.teardownAll();
         }
         finally {
-            if (fsDispose)
-                fsDispose();
+            try {
+                await teardownFileLog(fileLogHandle ?? null);
+            }
+            finally {
+                if (fsDispose)
+                    fsDispose();
+            }
         }
     };
 }
@@ -144,118 +183,131 @@ export async function bootstrap(projectDir, adapter) {
     await ensureEnvLoaded(projectDir, adapter);
     bootstrapLog.debug("Loading config with base adapter");
     let config = await getConfig(projectDir, adapter);
-    const fsType = config.fs?.type;
-    const needsFSAdapter = fsType != null && fsType !== "local";
-    if (!needsFSAdapter) {
-        bootstrapLog.debug("Using local filesystem (no FSAdapter needed)");
-        const extensionLoader = await orchestrateExtensions({
-            projectDir,
-            config,
-            logger: bootstrapLog,
-            primeContracts: { [AIProviderRegistryName]: createAIProviderRegistry() },
-            builtinExtensions: createBuiltinExtensions(),
-        });
-        wireTracingShim();
-        assertRequiredContracts();
-        return {
-            adapter,
-            config,
-            usingFSAdapter: false,
-            extensionLoader,
-            dispose: combineDispose(extensionLoader),
+    let fileLog = maybeAttachFileLogSubscriber(config);
+    try {
+        const fsType = config.fs?.type;
+        const needsFSAdapter = fsType != null && fsType !== "local";
+        if (!needsFSAdapter) {
+            bootstrapLog.debug("Using local filesystem (no FSAdapter needed)");
+            const extensionLoader = await orchestrateExtensions({
+                projectDir,
+                config,
+                logger: bootstrapLog,
+                primeContracts: { [AIProviderRegistryName]: createAIProviderRegistry() },
+                builtinExtensions: createBuiltinExtensions(),
+            });
+            wireTracingShim();
+            assertRequiredContracts();
+            return {
+                adapter,
+                config,
+                usingFSAdapter: false,
+                extensionLoader,
+                dispose: combineDispose(extensionLoader, undefined, fileLog),
+            };
+        }
+        bootstrapLog.debug("Initializing FSAdapter", { type: fsType });
+        // Inject server-layer callbacks into FS config so the platform layer
+        // doesn't need to import from the server layer
+        const fsWithCallbacks = {
+            ...config.fs,
+            invalidationCallbacks: {
+                triggerReload: (changedPaths, project) => ReloadNotifier.triggerReload(changedPaths, project),
+                clearDomainCache,
+            },
         };
-    }
-    bootstrapLog.debug("Initializing FSAdapter", { type: fsType });
-    // Inject server-layer callbacks into FS config so the platform layer
-    // doesn't need to import from the server layer
-    const fsWithCallbacks = {
-        ...config.fs,
-        invalidationCallbacks: {
-            triggerReload: (changedPaths, project) => ReloadNotifier.triggerReload(changedPaths, project),
-            clearDomainCache,
-        },
-    };
-    const enhancedAdapter = await enhanceAdapterWithFS(adapter, { ...config, fs: fsWithCallbacks }, projectDir);
-    if (enhancedAdapter === adapter) {
+        const enhancedAdapter = await enhanceAdapterWithFS(adapter, { ...config, fs: fsWithCallbacks }, projectDir);
+        if (enhancedAdapter === adapter) {
+            bootstrapLog.debug("Framework initialized successfully", {
+                projectDir,
+                runtime: adapter.id,
+                fsAdapter: "local",
+            });
+            const extensionLoader = await orchestrateExtensions({
+                projectDir,
+                config,
+                logger: bootstrapLog,
+                primeContracts: { [AIProviderRegistryName]: createAIProviderRegistry() },
+                builtinExtensions: createBuiltinExtensions(),
+            });
+            wireTracingShim();
+            assertRequiredContracts();
+            return {
+                adapter,
+                config,
+                usingFSAdapter: false,
+                extensionLoader,
+                dispose: combineDispose(extensionLoader, undefined, fileLog),
+            };
+        }
+        const isProxyMode = config.fs?.veryfront?.proxyMode === true;
+        const isProductionMode = config.fs?.veryfront?.productionMode === true;
+        if (isProxyMode) {
+            bootstrapLog.debug("Skipping config reload in proxy mode (using local config)");
+        }
+        else if (isProductionMode) {
+            bootstrapLog.debug("Skipping config reload in production mode (using local config)");
+        }
+        else {
+            bootstrapLog.debug("Reloading config with FSAdapter");
+            clearConfigCache();
+            const originalConfig = config;
+            const reloadedConfig = await getConfig(projectDir, enhancedAdapter);
+            const usesDefaultDevConfig = reloadedConfig.dev?.port === 3000 &&
+                reloadedConfig.dev?.host === "localhost" &&
+                !reloadedConfig.dev?.hmr;
+            if (usesDefaultDevConfig && originalConfig.dev) {
+                bootstrapLog.debug("Keeping original config (FSAdapter returned defaults)");
+                config = originalConfig;
+            }
+            else {
+                config = reloadedConfig;
+            }
+            // Re-attach file log subscriber if config was reloaded with different settings
+            const newFileLog = maybeAttachFileLogSubscriber(config);
+            if (newFileLog) {
+                await teardownFileLog(fileLog);
+                fileLog = newFileLog;
+            }
+        }
         bootstrapLog.debug("Framework initialized successfully", {
             projectDir,
             runtime: adapter.id,
-            fsAdapter: "local",
+            fsAdapter: fsType,
         });
-        const extensionLoader = await orchestrateExtensions({
+        let fsDispose;
+        if (isExtendedFSAdapter(enhancedAdapter.fs)) {
+            const underlying = enhancedAdapter.fs.getUnderlyingAdapter();
+            if ("dispose" in underlying &&
+                typeof underlying.dispose === "function") {
+                fsDispose = () => underlying.dispose();
+            }
+        }
+        // If extension orchestration fails after the FS adapter has been wired up,
+        // release the FS resources (WebSocket connections, caches) before
+        // propagating the error — otherwise the adapter would leak.
+        const extensionLoader = await orchestrateOrDisposeFS(() => orchestrateExtensions({
             projectDir,
             config,
             logger: bootstrapLog,
             primeContracts: { [AIProviderRegistryName]: createAIProviderRegistry() },
             builtinExtensions: createBuiltinExtensions(),
-        });
+        }), fsDispose);
         wireTracingShim();
         assertRequiredContracts();
         return {
-            adapter,
+            adapter: enhancedAdapter,
             config,
-            usingFSAdapter: false,
+            usingFSAdapter: true,
+            fsAdapterType: fsType,
             extensionLoader,
-            dispose: combineDispose(extensionLoader),
+            dispose: combineDispose(extensionLoader, fsDispose, fileLog),
         };
     }
-    const isProxyMode = config.fs?.veryfront?.proxyMode === true;
-    const isProductionMode = config.fs?.veryfront?.productionMode === true;
-    if (isProxyMode) {
-        bootstrapLog.debug("Skipping config reload in proxy mode (using local config)");
-    }
-    else if (isProductionMode) {
-        bootstrapLog.debug("Skipping config reload in production mode (using local config)");
-    }
-    else {
-        bootstrapLog.debug("Reloading config with FSAdapter");
-        clearConfigCache();
-        const originalConfig = config;
-        const reloadedConfig = await getConfig(projectDir, enhancedAdapter);
-        const usesDefaultDevConfig = reloadedConfig.dev?.port === 3000 &&
-            reloadedConfig.dev?.host === "localhost" &&
-            !reloadedConfig.dev?.hmr;
-        if (usesDefaultDevConfig && originalConfig.dev) {
-            bootstrapLog.debug("Keeping original config (FSAdapter returned defaults)");
-            config = originalConfig;
-        }
-        else {
-            config = reloadedConfig;
-        }
-    }
-    bootstrapLog.debug("Framework initialized successfully", {
-        projectDir,
-        runtime: adapter.id,
-        fsAdapter: fsType,
-    });
-    let fsDispose;
-    if (isExtendedFSAdapter(enhancedAdapter.fs)) {
-        const underlying = enhancedAdapter.fs.getUnderlyingAdapter();
-        if ("dispose" in underlying &&
-            typeof underlying.dispose === "function") {
-            fsDispose = () => underlying.dispose();
-        }
+    catch (err) {
+        await teardownFileLog(fileLog);
+        throw err;
     }
-    // If extension orchestration fails after the FS adapter has been wired up,
-    // release the FS resources (WebSocket connections, caches) before
-    // propagating the error — otherwise the adapter would leak.
-    const extensionLoader = await orchestrateOrDisposeFS(() => orchestrateExtensions({
-        projectDir,
-        config,
-        logger: bootstrapLog,
-        primeContracts: { [AIProviderRegistryName]: createAIProviderRegistry() },
-        builtinExtensions: createBuiltinExtensions(),
-    }), fsDispose);
-    wireTracingShim();
-    assertRequiredContracts();
-    return {
-        adapter: enhancedAdapter,
-        config,
-        usingFSAdapter: true,
-        fsAdapterType: fsType,
-        extensionLoader,
-        dispose: combineDispose(extensionLoader, fsDispose),
-    };
 }
 export async function bootstrapDev(projectDir, adapter) {
     bootstrapDevLog.debug("Starting development mode initialization");

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.402";
+export declare const VERSION = "0.1.404";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.402";
+export const VERSION = "0.1.404";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.402",
+  "version": "0.1.404",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/cli/commands/install/registry.ts

@@ -1,4 +1,4 @@
-import { readTextFile } from "../../../src/platform/index.js";
+import manifest from "../../templates/manifest.js";
 import { type AITool, type AIToolId, AIToolIdSchema, AIToolSchema } from "./types.js";
 
 const AI_TOOLS_RAW = [
@@ -67,6 +67,13 @@ export function isValidToolId(id: string): id is AIToolId {
 
 export function getTemplateContent(toolId: string): Promise<string> {
   const { template } = getToolById(toolId);
-  const templatePath = new URL(`../../templates/ai-rules/${template}`, import.meta.url).pathname;
-  return readTextFile(templatePath);
+  const entry = (manifest as Record<string, unknown>).templates as Record<
+    string,
+    { files: Record<string, string> }
+  >;
+  const aiRule = entry[`ai-rules:${template}`];
+  if (!aiRule) throw new Error(`Template not found in manifest: ${template}`);
+  const content = aiRule.files[template];
+  if (!content) throw new Error(`Template file not found in manifest: ${template}`);
+  return Promise.resolve(content);
 }

package/src/cli/templates/manifest.js

@@ -587,6 +587,36 @@ export default {
         "app/api/auth/docs-google/callback/route.ts": "import { createOAuthCallbackHandler, docsGoogleConfig } from \"veryfront/oauth\";\nimport { tokenStore } from \"../../../../../lib/token-store.ts\";\nimport { oauthMemoryTokenStore } from \"../../../../../lib/oauth-memory-store.ts\";\n\nconst hybridTokenStore = {\n  getTokens(serviceId: string, userId: string) {\n    return tokenStore.getToken(userId, serviceId);\n  },\n  async setTokens(\n    serviceId: string,\n    userId: string,\n    tokens: { accessToken: string; refreshToken?: string; expiresAt?: number },\n  ) {\n    await tokenStore.setToken(userId, serviceId, tokens);\n  },\n  async clearTokens(serviceId: string, userId: string) {\n    await tokenStore.revokeToken(userId, serviceId);\n  },\n  setState(\n    state: string,\n    meta: {\n      userId: string;\n      serviceId: string;\n      codeVerifier?: string;\n      redirectUri?: string;\n      scopes?: string[];\n      createdAt: number;\n    },\n  ) {\n    return oauthMemoryTokenStore.setState(state, meta);\n  },\n  consumeState(state: string) {\n    return oauthMemoryTokenStore.consumeState(state);\n  },\n};\n\nexport const GET = createOAuthCallbackHandler(docsGoogleConfig, { tokenStore: hybridTokenStore });\n",
         "app/api/auth/docs-google/route.ts": "import { createOAuthInitHandler, docsGoogleConfig } from \"veryfront/oauth\";\nimport { oauthMemoryTokenStore } from \"../../../../../lib/oauth-memory-store.ts\";\n\n// TODO: Replace with real user ID from your auth system (e.g., session cookie, JWT).\n// NEVER return a shared constant in production - it breaks per-user token isolation (VULN-AUTH-2).\nfunction getUserId(_request: Request): string {\n  return \"current-user\";\n}\n\nexport const GET = createOAuthInitHandler(docsGoogleConfig, {\n  tokenStore: oauthMemoryTokenStore,\n  getUserId,\n});"
       }
+    },
+    "ai-rules:claude-code.md": {
+      "files": {
+        "claude-code.md": "# Veryfront Project\n\nZero-config React meta-framework for AI-native applications.\n\n## Quick Reference\n\n| Command                          | Purpose                                  |\n| -------------------------------- | ---------------------------------------- |\n| `veryfront dev`                  | Start dev server (http://localhost:3000) |\n| `veryfront build`                | Production build                         |\n| `veryfront deploy`               | Deploy to Veryfront cloud                |\n| `veryfront generate page <name>` | Generate new page                        |\n| `veryfront generate api <name>`  | Generate API route                       |\n\n## Project Structure\n\n- `src/pages/*.tsx` → Routes (file-based routing)\n- `src/api/*.ts` → API endpoints (`/api/*`)\n- `src/components/` → Shared components\n- `agents/` → AI agents\n- `tools/` → MCP tools\n\n## When Asked to Add Features\n\n1. **Pages**: Create in `src/pages/` (e.g., `about.tsx` → `/about`)\n2. **APIs**: Create in `src/api/` (e.g., `users.ts` → `/api/users`)\n3. **Components**: Create in `src/components/`\n4. **AI Agents**: Create in `agents/`\n\n## Code Patterns\n\n```tsx\n// Page (src/pages/about.tsx)\nexport default function About() {\n  return <h1>About</h1>;\n}\n\n// API (src/api/hello.ts)\nexport function GET() {\n  return Response.json({ message: \"Hello\" });\n}\n\n// Dynamic API (src/api/users/[id].ts)\nexport function GET(_req: Request, { params }: { params: { id: string } }) {\n  return Response.json({ id: params.id });\n}\n```\n\n## Conventions\n\n- Use TypeScript\n- Use React 19 features\n- Use Tailwind for styling\n- Co-locate tests (`*.test.ts`)\n- Use `#veryfront/*` imports\n\n## Testing\n\n- Run `veryfront dev` and check browser\n- API endpoints at `/api/*`\n- Run `deno task test` for tests\n"
+      }
+    },
+    "ai-rules:skill.md": {
+      "files": {
+        "skill.md": "---\nname: veryfront\ndescription: Build and deploy fullstack AI-native React apps with Veryfront CLI\nlicense: MIT\ncompatibility: Claude Code, Cursor, VS Code, Codex, Gemini CLI\nmetadata:\n  author: veryfront\n  version: \"1.0\"\n---\n\n# Veryfront\n\nZero-config React meta-framework for AI-native applications.\n\n## Commands\n\n| Command                          | Purpose                           |\n| -------------------------------- | --------------------------------- |\n| `veryfront dev`                  | Start development server with HMR |\n| `veryfront build`                | Build for production              |\n| `veryfront deploy`               | Deploy to Veryfront cloud         |\n| `veryfront generate page <name>` | Generate a new page               |\n| `veryfront generate api <name>`  | Generate an API route             |\n\n## Project Structure\n\n```\nsrc/\n├── pages/           # File-based routing (*.tsx → routes)\n├── api/             # API routes (*.ts → /api/*)\n├── components/      # Shared React components\n├── ai/\n│   ├── agents/      # AI agents\n│   └── tools/       # MCP tools\n└── styles/          # Global styles\n```\n\n## Adding Features\n\n- **New page**: Create `src/pages/about.tsx` → `/about`\n- **API endpoint**: Create `src/api/users.ts` → `/api/users`\n- **AI agent**: Create `agents/assistant.ts`\n- **MCP tool**: Create `tools/search.ts`\n\n## Code Examples\n\n### Page Component\n\n```tsx\n// src/pages/about.tsx\nexport default function About() {\n  return <h1>About</h1>;\n}\n```\n\n### API Route\n\n```ts\n// src/api/hello.ts\nexport function GET() {\n  return Response.json({ message: \"Hello\" });\n}\n```\n\n### Dynamic API Route\n\n```ts\n// src/api/users/[id].ts\nexport function GET(_req: Request, { params }: { params: { id: string } }) {\n  return Response.json({ id: params.id });\n}\n```\n\n## Conventions\n\n- TypeScript required\n- React 19 features (use, Server Components)\n- Tailwind CSS for styling\n- Co-locate tests with implementation\n- Use `#veryfront/*` imports for framework modules\n\n## Testing\n\n- Development: `veryfront dev` (http://localhost:3000)\n- API endpoints: `/api/*`\n- Run tests: `deno task test`\n"
+      }
+    },
+    "ai-rules:copilot.md": {
+      "files": {
+        "copilot.md": "# Veryfront Project Instructions\n\nThis is a Veryfront project - a zero-config React meta-framework for AI-native applications.\n\n## CLI Commands\n\n- `veryfront dev` - Start development server with hot module replacement\n- `veryfront build` - Build for production deployment\n- `veryfront deploy` - Deploy to Veryfront cloud\n- `veryfront generate page <name>` - Scaffold a new page\n- `veryfront generate api <name>` - Scaffold an API route\n\n## File Structure\n\nThe project uses file-based routing:\n\n- `src/pages/*.tsx` - React pages (automatically become routes)\n- `src/api/*.ts` - API endpoints (accessible at `/api/*`)\n- `src/components/` - Shared React components\n- `agents/` - AI agent definitions\n- `tools/` - MCP tool implementations\n\n## Code Patterns\n\n### Creating a Page\n\n```tsx\n// src/pages/about.tsx → accessible at /about\nexport default function About() {\n  return <h1>About</h1>;\n}\n```\n\n### Creating an API Endpoint\n\n```ts\n// src/api/hello.ts → accessible at /api/hello\nexport function GET() {\n  return Response.json({ message: \"Hello\" });\n}\n\nexport function POST(request: Request) {\n  // Handle POST request\n  return Response.json({ success: true });\n}\n```\n\n### Dynamic Routes\n\n```ts\n// src/api/users/[id].ts → accessible at /api/users/:id\nexport function GET(_req: Request, { params }: { params: { id: string } }) {\n  return Response.json({ userId: params.id });\n}\n```\n\n## Technology Stack\n\n- Runtime: Deno\n- UI: React 19 with Server Components\n- Styling: Tailwind CSS\n- Language: TypeScript (required)\n\n## Best Practices\n\n- Co-locate test files with implementation (`*.test.ts`)\n- Use `#veryfront/*` import aliases for framework modules\n- Follow React 19 patterns (use hook, Server Components)\n- Use Response.json() for API responses\n"
+      }
+    },
+    "ai-rules:windsurf.md": {
+      "files": {
+        "windsurf.md": "# Veryfront Project\n\nYou are in a Veryfront project - zero-config React meta-framework for AI-native applications.\n\n## Commands\n\n- `veryfront dev` - Start development server with HMR\n- `veryfront build` - Build for production\n- `veryfront deploy` - Deploy to Veryfront cloud\n- `veryfront generate page <name>` - Generate a new page\n- `veryfront generate api <name>` - Generate an API route\n\n## Project Structure\n\n```\nsrc/\n├── pages/           # File-based routing (pages/*.tsx → routes)\n├── api/             # API routes (api/*.ts → /api/*)\n├── components/      # Shared React components\n├── ai/\n│   ├── agents/      # AI agents\n│   └── tools/       # MCP tools\n└── styles/          # Global styles\n```\n\n## Adding Features\n\n- **New page**: Create `src/pages/about.tsx` → accessible at `/about`\n- **API endpoint**: Create `src/api/users.ts` → accessible at `/api/users`\n- **AI agent**: Create `agents/assistant.ts`\n- **MCP tool**: Create `tools/search.ts`\n\n## Conventions\n\n- TypeScript required\n- React 19 features (use, Server Components)\n- Tailwind CSS for styling\n- Co-locate tests with implementation (`*.test.ts`)\n- Use `#veryfront/*` imports for framework modules\n\n## File Patterns\n\n```tsx\n// Page component (src/pages/about.tsx)\nexport default function About() {\n  return <h1>About</h1>;\n}\n\n// API route (src/api/hello.ts)\nexport function GET() {\n  return Response.json({ message: \"Hello\" });\n}\n\n// API with params (src/api/users/[id].ts)\nexport function GET(_req: Request, { params }: { params: { id: string } }) {\n  return Response.json({ id: params.id });\n}\n```\n\n## Testing\n\n- Run `veryfront dev` and check browser at http://localhost:3000\n- API endpoints available at `/api/*`\n- Use `deno task test` to run tests\n"
+      }
+    },
+    "ai-rules:agents.md": {
+      "files": {
+        "agents.md": "# Veryfront Agent Instructions\n\nThis is a Veryfront project. Veryfront is a zero-config React meta-framework for AI-native applications.\n\n## Commands\n\n- `npx veryfront dev` - Start development server\n- `npx veryfront build` - Build for production\n- `npx veryfront deploy` - Deploy to cloud\n- `npx veryfront generate page <name>` - Generate a page\n- `npx veryfront generate api <name>` - Generate an API route\n\n## File Conventions\n\n- **Pages**: `src/pages/*.tsx` (file-based routing)\n- **APIs**: `src/api/*.ts` (serverless functions at `/api/*`)\n- **Components**: `src/components/*.tsx`\n- **AI Agents**: `agents/*.ts`\n- **MCP Tools**: `tools/*.ts`\n\n## Examples\n\n### Create a new page\n\n```tsx\n// src/pages/about.tsx\nexport default function About() {\n  return <h1>About</h1>;\n}\n```\n\nThis page will be accessible at `/about`.\n\n### Create an API endpoint\n\n```ts\n// src/api/hello.ts\nexport function GET() {\n  return Response.json({ message: \"Hello\" });\n}\n\nexport function POST(request: Request) {\n  return Response.json({ success: true });\n}\n```\n\nThis API will be accessible at `/api/hello`.\n\n### Create a dynamic API route\n\n```ts\n// src/api/users/[id].ts\nexport function GET(_req: Request, { params }: { params: { id: string } }) {\n  return Response.json({ userId: params.id });\n}\n```\n\nThis API will be accessible at `/api/users/:id`.\n\n## Technology Stack\n\n- **Runtime**: Deno\n- **UI Framework**: React 19\n- **Styling**: Tailwind CSS\n- **Language**: TypeScript\n\n## Best Practices\n\n- Co-locate tests with implementation files (`*.test.ts`)\n- Use `#veryfront/*` import aliases\n- Use React 19 features (use hook, Server Components)\n- Return `Response.json()` from API routes\n"
+      }
+    },
+    "ai-rules:cursor.md": {
+      "files": {
+        "cursor.md": "# Veryfront Project\n\nYou are in a Veryfront project - zero-config React meta-framework for AI-native applications.\n\n## Commands\n\n- `veryfront dev` - Start development server with HMR\n- `veryfront build` - Build for production\n- `veryfront deploy` - Deploy to Veryfront cloud\n- `veryfront generate page <name>` - Generate a new page\n- `veryfront generate api <name>` - Generate an API route\n\n## Project Structure\n\n```\nsrc/\n├── pages/           # File-based routing (pages/*.tsx → routes)\n├── api/             # API routes (api/*.ts → /api/*)\n├── components/      # Shared React components\n├── ai/\n│   ├── agents/      # AI agents\n│   └── tools/       # MCP tools\n└── styles/          # Global styles\n```\n\n## Adding Features\n\n- **New page**: Create `src/pages/about.tsx` → accessible at `/about`\n- **API endpoint**: Create `src/api/users.ts` → accessible at `/api/users`\n- **AI agent**: Create `agents/assistant.ts`\n- **MCP tool**: Create `tools/search.ts`\n\n## Conventions\n\n- TypeScript required\n- React 19 features (use, Server Components)\n- Tailwind CSS for styling\n- Co-locate tests with implementation (`*.test.ts`)\n- Use `#veryfront/*` imports for framework modules\n\n## File Patterns\n\n```tsx\n// Page component (src/pages/about.tsx)\nexport default function About() {\n  return <h1>About</h1>;\n}\n\n// API route (src/api/hello.ts)\nexport function GET() {\n  return Response.json({ message: \"Hello\" });\n}\n\n// API with params (src/api/users/[id].ts)\nexport function GET(_req: Request, { params }: { params: { id: string } }) {\n  return Response.json({ id: params.id });\n}\n```\n\n## Testing\n\n- Run `veryfront dev` and check browser at http://localhost:3000\n- API endpoints available at `/api/*`\n- Use `deno task test` to run tests\n"
+      }
     }
   }
 };

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.402",
+  "version": "0.1.404",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [

package/src/src/agent/conversation-hosted-terminal.ts

@@ -12,6 +12,92 @@ export interface ConversationHostedTerminalStateInput {
   terminalErrorMessage?: string | null;
 }
 
+export const CONVERSATION_HOSTED_STREAM_ERROR_TERMINAL_ERROR_CODE = "STREAM_ERROR";
+export const CONVERSATION_HOSTED_ABORTED_TERMINAL_ERROR_CODE = "ABORTED";
+export const CONVERSATION_HOSTED_INCOMPLETE_TOOL_CALLS_TERMINAL_ERROR_CODE =
+  "INCOMPLETE_TOOL_CALLS";
+
+const DEFAULT_CONVERSATION_HOSTED_ABORTED_TERMINAL_ERROR_MESSAGE = "Chat stream aborted";
+const DEFAULT_CONVERSATION_HOSTED_INCOMPLETE_TOOL_CALLS_TERMINAL_ERROR_MESSAGE =
+  "Assistant completed before tool execution completed";
+
+export interface ResolveConversationHostedTerminalStateInput {
+  isAborted: boolean;
+  hasIncompleteToolParts: boolean;
+  abortedTerminalErrorMessage?: string;
+  incompleteToolCallsTerminalErrorMessage?: string;
+}
+
+export type ConversationHostedTerminalStateResolution = Pick<
+  ConversationHostedTerminalStateInput,
+  "status" | "terminalErrorCode" | "terminalErrorMessage"
+>;
+
+export function resolveConversationHostedTerminalState(
+  input: ResolveConversationHostedTerminalStateInput,
+): ConversationHostedTerminalStateResolution {
+  if (input.isAborted) {
+    return {
+      status: "cancelled",
+      terminalErrorCode: CONVERSATION_HOSTED_ABORTED_TERMINAL_ERROR_CODE,
+      terminalErrorMessage: input.abortedTerminalErrorMessage ??
+        DEFAULT_CONVERSATION_HOSTED_ABORTED_TERMINAL_ERROR_MESSAGE,
+    };
+  }
+
+  if (input.hasIncompleteToolParts) {
+    return {
+      status: "failed",
+      terminalErrorCode: CONVERSATION_HOSTED_INCOMPLETE_TOOL_CALLS_TERMINAL_ERROR_CODE,
+      terminalErrorMessage: input.incompleteToolCallsTerminalErrorMessage ??
+        DEFAULT_CONVERSATION_HOSTED_INCOMPLETE_TOOL_CALLS_TERMINAL_ERROR_MESSAGE,
+    };
+  }
+
+  return { status: "completed" };
+}
+
+export function resolveConversationHostedStreamErrorState(
+  error: unknown,
+): ConversationHostedTerminalStateResolution {
+  return {
+    status: "failed",
+    terminalErrorCode: CONVERSATION_HOSTED_STREAM_ERROR_TERMINAL_ERROR_CODE,
+    terminalErrorMessage: error instanceof Error ? error.message : String(error),
+  };
+}
+
+export interface ConversationHostedTerminalRuntimeAdapter {
+  terminal: Pick<
+    ConversationHostedTerminalAdapter,
+    "toTerminalState" | "finalizeRun" | "cancelRun" | "onTerminalState"
+  >;
+}
+
+export async function dispatchConversationHostedTerminalState(
+  adapter: ConversationHostedTerminalRuntimeAdapter,
+  state: ConversationHostedTerminalStateInput,
+): Promise<HostedLifecycleTerminalState> {
+  const terminalState = adapter.terminal.toTerminalState(state);
+  if (terminalState.status === "cancelled") {
+    await adapter.terminal.cancelRun(terminalState);
+  } else {
+    await adapter.terminal.finalizeRun(terminalState);
+  }
+  await adapter.terminal.onTerminalState(terminalState);
+  return terminalState;
+}
+
+export async function dispatchConversationHostedStreamErrorState(
+  adapter: ConversationHostedTerminalRuntimeAdapter,
+  error: unknown,
+): Promise<HostedLifecycleTerminalState> {
+  return dispatchConversationHostedTerminalState(
+    adapter,
+    resolveConversationHostedStreamErrorState(error),
+  );
+}
+
 export interface CreateConversationHostedTerminalAdapterOptions {
   authToken: string;
   apiUrl: string;

package/src/src/agent/hosted-child-status.ts

@@ -30,6 +30,33 @@ export function isHostedChildTerminalErrorCode(
   );
 }
 
+export interface HostedChildSameTurnRetryBlockSignal {
+  terminalErrorCode?: string | null;
+  terminalErrorMessage?: string | null;
+}
+
+function getOptionalStringProperty(value: object, property: string): string | null {
+  const descriptor = Object.getOwnPropertyDescriptor(value, property);
+  return typeof descriptor?.value === "string" ? descriptor.value : null;
+}
+
+export function shouldBlockHostedChildSameTurnRetry(
+  result: unknown,
+): result is HostedChildSameTurnRetryBlockSignal {
+  if (typeof result !== "object" || result === null) {
+    return false;
+  }
+
+  const terminalErrorCode = getOptionalStringProperty(result, "terminalErrorCode");
+  const terminalErrorMessage = getOptionalStringProperty(result, "terminalErrorMessage");
+
+  return (
+    terminalErrorCode === "CANCELLED" ||
+    terminalErrorCode === hostedChildTerminalErrorCodes.cancelled ||
+    terminalErrorMessage === "Child run cancelled"
+  );
+}
+
 export type HostedChildTerminalStatus = Extract<
   HostedConversationRunStatus,
   "completed" | "failed" | "cancelled"

package/src/src/agent/index.ts

@@ -495,10 +495,20 @@ export {
   createConversationHostedStreamLifecycleAdapter,
 } from "./conversation-hosted-lifecycle.js";
 export {
+  CONVERSATION_HOSTED_ABORTED_TERMINAL_ERROR_CODE,
+  CONVERSATION_HOSTED_INCOMPLETE_TOOL_CALLS_TERMINAL_ERROR_CODE,
+  CONVERSATION_HOSTED_STREAM_ERROR_TERMINAL_ERROR_CODE,
   type ConversationHostedTerminalAdapter,
+  type ConversationHostedTerminalRuntimeAdapter,
   type ConversationHostedTerminalStateInput,
+  type ConversationHostedTerminalStateResolution,
   createConversationHostedTerminalAdapter,
   type CreateConversationHostedTerminalAdapterOptions,
+  dispatchConversationHostedStreamErrorState,
+  dispatchConversationHostedTerminalState,
+  resolveConversationHostedStreamErrorState,
+  resolveConversationHostedTerminalState,
+  type ResolveConversationHostedTerminalStateInput,
   toConversationHostedTerminalState,
 } from "./conversation-hosted-terminal.js";
 export {

package/src/src/config/schemas/config.schema.ts

@@ -261,6 +261,22 @@ export const veryfrontConfigSchema = z
           })
           .partial()
           .optional(),
+        logging: z
+          .object({
+            file: z
+              .object({
+                enabled: z.boolean().optional(),
+                path: z.string().optional(),
+                maxSize: z.union([z.number().int().positive(), z.string()]).optional(),
+                maxFiles: z.number().int().positive().optional(),
+                level: z.enum(["debug", "info", "warn", "error"]).optional(),
+                format: z.enum(["json", "text"]).optional(),
+              })
+              .partial()
+              .optional(),
+          })
+          .partial()
+          .optional(),
       })
       .partial()
       .optional(),