veryfront 0.1.809 → 0.1.811

package/esm/src/rendering/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/src/rendering/renderer.ts"],"names":[],"mappings":"AA6CA,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AAgBzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAwBxD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,oBAAoB;IACpB,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC;AAeD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,oBAAoB,CAAgC;IAC5D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAA8B;IAE3D;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAwC;gBAEhD,OAAO,GAAE,eAAoB;IAInC,UAAU,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YAwF9E,2BAA2B;IAWzC,OAAO,CAAC,uBAAuB;IAiB/B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;YAwBP,YAAY;IAoF1B,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,gBAAgB,CAAC;IAkB5B,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAU5C,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5D,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,OAAO,CAAC,wBAAwB;CA0FjC;AAED,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,aAAa,GACnB,CAAC;AAMF,wBAAgB,WAAW,IAAI,QAAQ,CAOtC;AAED,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsBrF;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAQrD;AAED,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYnF;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,cAAc,EAC1B,OAAO,CAAC,EAAE,aAAa,EACvB,cAAc,CAAC,EAAE,0BAA0B,GAC1C,OAAO,CAAC,YAAY,CAAC,CAIvB"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/src/rendering/renderer.ts"],"names":[],"mappings":"AA6CA,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AAgBzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAwBxD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,oBAAoB;IACpB,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC;AAeD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,oBAAoB,CAAgC;IAC5D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAA8B;IAE3D;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAwC;gBAEhD,OAAO,GAAE,eAAoB;IAInC,UAAU,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YAwF9E,2BAA2B;IAWzC,OAAO,CAAC,uBAAuB;IAiB/B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;YAwBP,YAAY;IAoF1B,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,gBAAgB,CAAC;IAkB5B,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAU5C,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5D,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,OAAO,CAAC,wBAAwB;CA4FjC;AAED,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,aAAa,GACnB,CAAC;AAMF,wBAAgB,WAAW,IAAI,QAAQ,CAOtC;AAED,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsBrF;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAQrD;AAED,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYnF;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,cAAc,EAC1B,OAAO,CAAC,EAAE,aAAa,EACvB,cAAc,CAAC,EAAE,0BAA0B,GAC1C,OAAO,CAAC,YAAY,CAAC,CAIvB"}

package/esm/src/rendering/renderer.js

@@ -130,7 +130,7 @@ export class Renderer {
             const cacheKey = this.buildCacheKey(slug, effectiveCtx, effectiveOptions);
             const cacheResult = cacheKey
                 ? await this.cache.checkCache(slug, effectiveCtx, effectiveOptions?.colorScheme, cacheKey)
-                : { hit: false, cacheKey: "" };
+                : { hit: false, cacheKey: "", status: "miss", lookupDurationMs: 0 };
             if (cacheResult.hit && cacheResult.cachedResult) {
                 logger.debug("Cache hit", {
                     slug,
@@ -398,6 +398,8 @@ export class Renderer {
                     depAwareSlug: slug,
                     moduleCacheKey: cacheKey ?? slug,
                     cachedModule: result.cachedResult?.pageModule,
+                    cacheStatus: result.status,
+                    lookupDurationMs: result.lookupDurationMs,
                 };
             },
             persistResult: async (result, slug, cacheKey) => {

package/esm/src/rendering/shared/context-aware-cache.d.ts

@@ -1,5 +1,6 @@
 import type { RenderResult } from "../orchestrator/types.js";
 import type { CacheStore } from "../cache/types.js";
+import type { CacheLookupStatus } from "../cache/cache-coordinator.js";
 import { type MemoryCacheStoreOptions } from "../cache/stores/index.js";
 import type { RenderContext } from "../context/render-context.js";
 export interface ContextAwareCacheOptions {
@@ -11,6 +12,8 @@ export interface ContextAwareCacheLookupResult {
     cachedResult?: RenderResult;
     cacheKey: string;
     hit: boolean;
+    status: CacheLookupStatus;
+    lookupDurationMs: number;
 }
 export declare class ContextAwareCacheCoordinator {
     private store;

package/esm/src/rendering/shared/context-aware-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-aware-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/shared/context-aware-cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAUlE,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD,MAAM,WAAW,6BAA6B;IAC5C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,qBAAa,4BAA4B;IACvC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;gBAEzC,OAAO,GAAE,wBAA6B;IASlD,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,6BAA6B,CAAC;IAqDnC,aAAa,CACjB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC;IAqBV,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BlD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAO5B,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;CAkCpB"}
+{"version":3,"file":"context-aware-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/shared/context-aware-cache.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAUlE,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD,MAAM,WAAW,6BAA6B;IAC5C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,4BAA4B;IACvC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;gBAEzC,OAAO,GAAE,wBAA6B;IASlD,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,6BAA6B,CAAC;IAiEnC,aAAa,CACjB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC;IAqBV,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BlD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAO5B,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;CAkCpB"}

package/esm/src/rendering/shared/context-aware-cache.js

@@ -1,4 +1,6 @@
 import { rendererLogger } from "../../utils/index.js";
+import { markRequestProfilePhase } from "../../observability/request-profiler.js";
+import { metrics } from "../../observability/simple-metrics/index.js";
 import { withSpan } from "../../observability/tracing/otlp-setup.js";
 import { SpanNames } from "../../observability/tracing/span-names.js";
 import { MemoryCacheStore } from "../cache/stores/index.js";
@@ -23,35 +25,47 @@ export class ContextAwareCacheCoordinator {
     checkCache(slug, ctx, colorScheme, cacheKeyOverride) {
         const cacheKey = this.getCacheKey(slug, ctx, colorScheme, cacheKeyOverride);
         return withSpan(SpanNames.CACHE_CHECK_SPECULATIVE, async () => {
+            const lookupStart = performance.now();
             const cached = (await this.store.get(cacheKey));
             if (!cached) {
+                const lookupDurationMs = roundDurationMs(performance.now() - lookupStart);
+                recordCacheLookup("miss", lookupDurationMs);
                 logger.debug("Cache miss", {
                     slug,
                     cacheKey,
                     projectId: ctx.projectId,
                     environment: ctx.environment,
+                    lookupDurationMs,
                 });
-                return { cacheKey, hit: false };
+                return { cacheKey, hit: false, status: "miss", lookupDurationMs };
             }
             if (this.isExpired(cached)) {
                 await this.store.delete(cacheKey);
+                const lookupDurationMs = roundDurationMs(performance.now() - lookupStart);
+                recordCacheLookup("expired", lookupDurationMs);
                 logger.debug("Cache expired", {
                     slug,
                     cacheKey,
                     projectId: ctx.projectId,
                     environment: ctx.environment,
+                    lookupDurationMs,
                 });
-                return { cacheKey, hit: false };
+                return { cacheKey, hit: false, status: "expired", lookupDurationMs };
             }
+            const lookupDurationMs = roundDurationMs(performance.now() - lookupStart);
+            recordCacheLookup("hit", lookupDurationMs);
             logger.debug("Cache hit", {
                 slug,
                 projectId: ctx.projectId,
                 environment: ctx.environment,
+                lookupDurationMs,
             });
             return {
                 cachedResult: this.cloneResult(cached.result, cached.nodeMapEntries),
                 cacheKey,
                 hit: true,
+                status: "hit",
+                lookupDurationMs,
             };
         }, {
             "cache.key": cacheKey,
@@ -195,3 +209,11 @@ export class ContextAwareCacheCoordinator {
         return cloned;
     }
 }
+function roundDurationMs(value) {
+    return Math.round(value * 100) / 100;
+}
+function recordCacheLookup(status, durationMs) {
+    markRequestProfilePhase("render.cache_lookup", durationMs);
+    markRequestProfilePhase(`render.cache_${status}`);
+    metrics.recordCacheGet(status === "hit");
+}

package/esm/src/server/build-app-route-renderer.d.ts

@@ -2,6 +2,7 @@
  * App Route HTML Rendering for Build
  */
 import type { RuntimeAdapter } from "../platform/adapters/base.js";
+import type { ReleaseAssetManifest } from "../release-assets/manifest-schema.js";
 /**
  * Render an App Router route to HTML
  */
@@ -12,6 +13,7 @@ export declare function renderAppRouteToHTML(args: {
     pageFile: string;
     contentSourceId: string;
     reactVersion?: string;
+    releaseAssetManifest?: ReleaseAssetManifest | null;
     stylesheetHref?: string;
     includePreviewStylesheet?: boolean;
 }): Promise<string>;

package/esm/src/server/build-app-route-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-app-route-renderer.d.ts","sourceRoot":"","sources":["../../../src/src/server/build-app-route-renderer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAiEnE;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GAAG,OAAO,CAAC,MAAM,CAAC,CAgHlB"}
+{"version":3,"file":"build-app-route-renderer.d.ts","sourceRoot":"","sources":["../../../src/src/server/build-app-route-renderer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AA4DjF;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GAAG,OAAO,CAAC,MAAM,CAAC,CAkHlB"}

package/esm/src/server/build-app-route-renderer.js

@@ -50,7 +50,7 @@ function getLayoutsForRoute(appRoot, routePath) {
  * Render an App Router route to HTML
  */
 export async function renderAppRouteToHTML(args) {
-    const { adapter, projectDir, routePath, pageFile, contentSourceId, stylesheetHref, includePreviewStylesheet, } = args;
+    const { adapter, projectDir, routePath, pageFile, contentSourceId, releaseAssetManifest, stylesheetHref, includePreviewStylesheet, } = args;
     const appRoot = join(projectDir, "app");
     const layoutCandidates = getLayoutsForRoute(appRoot, routePath);
     const layouts = [];
@@ -94,7 +94,7 @@ export async function renderAppRouteToHTML(args) {
     const htmlInner = await renderToStringAdapter(element);
     const title = "Veryfront App";
     const slug = routePathToSlug(routePath);
-    const importMapJson = await buildImportMapJson({ projectDir });
+    const importMapJson = await buildImportMapJson({ projectDir, releaseAssetManifest });
     const hydrationData = hasUseClientDirective(pageSource)
         ? generateHydrationData(slug, {}, {}, {
             mode: "production",
@@ -102,6 +102,7 @@ export async function renderAppRouteToHTML(args) {
             projectDir,
             pagePath: pageFile,
             pageType: "tsx",
+            releaseAssetManifest,
             isLocalProject: false,
             forceProductionScripts: true,
             nestedLayouts: layouts.map((layoutPath) => ({ kind: "tsx", path: layoutPath })),

package/esm/src/server/dev-server/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/src/server/dev-server/server.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAmCvD,4BAA4B;AAC5B,qBAAa,SAAS;IAiBR,OAAO,CAAC,OAAO;IAhB3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,CAAsC;IACvD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,qBAAqB,CAAC,CAAa;IAC3C,OAAO,CAAC,8BAA8B,CAAC,CAAa;gBAEhC,OAAO,EAAE,gBAAgB;IAQ7C,OAAO,CAAC,OAAO;YAID,YAAY;IAWpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgL5B,qEAAqE;IACrE,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAKjD;IAED,OAAO,CAAC,oBAAoB;YAkBd,qBAAqB;YAkBrB,yBAAyB;YAoBzB,uBAAuB;YA4BvB,wBAAwB;IAmBtC,OAAO,CAAC,kBAAkB;IAuBpB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;YAe7B,iBAAiB;IAsC/B,qBAAqB,IAAI,UAAU,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI;IAIlE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA6B5B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/src/server/dev-server/server.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAmCvD,4BAA4B;AAC5B,qBAAa,SAAS;IAiBR,OAAO,CAAC,OAAO;IAhB3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,CAAsC;IACvD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,qBAAqB,CAAC,CAAa;IAC3C,OAAO,CAAC,8BAA8B,CAAC,CAAa;gBAEhC,OAAO,EAAE,gBAAgB;IAQ7C,OAAO,CAAC,OAAO;YAID,YAAY;IAWpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgL5B,qEAAqE;IACrE,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAKjD;IAED,OAAO,CAAC,oBAAoB;YAmBd,qBAAqB;YAoBrB,yBAAyB;YAoBzB,uBAAuB;YA4BvB,wBAAwB;IAmBtC,OAAO,CAAC,kBAAkB;IAuBpB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;YAe7B,iBAAiB;IAsC/B,qBAAqB,IAAI,UAAU,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI;IAIlE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA6B5B"}

package/esm/src/server/dev-server/server.js

@@ -227,6 +227,7 @@ export class DevServer {
             resourceDirs: ["resources"],
             promptDirs: ["prompts"],
             workflowDirs: ["workflows"],
+            workDirs: ["work"],
             fsAdapter: this.adapter.fs,
             verbose: this.isDebug(),
         };
@@ -236,10 +237,12 @@ export class DevServer {
             const config = this.buildDiscoveryConfig();
             const result = await discoverAll(config);
             const total = result.tools.size + result.agents.size + result.skills.size +
-                result.workflows.size + result.prompts.size + result.resources.size;
+                result.workflows.size + result.works.size + result.prompts.size +
+                result.resources.size;
             if (total > 0) {
                 logger.debug(`[Discovery] Registered ${result.tools.size} tools, ${result.agents.size} agents, ` +
                     `${result.skills.size} skills, ${result.workflows.size} workflows, ` +
+                    `${result.works.size} Work definitions, ` +
                     `${result.prompts.size} prompts, ${result.resources.size} resources`);
             }
         }

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

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.809";
+export declare const VERSION = "0.1.811";
 //# sourceMappingURL=version-constant.d.ts.map

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

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.809";
+export const VERSION = "0.1.811";

package/esm/src/work/factory.d.ts

@@ -0,0 +1,4 @@
+import type { WorkConfig, WorkDefinition } from "./types.js";
+/** Create a typed Work definition. */
+export declare function work(config: WorkConfig): WorkDefinition;
+//# sourceMappingURL=factory.d.ts.map

package/esm/src/work/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/src/work/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGtF,sCAAsC;AACtC,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CA0CvD"}

package/esm/src/work/factory.js

@@ -0,0 +1,51 @@
+import { createError, toError } from "../errors/veryfront-error.js";
+/** Create a typed Work definition. */
+export function work(config) {
+    const id = assertWorkId(config.id);
+    const outcome = assertNonEmptyString(config.outcome, `Work "${id}" outcome`);
+    if (!Array.isArray(config.acceptanceCriteria) || config.acceptanceCriteria.length === 0) {
+        throwWorkConfigError(`Work "${id}" must define at least one acceptance criterion.`);
+    }
+    const seenCriterionIds = new Set();
+    const acceptanceCriteria = config.acceptanceCriteria.map((criterion, index) => {
+        const criterionId = assertNonEmptyString(criterion.id, `Work "${id}" acceptance criterion at index ${index} id`);
+        if (seenCriterionIds.has(criterionId)) {
+            throwWorkConfigError(`Work "${id}" has duplicate acceptance criterion id "${criterionId}".`);
+        }
+        seenCriterionIds.add(criterionId);
+        const description = assertNonEmptyString(criterion.description, `Work "${id}" acceptance criterion "${criterionId}" description`);
+        const normalizedCriterion = {
+            id: criterionId,
+            description,
+        };
+        if (criterion.optional === true) {
+            normalizedCriterion.optional = true;
+        }
+        return normalizedCriterion;
+    });
+    return {
+        id,
+        name: config.name?.trim() || id,
+        outcome,
+        acceptanceCriteria,
+    };
+}
+function assertWorkId(value) {
+    const id = assertNonEmptyString(value, "Work id");
+    if (!/^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(id)) {
+        throwWorkConfigError("Work id must be a path-safe single segment using letters, numbers, underscores, or hyphens.");
+    }
+    return id;
+}
+function assertNonEmptyString(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throwWorkConfigError(`${label} cannot be empty.`);
+    }
+    return value.trim();
+}
+function throwWorkConfigError(message) {
+    throw toError(createError({
+        type: "agent",
+        message,
+    }));
+}

package/esm/src/work/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Declare source-backed Work definitions for business process observability.
+ *
+ * @module work
+ *
+ * @example
+ * ```ts
+ * import { work } from "veryfront/work";
+ *
+ * export default work({
+ *   id: "supplier-invoice-processing",
+ *   name: "Supplier invoice processing",
+ *   outcome: "Resolve all open supplier invoices.",
+ *   acceptanceCriteria: [
+ *     {
+ *       id: "invoices_discovered",
+ *       description: "Open supplier invoices have been discovered.",
+ *     },
+ *   ],
+ * });
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+export type { WorkAcceptanceCriterion, WorkConfig, WorkDefinition, WorkReference, } from "./types.js";
+export { work } from "./factory.js";
+export { workRegistry } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/work/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,yBAAyB,CAAC;AAGjC,YAAY,EACV,uBAAuB,EACvB,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/esm/src/work/index.js

@@ -0,0 +1,25 @@
+/**
+ * Declare source-backed Work definitions for business process observability.
+ *
+ * @module work
+ *
+ * @example
+ * ```ts
+ * import { work } from "veryfront/work";
+ *
+ * export default work({
+ *   id: "supplier-invoice-processing",
+ *   name: "Supplier invoice processing",
+ *   outcome: "Resolve all open supplier invoices.",
+ *   acceptanceCriteria: [
+ *     {
+ *       id: "invoices_discovered",
+ *       description: "Open supplier invoices have been discovered.",
+ *     },
+ *   ],
+ * });
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+export { work } from "./factory.js";
+export { workRegistry } from "./registry.js";

package/esm/src/work/prompt-augmentation.d.ts

@@ -0,0 +1,6 @@
+import type { WorkDefinition, WorkReference } from "./types.js";
+/** Resolve agent work references to concrete Work definitions. */
+export declare function resolveWorkReferences(references: WorkReference | WorkReference[]): WorkDefinition[];
+/** Build a concise system-prompt section describing assigned Work outcomes. */
+export declare function buildWorkManifestPrompt(works: Iterable<WorkDefinition>): string;
+//# sourceMappingURL=prompt-augmentation.d.ts.map

package/esm/src/work/prompt-augmentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-augmentation.d.ts","sourceRoot":"","sources":["../../../src/src/work/prompt-augmentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhE,kEAAkE;AAClE,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,aAAa,GAAG,aAAa,EAAE,GAC1C,cAAc,EAAE,CAGlB;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,MAAM,CAwB/E"}

package/esm/src/work/prompt-augmentation.js

@@ -0,0 +1,30 @@
+import { workRegistry } from "./registry.js";
+/** Resolve agent work references to concrete Work definitions. */
+export function resolveWorkReferences(references) {
+    const refs = Array.isArray(references) ? references : [references];
+    return refs.map((ref) => typeof ref === "string" ? workRegistry.getRequired(ref) : ref);
+}
+/** Build a concise system-prompt section describing assigned Work outcomes. */
+export function buildWorkManifestPrompt(works) {
+    const workDefinitions = Array.from(works);
+    if (workDefinitions.length === 0)
+        return "";
+    const sections = workDefinitions.map((definition) => {
+        const criteria = definition.acceptanceCriteria.map((criterion) => {
+            const optionalLabel = criterion.optional ? " (optional)" : "";
+            return `- ${criterion.id}${optionalLabel}: ${criterion.description}`;
+        }).join("\n");
+        return [
+            `### ${definition.name} (${definition.id})`,
+            `Outcome: ${definition.outcome}`,
+            "Acceptance criteria:",
+            criteria,
+        ].join("\n");
+    }).join("\n\n");
+    return [
+        "## Work",
+        "Work is business/process state: pursue the outcome, then use Work execution tools to record durable status and evidence. Work definitions do not prescribe fixed workflow control flow.",
+        "",
+        sections,
+    ].join("\n");
+}

package/esm/src/work/registry.d.ts

@@ -0,0 +1,10 @@
+import type { WorkDefinition } from "./types.js";
+import { ScopedRegistryFacade } from "../registry/scoped-registry-facade.js";
+declare class WorkRegistryClass extends ScopedRegistryFacade<WorkDefinition> {
+    getRequired(id: string): WorkDefinition;
+    list(): string[];
+}
+/** Shared Work registry value. */
+export declare const workRegistry: WorkRegistryClass;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/esm/src/work/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/src/work/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAa7E,cAAM,iBAAkB,SAAQ,oBAAoB,CAAC,cAAc,CAAC;IAClE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc;IAMvC,IAAI,IAAI,MAAM,EAAE;CAGjB;AAED,kCAAkC;AAClC,eAAO,MAAM,YAAY,mBAA6C,CAAC"}

package/esm/src/work/registry.js

@@ -0,0 +1,23 @@
+import { createError, toError } from "../errors/veryfront-error.js";
+import { ProjectScopedRegistryManager } from "../registry/project-scoped-registry-manager.js";
+import { ScopedRegistryFacade } from "../registry/scoped-registry-facade.js";
+const workRegistryManager = new ProjectScopedRegistryManager("work");
+function createMissingWorkError(id) {
+    return toError(createError({
+        type: "agent",
+        message: `Work "${id}" not found`,
+    }));
+}
+class WorkRegistryClass extends ScopedRegistryFacade {
+    getRequired(id) {
+        const registeredWork = this.get(id);
+        if (registeredWork)
+            return registeredWork;
+        throw createMissingWorkError(id);
+    }
+    list() {
+        return this.getAllIds();
+    }
+}
+/** Shared Work registry value. */
+export const workRegistry = new WorkRegistryClass(workRegistryManager);

package/esm/src/work/types.d.ts

@@ -0,0 +1,30 @@
+/** One measurable outcome condition for a Work definition. */
+export interface WorkAcceptanceCriterion {
+    /** Stable identifier used by execution state and cloud persistence. */
+    id: string;
+    /** Human-readable condition that must be satisfied unless optional. */
+    description: string;
+    /** Optional criteria do not block Work execution completion. */
+    optional?: true;
+}
+/** Configuration used by work(). */
+export interface WorkConfig {
+    /** Stable project-local Work identifier. */
+    id: string;
+    /** Human-readable display name. Defaults to the id when omitted. */
+    name?: string;
+    /** Business outcome the execution layer should make true. */
+    outcome: string;
+    /** Outcome criteria tracked as business process state. */
+    acceptanceCriteria: WorkAcceptanceCriterion[];
+}
+/** Public API contract for Work definitions. */
+export interface WorkDefinition {
+    id: string;
+    name: string;
+    outcome: string;
+    acceptanceCriteria: WorkAcceptanceCriterion[];
+}
+/** Agent-level reference to source-declared Work. */
+export type WorkReference = string | WorkDefinition;
+//# sourceMappingURL=types.d.ts.map

package/esm/src/work/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/work/types.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;CAC/C;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;CAC/C;AAED,qDAAqD;AACrD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,cAAc,CAAC"}

package/esm/src/work/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.809",
+  "version": "0.1.811",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -105,6 +105,10 @@
       "import": "./esm/src/workflow/discovery/index.js",
       "types": "./esm/src/workflow/discovery/index.d.ts"
     },
+    "./work": {
+      "import": "./esm/src/work/index.js",
+      "types": "./esm/src/work/index.d.ts"
+    },
     "./schemas": {
       "import": "./esm/src/schemas/index.js",
       "types": "./esm/src/schemas/index.d.ts"