veryfront 0.1.629 → 0.1.631

package/esm/src/provider/local/local-embedding-engine.js

@@ -10,43 +10,29 @@
 import { serverLogger } from "../../utils/index.js";
 import { resolveLocalEmbeddingModel } from "./model-catalog.js";
 import { getTransformers } from "./local-engine.js";
+import { createPipelineCache } from "./pipeline-cache.js";
 const logger = serverLogger.component("local-embedding");
-/** Cached pipeline instances keyed by HuggingFace model ID */
-const pipelineCache = new Map();
-/** Whether a model is currently being loaded (prevents concurrent loads) */
-const loadingLocks = new Map();
+/**
+ * Bounded, dedup-aware cache of feature-extraction pipelines keyed by
+ * HuggingFace model id. Only loads a model on a cold cache miss; concurrent
+ * loads of the same model share a single promise.
+ */
+const embeddingPipelines = createPipelineCache(async (modelInfo) => {
+    const transformers = await getTransformers();
+    logger.info(`Loading local embedding model: ${modelInfo.hfId} (${modelInfo.dtype}, ~${modelInfo.sizeMB}MB)...`);
+    const pipe = (await transformers.pipeline("feature-extraction", modelInfo.hfId, {
+        dtype: modelInfo.dtype,
+        device: "cpu",
+    }));
+    logger.info(`Embedding model loaded: ${modelInfo.hfId}`);
+    return pipe;
+});
 /**
  * Load a feature-extraction pipeline for the given model.
  * Returns a cached pipeline if already loaded.
  */
-async function loadPipeline(modelInfo) {
-    const cacheKey = modelInfo.hfId;
-    const cached = pipelineCache.get(cacheKey);
-    if (cached)
-        return cached;
-    const existingLock = loadingLocks.get(cacheKey);
-    if (existingLock)
-        return existingLock;
-    const loadPromise = (async () => {
-        const transformers = await getTransformers();
-        logger.info(`Loading local embedding model: ${modelInfo.hfId} (${modelInfo.dtype}, ~${modelInfo.sizeMB}MB)...`);
-        const pipe = (await transformers.pipeline("feature-extraction", modelInfo.hfId, {
-            dtype: modelInfo.dtype,
-            device: "cpu",
-        }));
-        logger.info(`Embedding model loaded: ${modelInfo.hfId}`);
-        pipelineCache.set(cacheKey, pipe);
-        loadingLocks.delete(cacheKey);
-        return pipe;
-    })();
-    loadingLocks.set(cacheKey, loadPromise);
-    try {
-        return await loadPromise;
-    }
-    catch (error) {
-        loadingLocks.delete(cacheKey);
-        throw error;
-    }
+function loadPipeline(modelInfo) {
+    return embeddingPipelines.load(modelInfo.hfId, modelInfo);
 }
 /**
  * Generate embeddings for an array of texts using a local model.

package/esm/src/provider/local/local-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-engine.d.ts","sourceRoot":"","sources":["../../../../src/src/provider/local/local-engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"local-engine.d.ts","sourceRoot":"","sources":["../../../../src/src/provider/local/local-engine.ts"],"names":[],"mappings":"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"}

package/esm/src/provider/local/local-engine.js

@@ -15,6 +15,7 @@ import { createError, toError } from "../../errors/veryfront-error.js";
 import { importTransformers } from "../../platform/compat/opaque-deps.js";
 import { DEFAULT_LOCAL_MODEL, resolveLocalModel } from "./model-catalog.js";
 import { throwIfLocalAIDisabled } from "./env.js";
+import { createPipelineCache } from "./pipeline-cache.js";
 const logger = serverLogger.component("local-llm");
 /** Default maximum new tokens for local model generation */
 const DEFAULT_MAX_NEW_TOKENS = 512;
@@ -82,10 +83,6 @@ export function buildPipeOptions(options, transformers, tokenizer, streamer) {
     }
     return pipeOptions;
 }
-/** Cached pipeline instances keyed by HuggingFace model ID */
-const pipelineCache = new Map();
-/** Whether a model is currently being loaded (prevents concurrent loads) */
-const loadingLocks = new Map();
 let transformersModule = null;
 /**
  * Lazily import @huggingface/transformers.
@@ -117,21 +114,12 @@ export async function getTransformers() {
     return mod;
 }
 /**
- * Load a text-generation pipeline for the given model.
- * Returns a cached pipeline if already loaded.
+ * Bounded, dedup-aware cache of text-generation pipelines keyed by HuggingFace
+ * model id. Only loads a model on a cold cache miss; concurrent loads of the
+ * same model share a single promise.
  */
-async function loadPipeline(modelInfo) {
-    const cacheKey = modelInfo.hfId;
-    // Return cached pipeline
-    const cached = pipelineCache.get(cacheKey);
-    if (cached)
-        return cached;
-    // Wait for existing load if in progress
-    const existingLock = loadingLocks.get(cacheKey);
-    if (existingLock)
-        return existingLock;
-    // Start loading
-    const loadPromise = (async () => {
+const textGenerationPipelines = createPipelineCache(async (modelInfo) => {
+    try {
         const transformers = await getTransformers();
         logger.info(`Loading local model: ${modelInfo.hfId} (${modelInfo.dtype}, ~${modelInfo.sizeMB}MB)...`);
         const pipe = (await transformers.pipeline("text-generation", modelInfo.hfId, {
@@ -139,16 +127,9 @@ async function loadPipeline(modelInfo) {
             device: "cpu",
         }));
         logger.info(`Model loaded: ${modelInfo.hfId}`);
-        pipelineCache.set(cacheKey, pipe);
-        loadingLocks.delete(cacheKey);
         return pipe;
-    })();
-    loadingLocks.set(cacheKey, loadPromise);
-    try {
-        return await loadPromise;
     }
     catch (error) {
-        loadingLocks.delete(cacheKey);
         // Convert ONNX / native-addon errors to no_ai_available so they propagate
         // correctly through the chat handler (503) instead of being swallowed as
         // in-band SSE errors inside a 200 response stream.
@@ -166,6 +147,13 @@ async function loadPipeline(modelInfo) {
         }
         throw error;
     }
+});
+/**
+ * Load a text-generation pipeline for the given model.
+ * Returns a cached pipeline if already loaded.
+ */
+function loadPipeline(modelInfo) {
+    return textGenerationPipelines.load(modelInfo.hfId, modelInfo);
 }
 /**
  * Eagerly verify that the local AI runtime (@huggingface/transformers + ONNX)
@@ -262,5 +250,5 @@ export async function preloadModel(modelId) {
  */
 export function isModelLoaded(modelId) {
     const modelInfo = resolveLocalModel(modelId);
-    return pipelineCache.has(modelInfo.hfId);
+    return textGenerationPipelines.has(modelInfo.hfId);
 }

package/esm/src/provider/local/pipeline-cache.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared pipeline cache for local Transformers.js engines.
+ *
+ * Both the text-generation engine (`local-engine.ts`) and the embedding engine
+ * (`local-embedding-engine.ts`) need to lazily load a pipeline per HuggingFace
+ * model id, cache it, and deduplicate concurrent loads of the same model. This
+ * helper captures that shared behavior and bounds the cache with an LRU so a
+ * long-running process that touches many models cannot grow memory without
+ * limit (loaded models are large).
+ *
+ * @module provider/local
+ */
+/** A loaded pipeline cache with concurrency-safe, deduplicated loading. */
+export interface PipelineCache<P, M> {
+    /** Load (or return cached) pipeline for the given model id. */
+    load(cacheKey: string, modelInfo: M): Promise<P>;
+    /** Whether a pipeline for the given model id is currently loaded. */
+    has(cacheKey: string): boolean;
+}
+/**
+ * Create a bounded, dedup-aware pipeline cache.
+ *
+ * @param loadFn Loads the underlying pipeline for a model. Only invoked on a
+ *   cold cache miss; concurrent loads of the same key share a single promise.
+ */
+export declare function createPipelineCache<P, M>(loadFn: (modelInfo: M) => Promise<P>): PipelineCache<P, M>;
+//# sourceMappingURL=pipeline-cache.d.ts.map

package/esm/src/provider/local/pipeline-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/provider/local/pipeline-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,2EAA2E;AAC3E,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,CAAC;IACjC,+DAA+D;IAC/D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjD,qEAAqE;IACrE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EACtC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GACnC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAwCrB"}

package/esm/src/provider/local/pipeline-cache.js

@@ -0,0 +1,61 @@
+/**
+ * Shared pipeline cache for local Transformers.js engines.
+ *
+ * Both the text-generation engine (`local-engine.ts`) and the embedding engine
+ * (`local-embedding-engine.ts`) need to lazily load a pipeline per HuggingFace
+ * model id, cache it, and deduplicate concurrent loads of the same model. This
+ * helper captures that shared behavior and bounds the cache with an LRU so a
+ * long-running process that touches many models cannot grow memory without
+ * limit (loaded models are large).
+ *
+ * @module provider/local
+ */
+import { LRUCache } from "../../utils/lru-wrapper.js";
+/**
+ * Maximum number of loaded pipelines kept in memory at once. Loaded models are
+ * large (hundreds of MB each), so the cap is intentionally small.
+ */
+const PIPELINE_CACHE_MAX_ENTRIES = 4;
+/**
+ * Create a bounded, dedup-aware pipeline cache.
+ *
+ * @param loadFn Loads the underlying pipeline for a model. Only invoked on a
+ *   cold cache miss; concurrent loads of the same key share a single promise.
+ */
+export function createPipelineCache(loadFn) {
+    const pipelineCache = new LRUCache({
+        maxEntries: PIPELINE_CACHE_MAX_ENTRIES,
+    });
+    // Whether a model is currently being loaded (prevents concurrent loads).
+    const loadingLocks = new Map();
+    return {
+        async load(cacheKey, modelInfo) {
+            // Return cached pipeline.
+            const cached = pipelineCache.get(cacheKey);
+            if (cached)
+                return cached;
+            // Wait for existing load if in progress.
+            const existingLock = loadingLocks.get(cacheKey);
+            if (existingLock)
+                return existingLock;
+            // Start loading.
+            const loadPromise = (async () => {
+                const pipe = await loadFn(modelInfo);
+                pipelineCache.set(cacheKey, pipe);
+                loadingLocks.delete(cacheKey);
+                return pipe;
+            })();
+            loadingLocks.set(cacheKey, loadPromise);
+            try {
+                return await loadPromise;
+            }
+            catch (error) {
+                loadingLocks.delete(cacheKey);
+                throw error;
+            }
+        },
+        has(cacheKey) {
+            return pipelineCache.has(cacheKey);
+        },
+    };
+}

package/esm/src/server/handlers/dev/framework-candidates.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-candidates.generated.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/framework-candidates.generated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAg/KjD,CAAC"}
+{"version":3,"file":"framework-candidates.generated.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/framework-candidates.generated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAi/KjD,CAAC"}

package/esm/src/server/handlers/dev/framework-candidates.generated.js

@@ -5516,6 +5516,7 @@ export const FRAMEWORK_CANDIDATES = [
     "veryfront/chat",
     "veryfront/errors/error-registry.ts",
     "veryfront/platform/compat/runtime.ts",
+    "veryfront/react/primitives/index.ts",
     "veryfront/schemas/_test-setup.ts",
     "veryfront/security/client/html-sanitizer.ts",
     "veryfront/testing/assert",

package/esm/src/server/handlers/request/internal-agents-list.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-agents-list.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/request/internal-agents-list.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAKL,KAAK,yBAAyB,EAC/B,MAAM,oCAAoC,CAAC;AAa5C,qBAAa,yBAA0B,SAAQ,WAAW;IAS5C,OAAO,CAAC,QAAQ,CAAC,IAAI;IARjC,QAAQ,EAAE,eAAe,CAMvB;gBAE2B,IAAI,GAAE,yBAAoD;IAIjF,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAkExE"}
+{"version":3,"file":"internal-agents-list.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/request/internal-agents-list.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAML,KAAK,yBAAyB,EAC/B,MAAM,oCAAoC,CAAC;AAa5C,qBAAa,yBAA0B,SAAQ,WAAW;IAS5C,OAAO,CAAC,QAAQ,CAAC,IAAI;IARjC,QAAQ,EAAE,eAAe,CAMvB;gBAE2B,IAAI,GAAE,yBAAoD;IAIjF,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAmExE"}

package/esm/src/server/handlers/request/internal-agents-list.handler.js

@@ -30,6 +30,7 @@ export class InternalAgentsListHandler extends BaseHandler {
                 const payload = ControlPlaneAgentsListRequestSchema.parse(JSON.parse(rawBody));
                 const claims = await verifyControlPlaneRequest(req, ctx, rawBody, {
                     expectedSubject: payload.requestId,
+                    // Validated by `.parse()` above; narrow back to the union (object inference widens it to `string`).
                     expectedSurface: payload.surface,
                 });
                 if (payload.projectId !== claims.project_id ||

package/esm/src/server/handlers/request/project-run-execute.handler.d.ts

@@ -0,0 +1,74 @@
+import type { RuntimeAdapter } from "../../../platform/index.js";
+import type { VeryfrontConfig } from "../../../config/index.js";
+import { type DiscoveredTask } from "../../../task/discovery.js";
+import { type RunTaskOptions, type TaskRunResult } from "../../../task/runner.js";
+import { type DiscoveredWorkflow } from "../../../workflow/discovery/index.js";
+import type { HandlerContext, HandlerMetadata, HandlerResult } from "../types.js";
+import { BaseHandler } from "../response/base.js";
+export interface ProjectRunExecuteRequest {
+    runId: string;
+    kind: "task" | "workflow";
+    target: string;
+    projectId: string;
+    config?: Record<string, unknown>;
+    input?: Record<string, unknown>;
+}
+export interface ProjectRunExecuteResponse {
+    success: boolean;
+    result?: unknown;
+    logs?: string | null;
+    error?: string | null;
+    duration_ms?: number;
+    artifacts?: unknown[];
+}
+interface WorkflowRunView {
+    status: string;
+    output?: unknown;
+    error?: {
+        message?: string;
+    } | null;
+}
+interface WorkflowClientView {
+    readonly statePersistence?: "durable" | "ephemeral";
+    register(workflow: unknown): void;
+    start(workflowId: string, input: unknown, options?: {
+        runId?: string;
+    }): Promise<{
+        runId: string;
+    }>;
+    getRun(runId: string): Promise<WorkflowRunView | null>;
+    destroy(): Promise<void>;
+}
+export interface ProjectRunExecuteHandlerDeps {
+    findTaskById(taskId: string, options: {
+        projectDir: string;
+        adapter: RuntimeAdapter;
+        config?: VeryfrontConfig;
+        debug?: boolean;
+    }): Promise<DiscoveredTask | null>;
+    runTask(options: RunTaskOptions): Promise<TaskRunResult>;
+    findWorkflowById(workflowId: string, options: {
+        projectDir: string;
+        adapter: RuntimeAdapter;
+        config?: VeryfrontConfig;
+        debug?: boolean;
+    }): Promise<DiscoveredWorkflow | null>;
+    createWorkflowClient(config?: {
+        debug?: boolean;
+    }): WorkflowClientView | Promise<WorkflowClientView>;
+    executeKnowledgeIngest(input: {
+        request: ProjectRunExecuteRequest;
+        ctx: HandlerContext;
+        req: Request;
+    }): Promise<ProjectRunExecuteResponse>;
+    sleep(ms: number): Promise<void>;
+    now(): number;
+}
+export declare class ProjectRunExecuteHandler extends BaseHandler {
+    private readonly deps;
+    metadata: HandlerMetadata;
+    constructor(deps?: ProjectRunExecuteHandlerDeps);
+    handle(req: Request, ctx: HandlerContext): Promise<HandlerResult>;
+}
+export {};
+//# sourceMappingURL=project-run-execute.handler.d.ts.map

package/esm/src/server/handlers/request/project-run-execute.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-run-execute.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/request/project-run-execute.handler.ts"],"names":[],"mappings":"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"}