veryfront 0.1.58 → 0.1.60

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.58",
+    "version": "0.1.60",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "exclude": [

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

@@ -26,6 +26,11 @@ export interface ChatHandlerOptions {
      */
     beforeStream?: ChatHandlerBeforeStream;
 }
+/** Options when passing an agent instance directly. */
+export interface ChatHandlerConfigWithAgent extends ChatHandlerOptions {
+    /** The agent instance to use (bypasses registry lookup). */
+    agent: import("./types.js").Agent;
+}
 /**
  * Create a POST handler for a chat API route.
  *
@@ -33,11 +38,20 @@ export interface ChatHandlerOptions {
  * - App Router: `app/api/chat/route.ts` — handler receives `(request, context)`
  * - Pages Router: `pages/api/chat.ts` — handler receives `(ctx)`
  *
+ * Accepts either:
+ * - `createChatHandler("agentId", options?)` — looks up agent by ID from the registry
+ * - `createChatHandler({ agent, ...options })` — uses the provided agent instance directly
+ *
  * @example
  * ```ts
- * import { createChatHandler } from "veryfront/agent";
+ * // By agent ID (requires auto-discovery registration)
  * export const POST = createChatHandler("assistant");
+ *
+ * // By agent instance (no registry needed)
+ * import { myAgent } from "../../agents/my-agent";
+ * export const POST = createChatHandler({ agent: myAgent, beforeStream: ... });
  * ```
  */
 export declare function createChatHandler(agentId: string, options?: ChatHandlerOptions): (requestOrCtx: unknown) => Promise<dntShim.Response>;
+export declare function createChatHandler(config: ChatHandlerConfigWithAgent, options?: ChatHandlerOptions): (requestOrCtx: unknown) => Promise<dntShim.Response>;
 //# sourceMappingURL=chat-handler.d.ts.map

package/esm/src/agent/chat-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-handler.d.ts","sourceRoot":"","sources":["../../../src/src/agent/chat-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAG/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA8K1C,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;IACzB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACnC,eAAe,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,KAAK,EAAE,8BAA8B,KAEnC,IAAI,GACJ,OAAO,CAAC,QAAQ,GAChB,6BAA6B,GAC7B,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,6BAA6B,CAAC,CAAC;AAiCrE,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,OAAO,CAAC,EACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,CAAC,CACD,OAAO,EAAE,OAAO,CAAC,OAAO,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE;;;OAGG;IACH,YAAY,CAAC,EAAE,uBAAuB,CAAC;CACxC;AAgDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,IAED,cAAc,OAAO,KAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CA+E7E"}
+{"version":3,"file":"chat-handler.d.ts","sourceRoot":"","sources":["../../../src/src/agent/chat-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAG/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA8K1C,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;IACzB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACnC,eAAe,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,KAAK,EAAE,8BAA8B,KAEnC,IAAI,GACJ,OAAO,CAAC,QAAQ,GAChB,6BAA6B,GAC7B,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,6BAA6B,CAAC,CAAC;AAiCrE,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,OAAO,CAAC,EACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,CAAC,CACD,OAAO,EAAE,OAAO,CAAC,OAAO,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE;;;OAGG;IACH,YAAY,CAAC,EAAE,uBAAuB,CAAC;CACxC;AAED,uDAAuD;AACvD,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE,4DAA4D;IAC5D,KAAK,EAAE,OAAO,YAAY,EAAE,KAAK,CAAC;CACnC;AAwDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,CAAC,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACxD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,0BAA0B,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,CAAC,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC"}

package/esm/src/agent/chat-handler.js

@@ -155,6 +155,11 @@ function applyBeforeStreamResult(baseMessages, result) {
         ...normalizeHookMessages(result.append, "append", idCounter),
     ];
 }
+function mergeChatHandlerConfig(config, options) {
+    if (!options)
+        return config;
+    return { ...options, ...config };
+}
 /**
  * Extract the raw Request from either a raw Request or a Pages Router APIContext.
  * Pages Router handlers receive `(ctx)` where `ctx.request` is the Request.
@@ -195,29 +200,26 @@ function extractRequest(requestOrCtx) {
         detail: "Invalid handler argument: expected Request or APIContext",
     });
 }
-/**
- * Create a POST handler for a chat API route.
- *
- * Works with both App Router and Pages Router:
- * - App Router: `app/api/chat/route.ts` — handler receives `(request, context)`
- * - Pages Router: `pages/api/chat.ts` — handler receives `(ctx)`
- *
- * @example
- * ```ts
- * import { createChatHandler } from "veryfront/agent";
- * export const POST = createChatHandler("assistant");
- * ```
- */
-export function createChatHandler(agentId, options) {
+export function createChatHandler(agentIdOrConfig, options) {
     return async function POST(requestOrCtx) {
         const request = extractRequest(requestOrCtx);
         let agent;
-        try {
-            agent = getAgent(agentId);
+        if (typeof agentIdOrConfig === "object" && agentIdOrConfig !== null && "agent" in agentIdOrConfig) {
+            // Object-based API: createChatHandler({ agent, beforeStream, ... })
+            const config = mergeChatHandlerConfig(agentIdOrConfig, options);
+            agent = config.agent;
+            options = config;
         }
-        catch (error) {
-            agentLogger.debug("getAgent lookup failed", { error });
-            return dntShim.Response.json({ error: "Agent not found" }, { status: 404 });
+        else {
+            // String-based API: createChatHandler("agentId", options?)
+            const agentId = agentIdOrConfig;
+            try {
+                agent = getAgent(agentId);
+            }
+            catch (error) {
+                agentLogger.debug("getAgent lookup failed", { error });
+                return dntShim.Response.json({ error: "Agent not found" }, { status: 404 });
+            }
         }
         if (!agent) {
             return dntShim.Response.json({ error: "Agent not found" }, { status: 404 });

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

@@ -84,6 +84,6 @@ export { getTextFromParts, getToolArguments, hasArgs, hasInput } from "./types.j
 export { BufferMemory, ConversationMemory, createMemory, createRedisMemory, type Memory, type MemoryPersistence, type MemoryStats, type RedisClient, RedisMemory, type RedisMemoryConfig, SummaryMemory, } from "./memory/index.js";
 export { agentAsTool, createWorkflow, getAgent, getAgentsAsTools, getAllAgentIds, registerAgent, type WorkflowConfig, type WorkflowResult, type WorkflowStep, } from "./composition/index.js";
 export { agent } from "./factory.js";
-export { type ChatHandlerBeforeStream, type ChatHandlerBeforeStreamContext, type ChatHandlerBeforeStreamResult, type ChatHandlerMessageInput, type ChatHandlerOptions, createChatHandler, } from "./chat-handler.js";
+export { type ChatHandlerBeforeStream, type ChatHandlerBeforeStreamContext, type ChatHandlerBeforeStreamResult, type ChatHandlerConfigWithAgent, type ChatHandlerMessageInput, type ChatHandlerOptions, createChatHandler, } from "./chat-handler.js";
 export { AgentRuntime } from "./runtime/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AACH,OAAO,yBAAyB,CAAC;AAGjC,YAAY,EACV,KAAK,EACL,WAAW,EACX,YAAY,EACZ,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,OAAO,IAAI,YAAY,EACvB,WAAW,EACX,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEnF,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,KAAK,MAAM,EACX,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,WAAW,EACX,KAAK,iBAAiB,EACtB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AACH,OAAO,yBAAyB,CAAC;AAGjC,YAAY,EACV,KAAK,EACL,WAAW,EACX,YAAY,EACZ,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,OAAO,IAAI,YAAY,EACvB,WAAW,EACX,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEnF,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,KAAK,MAAM,EACX,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,WAAW,EACX,KAAK,iBAAiB,EACtB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/esm/src/discovery/discovery-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery-engine.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/discovery-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EACV,eAAe,EAEf,eAAe,EAEhB,MAAM,YAAY,CAAC;AA6DpB;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CA0EnF"}
+{"version":3,"file":"discovery-engine.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/discovery-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EACV,eAAe,EAEf,eAAe,EAEhB,MAAM,YAAY,CAAC;AAqIpB;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CA0EnF"}

package/esm/src/discovery/discovery-engine.js

@@ -11,31 +11,80 @@ import { registerSkill, skillRegistry } from "../skill/registry.js";
 import { importModule } from "./transpiler.js";
 import { findTypeScriptFiles } from "./file-discovery.js";
 import { agentHandler, discoverSkills, promptHandler, resourceHandler, taskHandler, toolHandler, workflowHandler, } from "./handlers/index.js";
+import { filenameToId } from "./discovery-utils.js";
 import { join } from "../platform/compat/path/index.js";
 const logger = agentLogger.component("discovery");
+function isIndexModule(file) {
+    const normalized = file.replace("file://", "");
+    return /(?:^|\/)index\.(?:ts|tsx|js|jsx)$/.test(normalized);
+}
+function compareDiscoveryFiles(a, b) {
+    const aIsIndex = isIndexModule(a);
+    const bIsIndex = isIndexModule(b);
+    if (aIsIndex !== bIsIndex)
+        return aIsIndex ? 1 : -1;
+    return a.localeCompare(b);
+}
+function collectDiscoveryCandidates(module, handler) {
+    const defaultItem = module.default;
+    if (handler.validate(defaultItem)) {
+        return [{ exportName: "default", item: defaultItem }];
+    }
+    const candidates = [];
+    for (const [exportName, value] of Object.entries(module)) {
+        if (exportName === "default")
+            continue;
+        if (!handler.validate(value))
+            continue;
+        candidates.push({ exportName, item: value });
+    }
+    return candidates;
+}
+function getCandidateId(candidate, file, dir, handler, useExportNameFallback) {
+    const derivedId = handler.getId(candidate.item, file, dir);
+    if (!useExportNameFallback)
+        return derivedId;
+    const fileId = filenameToId(file);
+    if (derivedId !== fileId)
+        return derivedId;
+    return candidate.exportName;
+}
 /**
  * Discover items of a specific type in a directory
  */
 async function discoverItems(dir, result, context, handler, verbose) {
-    const files = await findTypeScriptFiles(dir, context);
+    const files = (await findTypeScriptFiles(dir, context)).sort(compareDiscoveryFiles);
+    const resultMap = handler.getResultMap(result);
     if (verbose) {
         logger.info(`Found ${files.length} ${handler.typeName} files in ${dir}`);
     }
     for (const file of files) {
         try {
             const module = await importModule(file, context);
-            const item = module.default;
-            if (!handler.validate(item)) {
+            const candidates = collectDiscoveryCandidates(module, handler);
+            if (candidates.length === 0) {
                 if (verbose) {
                     logger.warn(`${file} does not export a valid ${handler.typeName}`);
                 }
                 continue;
             }
-            const id = handler.getId(item, file, dir);
-            const registered = handler.register(id, item, file, dir);
-            handler.getResultMap(result).set(id, registered);
-            if (verbose) {
-                logger.info(`Registered ${handler.typeName}: ${id}`);
+            const useExportNameFallback = candidates.length > 1 || isIndexModule(file);
+            for (const candidate of candidates) {
+                const id = getCandidateId(candidate, file, dir, handler, useExportNameFallback);
+                if (resultMap.has(id)) {
+                    if (verbose) {
+                        logger.warn(`Duplicate ${handler.typeName} "${id}" in ${file}; keeping first`);
+                    }
+                    continue;
+                }
+                const registered = handler.register(id, candidate.item, file, dir);
+                resultMap.set(id, registered);
+                if (verbose) {
+                    const exportSuffix = candidate.exportName === "default"
+                        ? ""
+                        : ` (export: ${candidate.exportName})`;
+                    logger.info(`Registered ${handler.typeName}: ${id}${exportSuffix}`);
+                }
             }
         }
         catch (error) {

package/esm/src/modules/server/module-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-server.d.ts","sourceRoot":"","sources":["../../../../src/src/modules/server/module-server.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAIlD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAkBtE;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkDrD,CAAC;AASF,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,uBAAuB;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAqTzG;AAuND;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAG7D"}
+{"version":3,"file":"module-server.d.ts","sourceRoot":"","sources":["../../../../src/src/modules/server/module-server.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAIlD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAkBtE;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsDrD,CAAC;AASF,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,uBAAuB;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAqTzG;AAwND;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAG7D"}

package/esm/src/modules/server/module-server.js

@@ -3,7 +3,7 @@ import * as dntShim from "../../../_dnt.shims.js";
 import { join } from "../../platform/compat/path/index.js";
 import { createFileSystem } from "../../platform/compat/fs.js";
 import { transformToESM } from "../../transforms/esm-transform.js";
-import { serverLogger } from "../../utils/index.js";
+import { serverLogger, VERSION } from "../../utils/index.js";
 import { HTTP_NOT_FOUND, HTTP_OK, HTTP_SERVER_ERROR } from "../../utils/index.js";
 import { getContentTypeForPath } from "../../server/handlers/utils/content-types.js";
 import { createSecureFs } from "../../security/index.js";
@@ -76,6 +76,10 @@ export default {};
         `export default {};`,
     ].join("\n") + "\n",
     "_dnt.polyfills": `export default {};\n`,
+    // Deno import-map alias stub for browser/HTTP-served framework modules.
+    // Must be a JS module (not JSON) because esbuild strips `with { type: "json" }`
+    // at es2020 target, and browsers reject JSON MIME type without the assertion.
+    "_veryfront/_deno-config": `export default ${JSON.stringify({ version: VERSION })};\n`,
 };
 const DEV_MODULE_PREFIX = /^\/(?:_vf_modules|_veryfront\/modules)\//;
 const SNIPPET_MODULE_PREFIX = /^\/_vf_modules\/_snippets\/([a-f0-9]+)\.js/;
@@ -331,6 +335,7 @@ const EMBEDDED_SRC_DIR = join(FRAMEWORK_ROOT, "dist", "framework-src");
 async function findSourceFile(secureFs, projectDir, basePath) {
     // Extensions including .src for compiled binary embedded sources
     const extensions = [
+        ".json",
         ".tsx.src",
         ".ts.src",
         ".jsx.src",
@@ -347,7 +352,7 @@ async function findSourceFile(secureFs, projectDir, basePath) {
     logger.debug("findSourceFile called", { projectDir, basePath });
     const hasKnownExt = extensions.some((ext) => basePath.endsWith(ext));
     const rawBasePathWithoutExt = hasKnownExt
-        ? basePath.replace(/\.(tsx|ts|jsx|js|mdx|md)(\.src)?$/, "")
+        ? basePath.replace(/\.(json|tsx|ts|jsx|js|mdx|md)(\.src)?$/, "")
         : basePath;
     let basePathWithoutExt = rawBasePathWithoutExt.replace(/^\/+/, "");
     if (basePathWithoutExt.startsWith("_vf_modules/")) {
@@ -374,7 +379,7 @@ async function findSourceFile(secureFs, projectDir, basePath) {
             basePath: basePathWithoutExt,
         });
         return {
-            path: `embedded:${basePathWithoutExt}`,
+            path: `embedded:${basePath}`,
             isFrameworkFile: true,
             embeddedContent,
         };

package/esm/src/transforms/import-rewriter/strategies/veryfront-strategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"veryfront-strategy.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/import-rewriter/strategies/veryfront-strategy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAkBrB,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,QAAQ,OAAO;IAExB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IAQzD,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,GAAG,aAAa;CA2CvE;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}
+{"version":3,"file":"veryfront-strategy.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/import-rewriter/strategies/veryfront-strategy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAkBrB,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,QAAQ,OAAO;IAExB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IASzD,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,GAAG,aAAa;CAkDvE;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/esm/src/transforms/import-rewriter/strategies/veryfront-strategy.js

@@ -22,10 +22,17 @@ export class VeryfrontStrategy {
     matches(specifier, _ctx) {
         return (specifier.startsWith("#veryfront/") ||
             specifier.startsWith("veryfront/") ||
-            specifier === "veryfront");
+            specifier === "veryfront" ||
+            specifier === "#deno-config");
     }
     rewrite(info, ctx) {
         const specifier = info.specifier;
+        // Handle #deno-config — Deno import-map alias that doesn't exist in browsers.
+        // Rewrite to a JS module (not JSON) because esbuild strips `with { type: "json" }`
+        // at es2020 target and browsers reject JSON MIME without the assertion.
+        if (specifier === "#deno-config") {
+            return { specifier: "/_vf_modules/_veryfront/_deno-config.js" };
+        }
         // Handle #veryfront/* (internal framework imports)
         if (specifier.startsWith("#veryfront/")) {
             const path = specifier.slice("#veryfront/".length);

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

@@ -1,4 +1,4 @@
-export declare const VERSION: string;
+export declare const VERSION = "0.1.59";
 export declare const SERVER_START_TIME: number;
 export interface BuildVersion {
     framework: string;

package/esm/src/utils/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/src/utils/version.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO,EAAE,MAA6B,CAAC;AAEpD,eAAO,MAAM,iBAAiB,EAAE,MAAmB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAM1E"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/src/utils/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,WAAW,CAAC;AAEhC,eAAO,MAAM,iBAAiB,EAAE,MAAmB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAM1E"}

package/esm/src/utils/version.js

@@ -1,9 +1,6 @@
-import denoConfig from "../../deno.js";
-function getVersionFromDeno() {
-    return typeof denoConfig.version === "string" ? denoConfig.version : "0.0.0";
-}
-// Use deno.json version directly to avoid env access at module load
-export const VERSION = getVersionFromDeno();
+// Keep in sync with deno.json version.
+// scripts/release.ts updates this constant during releases.
+export const VERSION = "0.1.59";
 export const SERVER_START_TIME = Date.now();
 export function createBuildVersion(projectUpdatedAt) {
     return {

package/package.json

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

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.58",
+  "version": "0.1.60",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

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

@@ -245,6 +245,20 @@ export interface ChatHandlerOptions {
   beforeStream?: ChatHandlerBeforeStream;
 }
 
+/** Options when passing an agent instance directly. */
+export interface ChatHandlerConfigWithAgent extends ChatHandlerOptions {
+  /** The agent instance to use (bypasses registry lookup). */
+  agent: import("./types.js").Agent;
+}
+
+function mergeChatHandlerConfig(
+  config: ChatHandlerConfigWithAgent,
+  options?: ChatHandlerOptions,
+): ChatHandlerConfigWithAgent {
+  if (!options) return config;
+  return { ...options, ...config };
+}
+
 /**
  * Extract the raw Request from either a raw Request or a Pages Router APIContext.
  * Pages Router handlers receive `(ctx)` where `ctx.request` is the Request.
@@ -298,25 +312,55 @@ function extractRequest(requestOrCtx: unknown): dntShim.Request {
  * - App Router: `app/api/chat/route.ts` — handler receives `(request, context)`
  * - Pages Router: `pages/api/chat.ts` — handler receives `(ctx)`
  *
+ * Accepts either:
+ * - `createChatHandler("agentId", options?)` — looks up agent by ID from the registry
+ * - `createChatHandler({ agent, ...options })` — uses the provided agent instance directly
+ *
  * @example
  * ```ts
- * import { createChatHandler } from "veryfront/agent";
+ * // By agent ID (requires auto-discovery registration)
  * export const POST = createChatHandler("assistant");
+ *
+ * // By agent instance (no registry needed)
+ * import { myAgent } from "../../agents/my-agent";
+ * export const POST = createChatHandler({ agent: myAgent, beforeStream: ... });
  * ```
  */
 export function createChatHandler(
   agentId: string,
   options?: ChatHandlerOptions,
+): (requestOrCtx: unknown) => Promise<dntShim.Response>;
+export function createChatHandler(
+  config: ChatHandlerConfigWithAgent,
+  options?: ChatHandlerOptions,
+): (requestOrCtx: unknown) => Promise<dntShim.Response>;
+export function createChatHandler(
+  agentIdOrConfig: string | ChatHandlerConfigWithAgent,
+  options?: ChatHandlerOptions,
 ) {
   return async function POST(requestOrCtx: unknown): Promise<dntShim.Response> {
     const request = extractRequest(requestOrCtx);
+
     let agent: ReturnType<typeof getAgent> | undefined;
-    try {
-      agent = getAgent(agentId);
-    } catch (error) {
-      agentLogger.debug("getAgent lookup failed", { error });
-      return dntShim.Response.json({ error: "Agent not found" }, { status: 404 });
+
+    if (
+      typeof agentIdOrConfig === "object" && agentIdOrConfig !== null && "agent" in agentIdOrConfig
+    ) {
+      // Object-based API: createChatHandler({ agent, beforeStream, ... })
+      const config = mergeChatHandlerConfig(agentIdOrConfig, options);
+      agent = config.agent;
+      options = config;
+    } else {
+      // String-based API: createChatHandler("agentId", options?)
+      const agentId = agentIdOrConfig as string;
+      try {
+        agent = getAgent(agentId);
+      } catch (error) {
+        agentLogger.debug("getAgent lookup failed", { error });
+        return dntShim.Response.json({ error: "Agent not found" }, { status: 404 });
+      }
     }
+
     if (!agent) {
       return dntShim.Response.json({ error: "Agent not found" }, { status: 404 });
     }

package/src/src/agent/index.ts

@@ -137,6 +137,7 @@ export {
   type ChatHandlerBeforeStream,
   type ChatHandlerBeforeStreamContext,
   type ChatHandlerBeforeStreamResult,
+  type ChatHandlerConfigWithAgent,
   type ChatHandlerMessageInput,
   type ChatHandlerOptions,
   createChatHandler,

package/src/src/discovery/discovery-engine.ts

@@ -26,10 +26,62 @@ import {
   toolHandler,
   workflowHandler,
 } from "./handlers/index.js";
+import { filenameToId } from "./discovery-utils.js";
 import { join } from "../platform/compat/path/index.js";
 
 const logger = agentLogger.component("discovery");
 
+type DiscoveryCandidate<T> = {
+  exportName: string;
+  item: T;
+};
+
+function isIndexModule(file: string): boolean {
+  const normalized = file.replace("file://", "");
+  return /(?:^|\/)index\.(?:ts|tsx|js|jsx)$/.test(normalized);
+}
+
+function compareDiscoveryFiles(a: string, b: string): number {
+  const aIsIndex = isIndexModule(a);
+  const bIsIndex = isIndexModule(b);
+  if (aIsIndex !== bIsIndex) return aIsIndex ? 1 : -1;
+  return a.localeCompare(b);
+}
+
+function collectDiscoveryCandidates<T>(
+  module: unknown,
+  handler: DiscoveryHandler<T>,
+): DiscoveryCandidate<T>[] {
+  const defaultItem = (module as { default?: T }).default;
+  if (handler.validate(defaultItem)) {
+    return [{ exportName: "default", item: defaultItem }];
+  }
+
+  const candidates: DiscoveryCandidate<T>[] = [];
+  for (const [exportName, value] of Object.entries(module as Record<string, unknown>)) {
+    if (exportName === "default") continue;
+    if (!handler.validate(value)) continue;
+    candidates.push({ exportName, item: value });
+  }
+
+  return candidates;
+}
+
+function getCandidateId<T>(
+  candidate: DiscoveryCandidate<T>,
+  file: string,
+  dir: string,
+  handler: DiscoveryHandler<T>,
+  useExportNameFallback: boolean,
+): string {
+  const derivedId = handler.getId(candidate.item, file, dir);
+  if (!useExportNameFallback) return derivedId;
+
+  const fileId = filenameToId(file);
+  if (derivedId !== fileId) return derivedId;
+  return candidate.exportName;
+}
+
 /**
  * Discover items of a specific type in a directory
  */
@@ -40,7 +92,8 @@ async function discoverItems<T>(
   handler: DiscoveryHandler<T>,
   verbose?: boolean,
 ): Promise<void> {
-  const files = await findTypeScriptFiles(dir, context);
+  const files = (await findTypeScriptFiles(dir, context)).sort(compareDiscoveryFiles);
+  const resultMap = handler.getResultMap(result);
 
   if (verbose) {
     logger.info(`Found ${files.length} ${handler.typeName} files in ${dir}`);
@@ -49,21 +102,40 @@ async function discoverItems<T>(
   for (const file of files) {
     try {
       const module = await importModule(file, context);
-      const item = (module as { default?: T }).default;
-
-      if (!handler.validate(item)) {
+      const candidates = collectDiscoveryCandidates(module, handler);
+      if (candidates.length === 0) {
         if (verbose) {
           logger.warn(`${file} does not export a valid ${handler.typeName}`);
         }
         continue;
       }
 
-      const id = handler.getId(item, file, dir);
-      const registered = handler.register(id, item, file, dir);
-      handler.getResultMap(result).set(id, registered);
+      const useExportNameFallback = candidates.length > 1 || isIndexModule(file);
+      for (const candidate of candidates) {
+        const id = getCandidateId(
+          candidate,
+          file,
+          dir,
+          handler,
+          useExportNameFallback,
+        );
+
+        if (resultMap.has(id)) {
+          if (verbose) {
+            logger.warn(`Duplicate ${handler.typeName} "${id}" in ${file}; keeping first`);
+          }
+          continue;
+        }
 
-      if (verbose) {
-        logger.info(`Registered ${handler.typeName}: ${id}`);
+        const registered = handler.register(id, candidate.item, file, dir);
+        resultMap.set(id, registered);
+
+        if (verbose) {
+          const exportSuffix = candidate.exportName === "default"
+            ? ""
+            : ` (export: ${candidate.exportName})`;
+          logger.info(`Registered ${handler.typeName}: ${id}${exportSuffix}`);
+        }
       }
     } catch (error) {
       result.errors.push({ file, error: ensureError(error) });

package/src/src/modules/server/module-server.ts

@@ -6,7 +6,7 @@ import { join } from "../../platform/compat/path/index.js";
 import type { RuntimeAdapter } from "../../platform/adapters/base.js";
 import { createFileSystem } from "../../platform/compat/fs.js";
 import { type TransformOptions, transformToESM } from "../../transforms/esm-transform.js";
-import { serverLogger } from "../../utils/index.js";
+import { serverLogger, VERSION } from "../../utils/index.js";
 import { HTTP_NOT_FOUND, HTTP_OK, HTTP_SERVER_ERROR } from "../../utils/index.js";
 import { getContentTypeForPath } from "../../server/handlers/utils/content-types.js";
 import { createSecureFs } from "../../security/index.js";
@@ -81,6 +81,10 @@ export default {};
     `export default {};`,
   ].join("\n") + "\n",
   "_dnt.polyfills": `export default {};\n`,
+  // Deno import-map alias stub for browser/HTTP-served framework modules.
+  // Must be a JS module (not JSON) because esbuild strips `with { type: "json" }`
+  // at es2020 target, and browsers reject JSON MIME type without the assertion.
+  "_veryfront/_deno-config": `export default ${JSON.stringify({ version: VERSION })};\n`,
 };
 
 const DEV_MODULE_PREFIX = /^\/(?:_vf_modules|_veryfront\/modules)\//;
@@ -449,6 +453,7 @@ async function findSourceFile(
 ): Promise<FindSourceFileResult | null> {
   // Extensions including .src for compiled binary embedded sources
   const extensions = [
+    ".json",
     ".tsx.src",
     ".ts.src",
     ".jsx.src",
@@ -467,7 +472,7 @@ async function findSourceFile(
 
   const hasKnownExt = extensions.some((ext) => basePath.endsWith(ext));
   const rawBasePathWithoutExt = hasKnownExt
-    ? basePath.replace(/\.(tsx|ts|jsx|js|mdx|md)(\.src)?$/, "")
+    ? basePath.replace(/\.(json|tsx|ts|jsx|js|mdx|md)(\.src)?$/, "")
     : basePath;
   let basePathWithoutExt = rawBasePathWithoutExt.replace(/^\/+/, "");
   if (basePathWithoutExt.startsWith("_vf_modules/")) {
@@ -496,7 +501,7 @@ async function findSourceFile(
       basePath: basePathWithoutExt,
     });
     return {
-      path: `embedded:${basePathWithoutExt}`,
+      path: `embedded:${basePath}`,
       isFrameworkFile: true,
       embeddedContent,
     };

package/src/src/transforms/import-rewriter/strategies/veryfront-strategy.ts

@@ -36,13 +36,21 @@ export class VeryfrontStrategy implements ImportRewriteStrategy {
     return (
       specifier.startsWith("#veryfront/") ||
       specifier.startsWith("veryfront/") ||
-      specifier === "veryfront"
+      specifier === "veryfront" ||
+      specifier === "#deno-config"
     );
   }
 
   rewrite(info: ImportSpecifierInfo, ctx: RewriteContext): RewriteResult {
     const specifier = info.specifier;
 
+    // Handle #deno-config — Deno import-map alias that doesn't exist in browsers.
+    // Rewrite to a JS module (not JSON) because esbuild strips `with { type: "json" }`
+    // at es2020 target and browsers reject JSON MIME without the assertion.
+    if (specifier === "#deno-config") {
+      return { specifier: "/_vf_modules/_veryfront/_deno-config.js" };
+    }
+
     // Handle #veryfront/* (internal framework imports)
     if (specifier.startsWith("#veryfront/")) {
       const path = specifier.slice("#veryfront/".length);

package/src/src/utils/version.ts

@@ -1,11 +1,6 @@
-import denoConfig from "../../deno.js";
-
-function getVersionFromDeno(): string {
-  return typeof denoConfig.version === "string" ? denoConfig.version : "0.0.0";
-}
-
-// Use deno.json version directly to avoid env access at module load
-export const VERSION: string = getVersionFromDeno();
+// Keep in sync with deno.json version.
+// scripts/release.ts updates this constant during releases.
+export const VERSION = "0.1.59";
 
 export const SERVER_START_TIME: number = Date.now();