veryfront 0.1.48 → 0.1.49

package/src/cli/mcp/server.ts

@@ -8,14 +8,12 @@
 import * as dntShim from "../../_dnt.shims.js";
 
 
-import { readTextFile } from "../../src/platform/index.js";
+import { cwd, readTextFile } from "../../src/platform/index.js";
 import { createHttpServer, type HttpServer } from "../../src/platform/compat/http/index.js";
-import { cwd } from "../../src/platform/index.js";
 import type { StdinReader } from "../../src/platform/index.js";
 import { withSpan } from "../../src/observability/tracing/otlp-setup.js";
 import { createIssuesManager } from "../../src/issues/index.js";
-import { getErrorCollector } from "../../src/observability/index.js";
-import { getLogBuffer } from "../../src/observability/index.js";
+import { getErrorCollector, getLogBuffer } from "../../src/observability/index.js";
 import { allTools, getTool, setServerStartTime } from "./tools.js";
 import { startStdioJsonRpc } from "./stdio.js";
 import {
@@ -485,6 +483,5 @@ export function createMCPServer(config: MCPServerConfig): MCPDevServer {
   return server;
 }
 
-export * from "../../src/observability/index.js";
 export * from "../../src/observability/index.js";
 export * from "./tools.js";

package/src/cli/mcp/tools/dev-tools.ts

@@ -8,8 +8,7 @@ import { z } from "zod";
 import { getEnvironmentConfig } from "../../../src/config/index.js";
 import { withSpan } from "../../../src/observability/tracing/otlp-setup.js";
 import { ReloadNotifier } from "../../../src/server/index.js";
-import { getErrorCollector } from "../../../src/observability/index.js";
-import { getLogBuffer } from "../../../src/observability/index.js";
+import { getErrorCollector, getLogBuffer } from "../../../src/observability/index.js";
 import type { MCPTool } from "../tools.js";
 import { formatError } from "./helpers.js";
 

package/src/cli/mcp/tools.ts

@@ -3,8 +3,14 @@
  **************************/
 
 import { z } from "zod";
-import { type DevError, type ErrorType, getErrorCollector } from "../../src/observability/index.js";
-import { getLogBuffer, type LogEntry, type LogLevel } from "../../src/observability/index.js";
+import {
+  type DevError,
+  type ErrorType,
+  getErrorCollector,
+  getLogBuffer,
+  type LogEntry,
+  type LogLevel,
+} from "../../src/observability/index.js";
 import { createFileSystem } from "../../src/platform/index.js";
 import { type EnvironmentConfig, getEnvironmentConfig } from "../../src/config/index.js";
 import type { MCPTool } from "../../src/mcp/index.js";

package/src/cli/shared/reserve-slug.ts

@@ -11,6 +11,7 @@ import * as dntShim from "../../_dnt.shims.js";
 import { type EnvironmentConfig, getEnvironmentConfig } from "../../src/config/index.js";
 import { capitalizeSeparatedWords } from "../../src/utils/case-utils.js";
 import { randomSuffix } from "./slug.js";
+import { getApiUrl } from "./constants.js";
 
 function slugToName(slug: string): string {
   return capitalizeSeparatedWords(slug, "-", " ");
@@ -35,10 +36,6 @@ interface CreateProjectResult {
 
 const MAX_SLUG_ATTEMPTS = 10;
 
-function getApiUrl(env: EnvironmentConfig = getEnvironmentConfig()): string {
-  return env.apiUrl ?? "https://api.veryfront.com";
-}
-
 export async function reserveProjectSlug(
   slug: string,
   token: string,

package/src/cli/sync/ignore.ts

@@ -7,7 +7,7 @@ import { createFileSystem } from "../../src/platform/index.js";
 import { cliLogger } from "../utils/index.js";
 
 /** Default patterns always ignored */
-const DEFAULT_IGNORE_PATTERNS = [
+const DEFAULT_IGNORE_PATTERNS: readonly string[] = [
   // Directories
   "node_modules",
   "dist",
@@ -91,23 +91,35 @@ export async function loadIgnorePatterns(projectPath: string): Promise<string[]>
 }
 
 /**
- * Create an ignore checker with loaded patterns
+ * Escape special regex characters
  */
-export function createIgnoreChecker(patterns: string[]): IgnoreChecker {
-  const regexPatterns = patterns.map((pattern) => {
-    if (pattern.endsWith("/")) {
-      const dirName = pattern.slice(0, -1);
-      return new RegExp(`(^|/)${escapeRegex(dirName)}(/|$)`);
-    }
+function escapeRegex(str: string): string {
+  return str.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+}
 
-    const regex = escapeRegex(pattern)
-      .replace(/\\\*/g, ".*") // * matches anything
-      .replace(/\\\?/g, "."); // ? matches single char
+/**
+ * Convert a single ignore pattern to a RegExp
+ */
+function patternToRegex(pattern: string): RegExp {
+  if (pattern.endsWith("/")) {
+    const dirName = pattern.slice(0, -1);
+    return new RegExp(`(^|/)${escapeRegex(dirName)}(/|$)`);
+  }
 
-    if (pattern.startsWith("*")) return new RegExp(`(^|/)${regex}$`);
+  const regex = escapeRegex(pattern)
+    .replace(/\\\*/g, ".*") // * matches anything
+    .replace(/\\\?/g, "."); // ? matches single char
 
-    return new RegExp(`(^|/)${regex}(/|$)`);
-  });
+  if (pattern.startsWith("*")) return new RegExp(`(^|/)${regex}$`);
+
+  return new RegExp(`(^|/)${regex}(/|$)`);
+}
+
+/**
+ * Create an ignore checker with loaded patterns
+ */
+export function createIgnoreChecker(patterns: readonly string[]): IgnoreChecker {
+  const regexPatterns = patterns.map(patternToRegex);
 
   function isIgnored(relativePath: string): boolean {
     const normalizedPath = relativePath.replace(/\\/g, "/");
@@ -123,13 +135,6 @@ export function createIgnoreChecker(patterns: string[]): IgnoreChecker {
   return { isIgnored, isSupportedExtension };
 }
 
-/**
- * Escape special regex characters
- */
-function escapeRegex(str: string): string {
-  return str.replace(/[.+^${}()|[\]\\]/g, "\\$&");
-}
-
 /**
  * Create default ignore checker (without loading .vfignore)
  */

package/src/cli/ui/colors.ts

@@ -207,18 +207,6 @@ export const errorBold = (text: string) => bold(error(text));
 
 export { RESET as reset };
 
-const MATRIX_STATES = [
-  ["●", "○", "○"],
-  ["○", "●", "○"],
-  ["○", "○", "●"],
-  ["○", "●", "○"],
-];
-
-export function animatedMatrix(frame: number): string {
-  const state = MATRIX_STATES[frame % MATRIX_STATES.length] ?? ["●", "○", "○"];
-  return state.map((dot) => (dot === "●" ? brand(dot) : muted(dot))).join("");
-}
-
 /**
  * Apply shimmer effect to text - creates a wave of brightness moving across
  * @param text The text to shimmer

package/src/cli/ui/dot-matrix.ts

@@ -7,6 +7,8 @@
 import * as dntShim from "../../_dnt.shims.js";
 
 
+import { RESET } from "./ansi.js";
+
 export const AGENT_FACE: number[][] = [
   [0, 0, 0, 0, 0, 0, 0],
   [0, 1, 1, 1, 0, 0, 0],
@@ -62,8 +64,6 @@ const COMPACT_OPTIONS: Partial<DotMatrixOptions> = {
   spacing: " ",
 };
 
-const RESET = "\x1b[0m";
-
 const SPIN_COLORS = {
   bright: "\x1b[38;2;255;165;120m",
   orange: "\x1b[38;2;252;143;93m",
@@ -317,9 +317,7 @@ export class AnimatedDotMatrix {
   }
 
   stopSpinner(): void {
-    this._spinning = false;
-    this.clearInterval();
-    this.pattern = AGENT_FACE;
+    this.stop();
   }
 
   stop(): void {
@@ -330,7 +328,6 @@ export class AnimatedDotMatrix {
 
   reset(): void {
     this.stop();
-    this.pattern = AGENT_FACE;
   }
 
   setPattern(pattern: number[][]): void {

package/src/cli/ui/tui.ts

@@ -55,6 +55,8 @@ function render(): void {
   getSize();
   const lines: string[] = [""];
 
+  const spinner = getSpinnerFrame(spinnerFrame);
+
   const infoKeys = Object.keys(state.info);
   if (infoKeys.length > 0) {
     const maxKeyLen = Math.max(...infoKeys.map((k) => k.length));
@@ -66,7 +68,6 @@ function render(): void {
   }
 
   if (state.steps.length > 0) {
-    const spinner = getSpinnerFrame(spinnerFrame);
     const stepLine = state.steps
       .map((s, i) => {
         const icon = s.done ? success("✓") : i === state.currentStep ? brand(spinner) : dim("○");
@@ -77,11 +78,10 @@ function render(): void {
     lines.push(`  ${stepLine}`, "");
   }
 
-  const spinnerChar = getSpinnerFrame(spinnerFrame);
   let statusIcon = dim("○");
   switch (state.statusType) {
     case "loading":
-      statusIcon = brand(spinnerChar);
+      statusIcon = brand(spinner);
       break;
     case "success":
       statusIcon = success("●");

package/src/cli/utils/index.ts

@@ -6,9 +6,9 @@ import {
   onSignal,
   promptSync,
   readStdinByteSync,
+  setRawMode,
   writeStdout,
 } from "../../src/platform/index.js";
-import { setRawMode } from "../../src/platform/index.js";
 import { DEFAULT_DEV_PORT } from "../shared/constants.js";
 import {
   bold,

package/src/cli/utils/package-manager.ts

@@ -6,8 +6,8 @@
 
 import { join } from "../../src/platform/compat/path/index.js";
 import { cliLogger as logger } from "./index.js";
-import { createFileSystem, getEnv } from "../../src/platform/index.js";
-import { getOsType, runCommand } from "../../src/platform/index.js";
+import { getEnv, getOsType, runCommand } from "../../src/platform/index.js";
+import { getFs } from "./fs.js";
 
 export type PackageManager = "npm" | "yarn" | "pnpm" | "bun" | "deno";
 
@@ -66,7 +66,7 @@ const LOCKFILES: Array<{ file: string; pm: PackageManager }> = [
 async function detectFromDir(
   dir: string,
 ): Promise<{ pm: PackageManager; file: string } | undefined> {
-  const fs = createFileSystem();
+  const fs = getFs();
 
   for (const lock of LOCKFILES) {
     if (await fs.exists(join(dir, lock.file))) return lock;
@@ -160,7 +160,6 @@ export function getDlxCommand(pm: PackageManager): string {
     case "bun":
       return "bunx";
     case "npm":
-    default:
       return "npx";
   }
 }

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.48",
+  "version": "0.1.49",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [
@@ -66,7 +66,7 @@ export default {
     "veryfront/workflow/react": "./src/workflow/react/index.ts",
     "veryfront/workflow/executor": "./src/workflow/executor/index.ts",
     "veryfront/workflow/blob": "./src/workflow/blob/index.ts",
-    "veryfront/workflow/runtime": "./src/workflow/runtime/agent-registry.ts",
+    "veryfront/workflow/runtime": "./src/workflow/runtime/index.ts",
     "veryfront/workflow/worker": "./src/workflow/worker/index.ts",
     "veryfront/workflow/claude-code": "./src/workflow/claude-code/index.ts",
     "veryfront/workflow/claude-code/react": "./src/workflow/claude-code/react/index.ts",
@@ -134,6 +134,8 @@ export default {
     "#veryfront/resource": "./src/resource/index.ts",
     "#veryfront/routing": "./src/routing/index.ts",
     "#veryfront/security": "./src/security/index.ts",
+    "#veryfront/skill": "./src/skill/index.ts",
+    "#veryfront/skill/": "./src/skill/",
     "#veryfront/server": "./src/server/index.ts",
     "#veryfront/server/project-env": "./src/server/project-env/index.ts",
     "#veryfront/testing": "./src/testing/index.ts",
@@ -282,18 +284,19 @@ export default {
   },
   "tasks": {
     "setup": "deno run --allow-all scripts/setup.ts",
-    "start": "deno run -A scripts/build/generate-templates-manifest.ts && deno run --allow-all cli/main.ts",
-    "start:headless": "deno run --allow-all cli/main.ts --headless",
-    "proxy": "deno run --allow-all cli/main.ts serve --mode=proxy",
-    "dev": "deno run -A scripts/build/generate-templates-manifest.ts && deno run --allow-all cli/main.ts dev",
-    "production": "deno run --allow-all cli/main.ts serve --mode=production",
-    "build:prepare": "deno run -A scripts/build/generate-integrations-module.ts && deno run -A scripts/build/generate-templates-manifest.ts && deno run -A scripts/build/generate-dev-ui-manifest.ts && deno run -A scripts/build/prepare-framework-sources.ts && deno run -A scripts/build/prebundle-client-scripts.ts && deno run -A scripts/build/prebundle-bridge.ts",
+    "generate": "deno run -A scripts/build/generate-templates-manifest.ts && deno run -A scripts/build/generate-dev-ui-manifest.ts && deno run -A scripts/build/prebundle-client-scripts.ts && deno run -A scripts/build/prebundle-bridge.ts",
+    "start": "deno task generate && deno run --allow-all cli/main.ts",
+    "start:headless": "deno task generate && deno run --allow-all cli/main.ts --headless",
+    "proxy": "deno task generate && deno run --allow-all cli/main.ts serve --mode=proxy",
+    "dev": "deno task generate && deno run --allow-all cli/main.ts dev",
+    "production": "deno task generate && deno run --allow-all cli/main.ts serve --mode=production",
+    "build:prepare": "deno run -A scripts/build/generate-integrations-module.ts && deno task generate && deno run -A scripts/build/prepare-framework-sources.ts",
     "build": "deno task build:prepare && deno compile --allow-all --include src/platform/polyfills --include src/proxy/main.ts --include dist/framework-src --output ./bin/veryfront cli/main.ts",
-    "build:npm": "deno run -A scripts/build/generate-integrations-module.ts && deno run -A scripts/build/build-npm-dnt.ts",
+    "build:npm": "deno run -A scripts/build/generate-integrations-module.ts && deno task generate && deno run -A scripts/build/build-npm-dnt.ts",
     "release": "deno run -A scripts/release.ts",
-    "test": "VF_DISABLE_LRU_INTERVAL=1 SSR_TRANSFORM_PER_PROJECT_LIMIT=0 REVALIDATION_PER_PROJECT_LIMIT=0 NODE_ENV=production LOG_FORMAT=text deno test --no-check --parallel --allow-all '--ignore=tests/e2e,tests/integration/compiled-binary-e2e.test.ts' --unstable-worker-options --unstable-net",
-    "test:unit": "VF_DISABLE_LRU_INTERVAL=1 SSR_TRANSFORM_PER_PROJECT_LIMIT=0 REVALIDATION_PER_PROJECT_LIMIT=0 NODE_ENV=production LOG_FORMAT=text deno test --no-check --parallel --allow-all --v8-flags=--max-old-space-size=8192 '--ignore=tests,src/ai/workflow/__tests__' --unstable-worker-options --unstable-net $(find src cli -name '*.test.ts' ! -name '*.integration.test.ts')",
-    "test:integration": "VF_DISABLE_LRU_INTERVAL=1 SSR_TRANSFORM_PER_PROJECT_LIMIT=0 REVALIDATION_PER_PROJECT_LIMIT=0 NODE_ENV=production LOG_FORMAT=text deno test --no-check --parallel --allow-all '--ignore=tests/e2e,tests/integration/compiled-binary-e2e.test.ts' tests --unstable-worker-options --unstable-net",
+    "test": "deno task generate && VF_DISABLE_LRU_INTERVAL=1 SSR_TRANSFORM_PER_PROJECT_LIMIT=0 REVALIDATION_PER_PROJECT_LIMIT=0 NODE_ENV=production LOG_FORMAT=text deno test --no-check --parallel --allow-all '--ignore=tests/e2e,tests/integration/compiled-binary-e2e.test.ts' --unstable-worker-options --unstable-net",
+    "test:unit": "deno task generate && VF_DISABLE_LRU_INTERVAL=1 SSR_TRANSFORM_PER_PROJECT_LIMIT=0 REVALIDATION_PER_PROJECT_LIMIT=0 NODE_ENV=production LOG_FORMAT=text deno test --no-check --parallel --allow-all --v8-flags=--max-old-space-size=8192 '--ignore=tests,src/ai/workflow/__tests__' --unstable-worker-options --unstable-net $(find src cli -name '*.test.ts' ! -name '*.integration.test.ts')",
+    "test:integration": "deno task generate && VF_DISABLE_LRU_INTERVAL=1 SSR_TRANSFORM_PER_PROJECT_LIMIT=0 REVALIDATION_PER_PROJECT_LIMIT=0 NODE_ENV=production LOG_FORMAT=text deno test --no-check --parallel --allow-all '--ignore=tests/e2e,tests/integration/compiled-binary-e2e.test.ts' tests --unstable-worker-options --unstable-net",
     "test:integration:cli": "VF_DISABLE_LRU_INTERVAL=1 SSR_TRANSFORM_PER_PROJECT_LIMIT=0 REVALIDATION_PER_PROJECT_LIMIT=0 NODE_ENV=production LOG_FORMAT=text deno test --no-check --parallel --allow-all --unstable-worker-options --unstable-net $(find cli -name '*.integration.test.ts')",
     "test:record": "VCR=record deno test --no-check --allow-all $(find cli -name '*.integration.test.ts' -path '*/commands/*')",
     "test:coverage": "rm -rf coverage && VF_DISABLE_LRU_INTERVAL=1 SSR_TRANSFORM_PER_PROJECT_LIMIT=0 REVALIDATION_PER_PROJECT_LIMIT=0 NODE_ENV=production LOG_FORMAT=text deno test --no-check --parallel --fail-fast --allow-all --coverage=coverage '--ignore=tests/integration/compiled-binary-e2e.test.ts' --unstable-worker-options --unstable-net || exit 1",
@@ -305,9 +308,9 @@ export default {
     "lint": "DENO_NO_PACKAGE_JSON=1 deno lint src/ cli/",
     "fmt": "deno fmt src/ cli/",
     "fmt:check": "deno fmt --check src/ cli/",
-    "typecheck": "deno check src/index.ts cli/main.ts src/server/index.ts src/routing/api/index.ts src/rendering/index.ts src/platform/index.ts src/platform/adapters/index.ts src/build/index.ts src/build/production-build/index.ts src/transforms/index.ts src/config/index.ts src/utils/index.ts src/data/index.ts src/security/index.ts src/middleware/index.ts src/server/handlers/dev/index.ts src/server/handlers/request/api/index.ts src/rendering/cache/index.ts src/rendering/cache/stores/index.ts src/rendering/rsc/actions/index.ts src/html/index.ts src/modules/index.ts src/proxy/main.ts src/chat/index.ts src/markdown/index.ts src/mdx/index.ts src/fs/index.ts src/oauth/index.ts src/agent/index.ts src/tool/index.ts src/workflow/index.ts src/prompt/index.ts src/resource/index.ts src/mcp/index.ts src/provider/index.ts",
-    "verify": "deno fmt --check src/ cli/ && DENO_NO_PACKAGE_JSON=1 deno lint src/ cli/ && deno task lint:style && deno task lint:cli-boundary && deno task lint:wildcard-exports && deno task lint:barrel-jsdoc && deno task docs:validate && deno task typecheck && deno task test && deno task test:e2e:binary",
-    "verify:quick": "deno fmt --check src/ cli/ && DENO_NO_PACKAGE_JSON=1 deno lint src/ cli/ && deno task lint:style && deno task lint:cli-boundary && deno task lint:wildcard-exports && deno task lint:barrel-jsdoc && deno task docs:validate && deno task typecheck",
+    "typecheck": "deno task generate && deno check src/index.ts cli/main.ts src/server/index.ts src/routing/api/index.ts src/rendering/index.ts src/platform/index.ts src/platform/adapters/index.ts src/build/index.ts src/build/production-build/index.ts src/transforms/index.ts src/config/index.ts src/utils/index.ts src/data/index.ts src/security/index.ts src/middleware/index.ts src/server/handlers/dev/index.ts src/server/handlers/request/api/index.ts src/rendering/cache/index.ts src/rendering/cache/stores/index.ts src/rendering/rsc/actions/index.ts src/html/index.ts src/modules/index.ts src/proxy/main.ts src/chat/index.ts src/markdown/index.ts src/mdx/index.ts src/fs/index.ts src/oauth/index.ts src/agent/index.ts src/tool/index.ts src/workflow/index.ts src/prompt/index.ts src/resource/index.ts src/mcp/index.ts src/provider/index.ts",
+    "verify": "deno task generate && deno fmt --check src/ cli/ && DENO_NO_PACKAGE_JSON=1 deno lint src/ cli/ && deno task lint:style && deno task lint:cli-boundary && deno task lint:wildcard-exports && deno task lint:barrel-jsdoc && deno task docs:validate && deno task typecheck && deno task test && deno task test:e2e:binary",
+    "verify:quick": "deno task generate && deno fmt --check src/ cli/ && DENO_NO_PACKAGE_JSON=1 deno lint src/ cli/ && deno task lint:style && deno task lint:cli-boundary && deno task lint:wildcard-exports && deno task lint:barrel-jsdoc && deno task docs:validate && deno task typecheck",
     "docs": "rm -rf docs/reference && deno run --allow-read --allow-write --allow-run scripts/docs/generate-api-reference.ts",
     "docs:copy": "rm -rf ../../docs/docs/code/reference && cp -r docs/reference/ ../../docs/docs/code/reference/",
     "docs:validate": "deno run --allow-read scripts/docs/validate-api-reference.ts",
@@ -330,8 +333,8 @@ export default {
     "test:bun": "node ./tests/bun/run-tests.mjs src/",
     "test:all-runtimes": "deno task test:unit && deno task test:node && deno task test:bun",
     "test:e2e": "npx playwright test --config=tests/e2e/playwright.config.ts",
-    "test:e2e:binary": "deno test --allow-all tests/integration/compiled-binary-e2e.test.ts",
-    "test:e2e:binary:fresh": "VERYFRONT_BINARY_FRESH=1 deno test --allow-all tests/integration/compiled-binary-e2e.test.ts",
+    "test:e2e:binary": "deno task generate && deno test --allow-all tests/integration/compiled-binary-e2e.test.ts",
+    "test:e2e:binary:fresh": "deno task generate && VERYFRONT_BINARY_FRESH=1 deno test --allow-all tests/integration/compiled-binary-e2e.test.ts",
     "check:circular": "deno run -A jsr:@cunarist/deno-circular-deps src/index.ts",
     "cli": "deno run --allow-all cli/main.ts",
     "mcp": "deno run --allow-all cli/main.ts mcp",
@@ -345,8 +348,8 @@ export default {
     "rlm:example": "deno run -A scripts/rlm-ts/examples/basic.ts",
     "rlm:explore": "deno run -A scripts/rlm-ts/apps/explore.ts",
     "rlm:audit": "deno run -A scripts/rlm-ts/apps/audit.ts",
-    "start-split": "deno run --allow-all cli/main.ts serve --split",
-    "start-split:binary": "deno run --allow-all cli/main.ts serve --split --binary"
+    "start-split": "deno task generate && deno run --allow-all cli/main.ts serve --split",
+    "start-split:binary": "deno task generate && deno run --allow-all cli/main.ts serve --split --binary"
   },
   "lint": {
     "include": [

package/src/src/agent/chat-handler.ts

@@ -283,23 +283,20 @@ export function createChatHandler(
   // deno-lint-ignore no-explicit-any
   return async function POST(requestOrCtx: any): Promise<dntShim.Response> {
     const request = extractRequest(requestOrCtx);
-    // Resolve agent outside try so it's available in the catch block for
-    // extracting the system prompt in the 503 fallback response.
     let agent: ReturnType<typeof getAgent> | undefined;
     try {
       agent = getAgent(agentId);
     } catch {
       return dntShim.Response.json({ error: "Agent not found" }, { status: 404 });
     }
+    if (!agent) {
+      return dntShim.Response.json({ error: "Agent not found" }, { status: 404 });
+    }
 
     try {
       const body = await request.json();
       const { messages: rawMessages, model: requestModel } = chatRequestSchema.parse(body);
 
-      if (!agent) {
-        return dntShim.Response.json({ error: "Agent not found" }, { status: 404 });
-      }
-
       const context = typeof options?.context === "function"
         ? await options.context(request)
         : options?.context ?? { userId: "current-user" };
@@ -314,9 +311,7 @@ export function createChatHandler(
 
       if (isResponseLike(beforeStreamResult)) return beforeStreamResult;
 
-      let hookResult: ChatHandlerBeforeStreamResult | undefined;
-      if (beforeStreamResult) hookResult = beforeStreamResult;
-
+      const hookResult = beforeStreamResult ?? undefined;
       const messages = applyBeforeStreamResult(baseMessages, hookResult);
       const streamContext = hookResult?.context ?? context;
 
@@ -342,27 +337,17 @@ export function createChatHandler(
         );
       }
 
-      // Detect structured "no_ai_available" errors from local engine
+      // Detect structured "no_ai_available" errors from local engine.
+      // Never send the server-side system prompt to the client — it may
+      // contain business logic, personas, or internal instructions.
+      // The client (useChat) has its own systemPrompt option for browser fallback.
       const vfError = fromError(error);
       if (vfError?.type === "no_ai_available") {
-        let systemPrompt: string | undefined;
-        try {
-          systemPrompt = agent
-            ? typeof agent.config.system === "string"
-              ? agent.config.system
-              : typeof agent.config.system === "function"
-              ? await agent.config.system()
-              : undefined
-            : undefined;
-        } catch {
-          // If system prompt resolution fails, continue without it
-        }
         return dntShim.Response.json(
           {
             code: "NO_AI_AVAILABLE",
             fallback: "browser",
             model: DEFAULT_LOCAL_MODEL,
-            ...(systemPrompt ? { systemPrompt } : {}),
           },
           { status: 503 },
         );

package/src/src/agent/factory.ts

@@ -1,11 +1,19 @@
 import * as dntShim from "../../_dnt.shims.js";
-import type { Agent, AgentConfig, AgentResponse, Message } from "./types.js";
+import type { Agent, AgentConfig, AgentResponse, AgentStreamResult, Message } from "./types.js";
 import { AgentRuntime } from "./runtime/index.js";
 import {
   detectPlatform,
   validatePlatformCompatibility,
 } from "../platform/core-platform.js";
 import { registerTool } from "../mcp/index.js";
+import { toolRegistry } from "../tool/index.js";
+import { skillRegistry } from "../skill/registry.js";
+import { buildSkillManifestPrompt } from "../skill/prompt-augmentation.js";
+import {
+  createExecuteSkillScriptTool,
+  createLoadSkillReferenceTool,
+  createLoadSkillTool,
+} from "../skill/tools.js";
 import { agentRegistry } from "./composition/index.js";
 import { agentLogger } from "../utils/logger/logger.js";
 import { createError, toError } from "../errors/veryfront-error.js";
@@ -18,13 +26,11 @@ const STREAMING_HEADERS: Record<string, string> = {
   "x-vercel-ai-ui-message-stream": "v1",
 };
 
-export interface AgentStreamResult {
-  toDataStreamResponse(options?: {
-    headers?: Record<string, string>;
-    status?: number;
-    statusText?: string;
-  }): dntShim.Response;
-}
+const SKILL_TOOL_REGISTRATIONS = [
+  { id: "load-skill", create: createLoadSkillTool },
+  { id: "load-skill-reference", create: createLoadSkillReferenceTool },
+  { id: "execute-skill-script", create: createExecuteSkillScriptTool },
+] as const;
 
 function createAgentStreamResult(stream: ReadableStream<Uint8Array>): AgentStreamResult {
   return {
@@ -60,6 +66,45 @@ export function agent(config: AgentConfig): Agent {
     }
   }
 
+  // Skill tool registration (immutable config merge)
+  let mergedToolsConfig = config.tools;
+
+  if (config.skills) {
+    // Skill tools (load-skill, load-skill-reference, execute-skill-script) are
+    // framework infrastructure — shared across all projects. Project tools and
+    // skills themselves remain project-scoped. Using registerShared avoids
+    // scope mismatch between module-load time and request-handling time.
+    for (const registration of SKILL_TOOL_REGISTRATIONS) {
+      if (!toolRegistry.has(registration.id)) {
+        toolRegistry.registerShared(registration.id, registration.create());
+      }
+    }
+
+    // Ensure skill tools are enabled for this agent even when config.tools is undefined
+    if (config.tools !== true) {
+      mergedToolsConfig = {
+        ...(config.tools ?? {}),
+        "load-skill": true,
+        "load-skill-reference": true,
+        "execute-skill-script": true,
+      };
+    }
+  }
+
+  // System prompt augmentation with skill manifest.
+  // Re-resolve skills at invocation time so HMR changes are picked up.
+  const originalSystem = config.system;
+  const augmentedSystem = config.skills
+    ? async () => {
+      const currentSkills = skillRegistry.resolveForAgent(config.skills!);
+      const basePrompt = typeof originalSystem === "function"
+        ? await originalSystem()
+        : originalSystem;
+      if (!currentSkills.size) return basePrompt ?? "You are a helpful AI assistant.";
+      return `${basePrompt}\n\n${buildSkillManifestPrompt(currentSkills)}`;
+    }
+    : originalSystem;
+
   const platform = detectPlatform();
   const compatibility = validatePlatformCompatibility(
     {
@@ -86,7 +131,11 @@ export function agent(config: AgentConfig): Agent {
     agentLogger.warn(`Agent "${id}" warnings:\n${compatibility.warnings.join("\n")}`);
   }
 
-  const runtime = new AgentRuntime(id, config);
+  const runtime = new AgentRuntime(id, {
+    ...config,
+    tools: mergedToolsConfig,
+    system: augmentedSystem,
+  });
 
   const agentInstance: Agent = {
     id,

package/src/src/agent/index.ts

@@ -29,11 +29,26 @@
  * const assistant = agent({
  *   model: "openai/gpt-4o",
  *   system: "You are a helpful assistant.",
- *   tools: [searchTool],
+ *   tools: { search: searchTool },
  *   memory: { type: "conversation", maxMessages: 50 },
  * });
  * ```
  *
+ * @example Agent with skills
+ * ```ts
+ * import { agent } from "veryfront/agent";
+ *
+ * const assistant = agent({
+ *   model: "openai/gpt-4o",
+ *   system: "You are a support engineer. Use skills when relevant.",
+ *   skills: ["incident-response", "repo-maintainer"], // or `true` for all discovered skills
+ *   tools: {
+ *     Read: true,
+ *     "github:list-issues": true,
+ *   },
+ * });
+ * ```
+ *
  * @example Streaming API route
  * ```ts
  * // app/api/chat/route.ts

package/src/src/agent/memory/memory.ts

@@ -3,20 +3,11 @@ import {
   getTextFromMemoryParts,
   type Memory,
   type MemoryConfigBase,
-  type MemoryPersistence,
   type MemoryStats,
   type MinimalMessage,
 } from "./memory-interface.js";
 import { withSpan, withSpanSync } from "../../observability/tracing/otlp-setup.js";
 
-export {
-  estimateTokens,
-  type Memory,
-  type MemoryPersistence,
-  type MemoryStats,
-  type MinimalMessage,
-};
-
 type BasicMemoryType = "conversation" | "buffer";
 
 function getMessagesWithTrace<M extends MinimalMessage>(

package/src/src/agent/react/use-chat/types.ts

@@ -130,6 +130,8 @@ export interface UseChatResult {
   error: Error | null;
   /** Current model override (undefined = use agent default) */
   model: string | undefined;
+  /** The actual model being used after auto-upgrade (e.g. "anthropic/claude-sonnet-4-20250514") */
+  activeModel: string | undefined;
   /** Where inference is currently happening */
   inferenceMode: InferenceMode;
   /** Browser-side model loading/inference status (null when not using browser fallback) */