veryfront 0.1.511 → 0.1.512

package/esm/deno.js

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

package/esm/src/agent/runtime-agent-definition-files.d.ts

@@ -6,6 +6,10 @@ export declare const resolveRuntimeAgentDefinitionsDirInputSchema: z.ZodObject<{
     fileName: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ResolveRuntimeAgentDefinitionsDirInput = z.infer<typeof resolveRuntimeAgentDefinitionsDirInputSchema>;
+export declare const listRuntimeAgentMarkdownDefinitionIdsInputSchema: z.ZodObject<{
+    baseDir: z.ZodString;
+}, z.core.$strip>;
+export type ListRuntimeAgentMarkdownDefinitionIdsInput = z.infer<typeof listRuntimeAgentMarkdownDefinitionIdsInputSchema>;
 export declare const loadRuntimeAgentMarkdownDefinitionFromFileInputSchema: z.ZodObject<{
     agentsDir: z.ZodString;
     id: z.ZodString;
@@ -13,6 +17,7 @@ export declare const loadRuntimeAgentMarkdownDefinitionFromFileInputSchema: z.Zo
 }, z.core.$strip>;
 export type LoadRuntimeAgentMarkdownDefinitionFromFileInput = z.infer<typeof loadRuntimeAgentMarkdownDefinitionFromFileInputSchema>;
 export declare function resolveRuntimeAgentDefinitionsDir(input: ResolveRuntimeAgentDefinitionsDirInput): string;
+export declare function listRuntimeAgentMarkdownDefinitionIds(input: ListRuntimeAgentMarkdownDefinitionIdsInput): string[];
 export declare function resolveRuntimeAgentMarkdownDefinitionFilePath(input: LoadRuntimeAgentMarkdownDefinitionFromFileInput): string;
 export declare function loadRuntimeAgentMarkdownDefinitionFromFile(input: LoadRuntimeAgentMarkdownDefinitionFromFileInput): RuntimeAgentMarkdownDefinition;
 //# sourceMappingURL=runtime-agent-definition-files.d.ts.map

package/esm/src/agent/runtime-agent-definition-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-agent-definition-files.d.ts","sourceRoot":"","sources":["../../../src/src/agent/runtime-agent-definition-files.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,+BAA+B,CAAC;AAKvC,eAAO,MAAM,4CAA4C;;;;iBAIvD,CAAC;AAEH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAC1D,OAAO,4CAA4C,CACpD,CAAC;AAEF,eAAO,MAAM,qDAAqD;;;;iBAIhE,CAAC;AAEH,MAAM,MAAM,+CAA+C,GAAG,CAAC,CAAC,KAAK,CACnE,OAAO,qDAAqD,CAC7D,CAAC;AAaF,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,sCAAsC,GAC5C,MAAM,CAiBR;AAED,wBAAgB,6CAA6C,CAC3D,KAAK,EAAE,+CAA+C,GACrD,MAAM,CAOR;AAED,wBAAgB,0CAA0C,CACxD,KAAK,EAAE,+CAA+C,GACrD,8BAA8B,CAQhC"}
+{"version":3,"file":"runtime-agent-definition-files.d.ts","sourceRoot":"","sources":["../../../src/src/agent/runtime-agent-definition-files.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,+BAA+B,CAAC;AAKvC,eAAO,MAAM,4CAA4C;;;;iBAIvD,CAAC;AAEH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAC1D,OAAO,4CAA4C,CACpD,CAAC;AAEF,eAAO,MAAM,gDAAgD;;iBAE3D,CAAC;AAEH,MAAM,MAAM,0CAA0C,GAAG,CAAC,CAAC,KAAK,CAC9D,OAAO,gDAAgD,CACxD,CAAC;AAEF,eAAO,MAAM,qDAAqD;;;;iBAIhE,CAAC;AAEH,MAAM,MAAM,+CAA+C,GAAG,CAAC,CAAC,KAAK,CACnE,OAAO,qDAAqD,CAC7D,CAAC;AA0BF,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,sCAAsC,GAC5C,MAAM,CAWR;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,0CAA0C,GAChD,MAAM,EAAE,CAwBV;AAED,wBAAgB,6CAA6C,CAC3D,KAAK,EAAE,+CAA+C,GACrD,MAAM,CAOR;AAED,wBAAgB,0CAA0C,CACxD,KAAK,EAAE,+CAA+C,GACrD,8BAA8B,CAQhC"}

package/esm/src/agent/runtime-agent-definition-files.js

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { basename, resolve } from "node:path";
 import { z } from "zod";
 import { parseRuntimeAgentMarkdownDefinition, } from "./runtime-agent-definition.js";
@@ -9,6 +9,9 @@ export const resolveRuntimeAgentDefinitionsDirInputSchema = z.object({
     id: runtimeAgentDefinitionFileIdSchema,
     fileName: runtimeAgentDefinitionFileNameSchema.optional(),
 });
+export const listRuntimeAgentMarkdownDefinitionIdsInputSchema = z.object({
+    baseDir: z.string().min(1),
+});
 export const loadRuntimeAgentMarkdownDefinitionFromFileInputSchema = z.object({
     agentsDir: z.string().min(1),
     id: runtimeAgentDefinitionFileIdSchema,
@@ -20,23 +23,48 @@ function getRuntimeAgentDefinitionFileName(input) {
 function hasRuntimeAgentDefinitionFile(path, fileName) {
     return existsSync(resolve(path, fileName));
 }
-export function resolveRuntimeAgentDefinitionsDir(input) {
-    const parsedInput = resolveRuntimeAgentDefinitionsDirInputSchema.parse(input);
-    const fileName = getRuntimeAgentDefinitionFileName(parsedInput);
-    const firstCandidate = resolve(parsedInput.baseDir, "agents");
-    const sourceLayoutCandidate = resolve(parsedInput.baseDir, "../agents");
+function getRuntimeAgentDefinitionsDirCandidates(baseDir) {
+    const firstCandidate = resolve(baseDir, "agents");
+    const sourceLayoutCandidate = resolve(baseDir, "../agents");
     const candidates = [
         firstCandidate,
         sourceLayoutCandidate,
-        resolve(parsedInput.baseDir, "../../agents"),
-        resolve(parsedInput.baseDir, "../../../agents"),
+        resolve(baseDir, "../../agents"),
+        resolve(baseDir, "../../../agents"),
     ];
+    return [...new Set(candidates)];
+}
+export function resolveRuntimeAgentDefinitionsDir(input) {
+    const parsedInput = resolveRuntimeAgentDefinitionsDirInputSchema.parse(input);
+    const fileName = getRuntimeAgentDefinitionFileName(parsedInput);
+    const candidates = getRuntimeAgentDefinitionsDirCandidates(parsedInput.baseDir);
+    const sourceLayoutCandidate = resolve(parsedInput.baseDir, "../agents");
     const fallbackCandidate = basename(parsedInput.baseDir) === "src"
         ? sourceLayoutCandidate
-        : firstCandidate;
+        : resolve(parsedInput.baseDir, "agents");
     return candidates.find((candidate) => hasRuntimeAgentDefinitionFile(candidate, fileName)) ??
         fallbackCandidate;
 }
+export function listRuntimeAgentMarkdownDefinitionIds(input) {
+    const parsedInput = listRuntimeAgentMarkdownDefinitionIdsInputSchema.parse(input);
+    const ids = new Set();
+    for (const dir of getRuntimeAgentDefinitionsDirCandidates(parsedInput.baseDir)) {
+        if (!existsSync(dir)) {
+            continue;
+        }
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isFile()) {
+                continue;
+            }
+            const parseResult = runtimeAgentDefinitionFileNameSchema.safeParse(entry.name);
+            if (!parseResult.success) {
+                continue;
+            }
+            ids.add(parseResult.data.slice(0, -".md".length));
+        }
+    }
+    return [...ids].sort((left, right) => left.localeCompare(right));
+}
 export function resolveRuntimeAgentMarkdownDefinitionFilePath(input) {
     const parsedInput = loadRuntimeAgentMarkdownDefinitionFromFileInputSchema.parse(input);
     return resolve(parsedInput.agentsDir, getRuntimeAgentDefinitionFileName(parsedInput));

package/esm/src/agent/veryfront-cloud-agent-service.d.ts

@@ -18,7 +18,11 @@ export declare function veryfrontMcpServer(kind?: VeryfrontMcpServerKind): Agent
 type AgentServicePathOption = string | URL;
 export type NodeVeryfrontCloudAgentServiceOptions = {
     serviceName: string;
-    agentId: string;
+    /**
+     * Default agent served by requests that do not provide an agent id. When
+     * omitted, the service selects the only discovered code or markdown agent.
+     */
+    agentId?: string;
     /**
      * Project/discovery root. Defaults to the process cwd when neither baseDir
      * nor an entrypoint URL is provided.

package/esm/src/agent/veryfront-cloud-agent-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"veryfront-cloud-agent-service.d.ts","sourceRoot":"","sources":["../../../src/src/agent/veryfront-cloud-agent-service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AA+B3E,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,8BAA8B,CAAC;AAItC,OAAO,EAAE,KAAK,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACzF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AAC7F,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAkB9E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAYxF,OAAO,EAEL,KAAK,kDAAkD,EACxD,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAK9B,KAAK,2BAA2B,EACjC,MAAM,4BAA4B,CAAC;AAIpC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAevF,MAAM,MAAM,2CAA2C,GACnD,WAAW,CAAC,0BAA0B,CAAC,eAAe,CAAC,CAAC,GACxD,WAAW,CAAC,kDAAkD,CAAC,eAAe,CAAC,CAAC,GAChF;IACA,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,GAAG,IAAI,CAAC;CACvC,CAAC;AAEJ,MAAM,MAAM,yCAAyC,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAErF,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEtD,MAAM,MAAM,uCAAuC,GAAG,2BAA2B,CAAC;AAElF,wBAAgB,kBAAkB,CAChC,IAAI,GAAE,sBAA8B,GACnC,2BAA2B,CAM7B;AAED,KAAK,sBAAsB,GAAG,MAAM,GAAG,GAAG,CAAC;AAE3C,MAAM,MAAM,qCAAqC,GAAG;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,WAAW,CAAC,EAAE,yCAAyC,CAAC;IACxD;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,uCAAuC,EAAE,CAAC;IAChE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,cAAc,CAAC,EAAE,+BAA+B,CAAC,gBAAgB,CAAC,CAAC;IACnE,GAAG,CAAC,EAAE,kDAAkD,CAAC,KAAK,CAAC,CAAC;IAChE,aAAa,CAAC,EAAE,2CAA2C,CAAC;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG,qCAAqC,CAAC;AAQtF,MAAM,MAAM,+CAA+C,GAAG,2BAA2B,GAAG;IAC1F,MAAM,EAAE,yBAAyB,CAAC;IAClC,KAAK,EAAE,+BAA+B,CAAC,OAAO,CAAC,CAAC;IAChD,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;IAClD,cAAc,EAAE,gCAAgC,CAAC;CAClD,CAAC;AAunBF,wBAAsB,2CAA2C,CAC/D,OAAO,EAAE,qCAAqC,GAC7C,OAAO,CAAC,yBAAyB,CAAC,+CAA+C,CAAC,CAAC,CAKrF;AAED,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,qCAAqC,GAC7C,OAAO,CAAC,2BAA2B,CAAC,+CAA+C,CAAC,CAAC,CAQvF;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qCAAqC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAyCf"}
+{"version":3,"file":"veryfront-cloud-agent-service.d.ts","sourceRoot":"","sources":["../../../src/src/agent/veryfront-cloud-agent-service.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/veryfront-cloud-agent-service.js

@@ -14,12 +14,12 @@ import { buildAgentRunTraceAttributes, buildExecuteToolTraceAttributes, filterAg
 import { runAgentServiceMain, } from "./agent-service-bootstrap.js";
 import { loadAgentServiceEnvFiles } from "./agent-service-env-files.js";
 import { createHostedFormInputTool } from "./hosted-form-input-tool.js";
-import { createHostedAgentProjectSteering } from "./hosted-agent-project-steering.js";
+import { createHostedAgentProjectSteering, } from "./hosted-agent-project-steering.js";
 import { createLiveStudioMcpTools } from "./live-studio-mcp-tools.js";
 import { createDefaultHostedChatRuntime, } from "./default-hosted-chat-runtime.js";
 import { createDefaultHostedInvokeAgentTool } from "./default-hosted-invoke-agent-tool.js";
 import { createDefaultHostedProjectSteeringRefresh, fetchDefaultHostedProjectSteering, } from "./default-hosted-project-steering-refresh.js";
-import { loadRuntimeAgentMarkdownDefinitionFromFile, resolveRuntimeAgentDefinitionsDir, } from "./runtime-agent-definition-files.js";
+import { listRuntimeAgentMarkdownDefinitionIds } from "./runtime-agent-definition-files.js";
 import { buildVeryfrontCloudRuntimeInstructions, } from "./veryfront-cloud-runtime-system-messages.js";
 import { createNodeAgentServiceRuntimeInfrastructure, } from "./node-agent-service-runtime-infrastructure.js";
 import { createAgentServiceRuntime, startAgentServiceRuntime, startNodeAgentService, } from "./agent-service-runtime.js";
@@ -127,20 +127,14 @@ function createNodeVeryfrontCloudAgentServiceContext(options) {
     function trace(operationName, operation) {
         return infrastructure.tracer.trace(operationName, operation);
     }
-    const projectSteering = createHostedAgentProjectSteering({
-        baseDir: resolveBaseDir(options),
-        agentId: options.agentId,
-        getApiUrl: () => infrastructure.getConfig().VERYFRONT_API_URL,
-        logger: infrastructure.logger,
-        trace,
-    });
     return {
         options,
         processTarget,
         projectDir: resolveProjectDir(options),
         infrastructure,
         trace,
-        projectSteering,
+        defaultAgentId: null,
+        projectSteeringByAgentId: new Map(),
         tracker: createDetachedRunTracker(),
         discoveryResult: null,
         agentConfig: null,
@@ -160,21 +154,11 @@ async function createRuntimeAgentDefinitionFromCodeAgent(codeAgent) {
         maxSteps: codeAgent.config.maxSteps,
     };
 }
-function getMarkdownAgentConfig(context) {
-    return context.projectSteering.getAgentConfig();
+function getMarkdownAgentConfig(context, agentId) {
+    return getProjectSteering(context, agentId).getAgentConfig();
 }
 function loadMarkdownAgentConfig(context, agentId) {
-    if (agentId === context.options.agentId) {
-        return getMarkdownAgentConfig(context);
-    }
-    const agentsDir = resolveRuntimeAgentDefinitionsDir({
-        baseDir: resolveBaseDir(context.options),
-        id: agentId,
-    });
-    return loadRuntimeAgentMarkdownDefinitionFromFile({
-        agentsDir,
-        id: agentId,
-    });
+    return getMarkdownAgentConfig(context, agentId);
 }
 async function resolveAgentConfig(context, agentId) {
     const cachedAgentConfig = context.agentConfigs.get(agentId);
@@ -213,28 +197,89 @@ async function discoverProjectPrimitives(context) {
     });
     context.discoveryResult = await discoverAll(discoveryOptions);
 }
+function getDiscoveredCodeAgentIds(context) {
+    return [...(context.discoveryResult?.agents.keys() ?? [])].sort((left, right) => left.localeCompare(right));
+}
+function getDiscoveredMarkdownAgentIds(context) {
+    return listRuntimeAgentMarkdownDefinitionIds({
+        baseDir: resolveBaseDir(context.options),
+    });
+}
+function describeAgentIdCandidates(input) {
+    const ids = [...new Set([...input.codeAgentIds, ...input.markdownAgentIds])]
+        .sort((left, right) => left.localeCompare(right));
+    return ids.length > 0 ? ids.join(", ") : "none";
+}
+function resolveSingleAgentId(input) {
+    if (input.source === "code") {
+        return input.codeAgentIds.length === 1 ? input.codeAgentIds[0] ?? null : null;
+    }
+    if (input.source === "markdown") {
+        return input.markdownAgentIds.length === 1 ? input.markdownAgentIds[0] ?? null : null;
+    }
+    const candidateIds = [...new Set([...input.codeAgentIds, ...input.markdownAgentIds])];
+    return candidateIds.length === 1 ? candidateIds[0] ?? null : null;
+}
+function resolveDefaultAgentId(context) {
+    if (context.options.agentId) {
+        return context.options.agentId;
+    }
+    const source = context.options.agentSource ?? "auto";
+    const codeAgentIds = getDiscoveredCodeAgentIds(context);
+    const markdownAgentIds = getDiscoveredMarkdownAgentIds(context);
+    const agentId = resolveSingleAgentId({ codeAgentIds, markdownAgentIds, source });
+    if (agentId) {
+        return agentId;
+    }
+    throw new Error([
+        "agentId is required when agent discovery does not resolve to exactly one agent.",
+        `Discovered agents: ${describeAgentIdCandidates({ codeAgentIds, markdownAgentIds })}.`,
+    ].join(" "));
+}
 async function initializeNodeVeryfrontCloudAgentServiceContext(context) {
     await discoverProjectPrimitives(context);
-    context.agentConfig = await resolveAgentConfig(context, context.options.agentId);
+    context.defaultAgentId = resolveDefaultAgentId(context);
+    context.agentConfig = await resolveAgentConfig(context, context.defaultAgentId);
+}
+function getDefaultAgentId(context) {
+    if (!context.defaultAgentId) {
+        throw new Error("Agent service context has not been initialized.");
+    }
+    return context.defaultAgentId;
+}
+function getProjectSteering(context, agentId = getDefaultAgentId(context)) {
+    const cachedProjectSteering = context.projectSteeringByAgentId.get(agentId);
+    if (cachedProjectSteering) {
+        return cachedProjectSteering;
+    }
+    const projectSteering = createHostedAgentProjectSteering({
+        baseDir: resolveBaseDir(context.options),
+        agentId,
+        getApiUrl: () => context.infrastructure.getConfig().VERYFRONT_API_URL,
+        logger: context.infrastructure.logger,
+        trace: context.trace,
+    });
+    context.projectSteeringByAgentId.set(agentId, projectSteering);
+    return projectSteering;
 }
 function getDiscoveredHostTools() {
     return Object.fromEntries([...toolRegistry.getAll()].sort(([left], [right]) => left.localeCompare(right)));
 }
 function getProjectInstructions(context, lookup) {
     return context.trace("chat.getProjectInstructions", async () => {
-        return await context.projectSteering.getProjectInstructions(lookup);
+        return await getProjectSteering(context).getProjectInstructions(lookup);
     });
 }
 function getSkillsConfig(context, lookup) {
     return context.trace("chat.getSkillsConfig", async () => {
-        return await context.projectSteering.getSkillsConfig(lookup);
+        return await getProjectSteering(context).getSkillsConfig(lookup);
     });
 }
 function createLoadSkillTool(context, toolContext) {
-    return context.projectSteering.createLoadSkillTool(toolContext);
+    return getProjectSteering(context).createLoadSkillTool(toolContext);
 }
 async function refreshProjectSkillIds(context, skillContext) {
-    await context.projectSteering.refreshProjectSkillIds(skillContext);
+    await getProjectSteering(context).refreshProjectSkillIds(skillContext);
 }
 function setFilteredTraceAttributes(context, attributes) {
     context.infrastructure.setActiveSpanAttributes(filterAgentTraceAttributes(attributes));
@@ -381,7 +426,7 @@ async function prepareChatExecution(context, req) {
     const { userId, authToken, projectId, conversationId, upstreamParentConversationId, upstreamParentRunId, spawnedFromToolCallId, } = req;
     const config = context.infrastructure.getConfig();
     setPrepareChatExecutionStartAttributes(context, { projectId, userId });
-    const agentConfig = await resolveAgentConfig(context, req.agentId ?? context.options.agentId);
+    const agentConfig = await resolveAgentConfig(context, req.agentId ?? getDefaultAgentId(context));
     const { effectiveMessages, rootRunContext, runtime: { agent, runtimeKind, modelId, cleanup }, finalMessages, } = await prepareVeryfrontCloudHostedChatExecution({
         request: req,
         agentConfig,

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

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.511",
+  "version": "0.1.512",
   "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.511",
+  "version": "0.1.512",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [

package/src/src/agent/runtime-agent-definition-files.ts

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { basename, resolve } from "node:path";
 import { z } from "zod";
 import {
@@ -19,6 +19,14 @@ export type ResolveRuntimeAgentDefinitionsDirInput = z.infer<
   typeof resolveRuntimeAgentDefinitionsDirInputSchema
 >;
 
+export const listRuntimeAgentMarkdownDefinitionIdsInputSchema = z.object({
+  baseDir: z.string().min(1),
+});
+
+export type ListRuntimeAgentMarkdownDefinitionIdsInput = z.infer<
+  typeof listRuntimeAgentMarkdownDefinitionIdsInputSchema
+>;
+
 export const loadRuntimeAgentMarkdownDefinitionFromFileInputSchema = z.object({
   agentsDir: z.string().min(1),
   id: runtimeAgentDefinitionFileIdSchema,
@@ -40,27 +48,62 @@ function hasRuntimeAgentDefinitionFile(path: string, fileName: string): boolean
   return existsSync(resolve(path, fileName));
 }
 
+function getRuntimeAgentDefinitionsDirCandidates(baseDir: string): string[] {
+  const firstCandidate = resolve(baseDir, "agents");
+  const sourceLayoutCandidate = resolve(baseDir, "../agents");
+  const candidates = [
+    firstCandidate,
+    sourceLayoutCandidate,
+    resolve(baseDir, "../../agents"),
+    resolve(baseDir, "../../../agents"),
+  ];
+
+  return [...new Set(candidates)];
+}
+
 export function resolveRuntimeAgentDefinitionsDir(
   input: ResolveRuntimeAgentDefinitionsDirInput,
 ): string {
   const parsedInput = resolveRuntimeAgentDefinitionsDirInputSchema.parse(input);
   const fileName = getRuntimeAgentDefinitionFileName(parsedInput);
-  const firstCandidate = resolve(parsedInput.baseDir, "agents");
+  const candidates = getRuntimeAgentDefinitionsDirCandidates(parsedInput.baseDir);
   const sourceLayoutCandidate = resolve(parsedInput.baseDir, "../agents");
-  const candidates = [
-    firstCandidate,
-    sourceLayoutCandidate,
-    resolve(parsedInput.baseDir, "../../agents"),
-    resolve(parsedInput.baseDir, "../../../agents"),
-  ];
   const fallbackCandidate = basename(parsedInput.baseDir) === "src"
     ? sourceLayoutCandidate
-    : firstCandidate;
+    : resolve(parsedInput.baseDir, "agents");
 
   return candidates.find((candidate) => hasRuntimeAgentDefinitionFile(candidate, fileName)) ??
     fallbackCandidate;
 }
 
+export function listRuntimeAgentMarkdownDefinitionIds(
+  input: ListRuntimeAgentMarkdownDefinitionIdsInput,
+): string[] {
+  const parsedInput = listRuntimeAgentMarkdownDefinitionIdsInputSchema.parse(input);
+  const ids = new Set<string>();
+
+  for (const dir of getRuntimeAgentDefinitionsDirCandidates(parsedInput.baseDir)) {
+    if (!existsSync(dir)) {
+      continue;
+    }
+
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      if (!entry.isFile()) {
+        continue;
+      }
+
+      const parseResult = runtimeAgentDefinitionFileNameSchema.safeParse(entry.name);
+      if (!parseResult.success) {
+        continue;
+      }
+
+      ids.add(parseResult.data.slice(0, -".md".length));
+    }
+  }
+
+  return [...ids].sort((left, right) => left.localeCompare(right));
+}
+
 export function resolveRuntimeAgentMarkdownDefinitionFilePath(
   input: LoadRuntimeAgentMarkdownDefinitionFromFileInput,
 ): string {

package/src/src/agent/veryfront-cloud-agent-service.ts

@@ -40,7 +40,10 @@ import {
 } from "./agent-service-bootstrap.js";
 import { loadAgentServiceEnvFiles } from "./agent-service-env-files.js";
 import { createHostedFormInputTool } from "./hosted-form-input-tool.js";
-import { createHostedAgentProjectSteering } from "./hosted-agent-project-steering.js";
+import {
+  createHostedAgentProjectSteering,
+  type HostedAgentProjectSteering,
+} from "./hosted-agent-project-steering.js";
 import { type HostedChatRuntimeCreationResult } from "./hosted-chat-runtime-contract.js";
 import type { HostedConversationRootRunContext } from "./conversation-root-run-lifecycle.js";
 import { type AgentRuntimeMessage } from "./agent-runtime-message-adapter.js";
@@ -65,10 +68,7 @@ import type { AgentServiceMcpServerConfig } from "./agent-service-mcp-server-con
 import type { RuntimeLoadSkillToolContext } from "./runtime-load-skill-tool.js";
 import type { RuntimeProjectSteeringLookup } from "./runtime-project-skill-catalog.js";
 import type { RuntimeSkillDefinition } from "./runtime-skill-metadata.js";
-import {
-  loadRuntimeAgentMarkdownDefinitionFromFile,
-  resolveRuntimeAgentDefinitionsDir,
-} from "./runtime-agent-definition-files.js";
+import { listRuntimeAgentMarkdownDefinitionIds } from "./runtime-agent-definition-files.js";
 import type { RuntimeAgentMarkdownDefinition } from "./runtime-agent-definition.js";
 import {
   buildVeryfrontCloudRuntimeInstructions,
@@ -132,7 +132,11 @@ type AgentServicePathOption = string | URL;
 
 export type NodeVeryfrontCloudAgentServiceOptions = {
   serviceName: string;
-  agentId: string;
+  /**
+   * Default agent served by requests that do not provide an agent id. When
+   * omitted, the service selects the only discovered code or markdown agent.
+   */
+  agentId?: string;
   /**
    * Project/discovery root. Defaults to the process cwd when neither baseDir
    * nor an entrypoint URL is provided.
@@ -310,13 +314,6 @@ function createNodeVeryfrontCloudAgentServiceContext(
   ): TResult | Promise<TResult> {
     return infrastructure.tracer.trace(operationName, operation);
   }
-  const projectSteering = createHostedAgentProjectSteering({
-    baseDir: resolveBaseDir(options),
-    agentId: options.agentId,
-    getApiUrl: () => infrastructure.getConfig().VERYFRONT_API_URL,
-    logger: infrastructure.logger,
-    trace,
-  });
 
   return {
     options,
@@ -324,7 +321,8 @@ function createNodeVeryfrontCloudAgentServiceContext(
     projectDir: resolveProjectDir(options),
     infrastructure,
     trace,
-    projectSteering,
+    defaultAgentId: null as string | null,
+    projectSteeringByAgentId: new Map<string, HostedAgentProjectSteering>(),
     tracker: createDetachedRunTracker<AgUiResumeValue>(),
     discoveryResult: null as DiscoveryResult | null,
     agentConfig: null as RuntimeAgentMarkdownDefinition | null,
@@ -351,27 +349,16 @@ async function createRuntimeAgentDefinitionFromCodeAgent(
 
 function getMarkdownAgentConfig(
   context: NodeVeryfrontCloudAgentServiceContext,
+  agentId: string,
 ): RuntimeAgentMarkdownDefinition {
-  return context.projectSteering.getAgentConfig();
+  return getProjectSteering(context, agentId).getAgentConfig();
 }
 
 function loadMarkdownAgentConfig(
   context: NodeVeryfrontCloudAgentServiceContext,
   agentId: string,
 ): RuntimeAgentMarkdownDefinition {
-  if (agentId === context.options.agentId) {
-    return getMarkdownAgentConfig(context);
-  }
-
-  const agentsDir = resolveRuntimeAgentDefinitionsDir({
-    baseDir: resolveBaseDir(context.options),
-    id: agentId,
-  });
-
-  return loadRuntimeAgentMarkdownDefinitionFromFile({
-    agentsDir,
-    id: agentId,
-  });
+  return getMarkdownAgentConfig(context, agentId);
 }
 
 async function resolveAgentConfig(
@@ -427,11 +414,102 @@ async function discoverProjectPrimitives(
   context.discoveryResult = await discoverAll(discoveryOptions);
 }
 
+function getDiscoveredCodeAgentIds(context: NodeVeryfrontCloudAgentServiceContext): string[] {
+  return [...(context.discoveryResult?.agents.keys() ?? [])].sort((left, right) =>
+    left.localeCompare(right)
+  );
+}
+
+function getDiscoveredMarkdownAgentIds(context: NodeVeryfrontCloudAgentServiceContext): string[] {
+  return listRuntimeAgentMarkdownDefinitionIds({
+    baseDir: resolveBaseDir(context.options),
+  });
+}
+
+function describeAgentIdCandidates(input: {
+  codeAgentIds: string[];
+  markdownAgentIds: string[];
+}): string {
+  const ids = [...new Set([...input.codeAgentIds, ...input.markdownAgentIds])]
+    .sort((left, right) => left.localeCompare(right));
+
+  return ids.length > 0 ? ids.join(", ") : "none";
+}
+
+function resolveSingleAgentId(input: {
+  codeAgentIds: string[];
+  markdownAgentIds: string[];
+  source: NodeVeryfrontCloudAgentServiceAgentSource;
+}): string | null {
+  if (input.source === "code") {
+    return input.codeAgentIds.length === 1 ? input.codeAgentIds[0] ?? null : null;
+  }
+
+  if (input.source === "markdown") {
+    return input.markdownAgentIds.length === 1 ? input.markdownAgentIds[0] ?? null : null;
+  }
+
+  const candidateIds = [...new Set([...input.codeAgentIds, ...input.markdownAgentIds])];
+  return candidateIds.length === 1 ? candidateIds[0] ?? null : null;
+}
+
+function resolveDefaultAgentId(context: NodeVeryfrontCloudAgentServiceContext): string {
+  if (context.options.agentId) {
+    return context.options.agentId;
+  }
+
+  const source = context.options.agentSource ?? "auto";
+  const codeAgentIds = getDiscoveredCodeAgentIds(context);
+  const markdownAgentIds = getDiscoveredMarkdownAgentIds(context);
+  const agentId = resolveSingleAgentId({ codeAgentIds, markdownAgentIds, source });
+
+  if (agentId) {
+    return agentId;
+  }
+
+  throw new Error(
+    [
+      "agentId is required when agent discovery does not resolve to exactly one agent.",
+      `Discovered agents: ${describeAgentIdCandidates({ codeAgentIds, markdownAgentIds })}.`,
+    ].join(" "),
+  );
+}
+
 async function initializeNodeVeryfrontCloudAgentServiceContext(
   context: NodeVeryfrontCloudAgentServiceContext,
 ): Promise<void> {
   await discoverProjectPrimitives(context);
-  context.agentConfig = await resolveAgentConfig(context, context.options.agentId);
+  context.defaultAgentId = resolveDefaultAgentId(context);
+  context.agentConfig = await resolveAgentConfig(context, context.defaultAgentId);
+}
+
+function getDefaultAgentId(context: NodeVeryfrontCloudAgentServiceContext): string {
+  if (!context.defaultAgentId) {
+    throw new Error("Agent service context has not been initialized.");
+  }
+
+  return context.defaultAgentId;
+}
+
+function getProjectSteering(
+  context: NodeVeryfrontCloudAgentServiceContext,
+  agentId: string = getDefaultAgentId(context),
+): HostedAgentProjectSteering {
+  const cachedProjectSteering = context.projectSteeringByAgentId.get(agentId);
+  if (cachedProjectSteering) {
+    return cachedProjectSteering;
+  }
+
+  const projectSteering = createHostedAgentProjectSteering({
+    baseDir: resolveBaseDir(context.options),
+    agentId,
+    getApiUrl: () => context.infrastructure.getConfig().VERYFRONT_API_URL,
+    logger: context.infrastructure.logger,
+    trace: context.trace,
+  });
+
+  context.projectSteeringByAgentId.set(agentId, projectSteering);
+  return projectSteering;
 }
 
 function getDiscoveredHostTools(): HostToolSet {
@@ -445,7 +523,7 @@ function getProjectInstructions(
   lookup: RuntimeProjectSteeringLookup,
 ): Promise<string> {
   return context.trace("chat.getProjectInstructions", async () => {
-    return await context.projectSteering.getProjectInstructions(lookup);
+    return await getProjectSteering(context).getProjectInstructions(lookup);
   });
 }
 
@@ -454,7 +532,7 @@ function getSkillsConfig(
   lookup: RuntimeProjectSteeringLookup,
 ): Promise<RuntimeSkillDefinition[]> {
   return context.trace("chat.getSkillsConfig", async () => {
-    return await context.projectSteering.getSkillsConfig(lookup);
+    return await getProjectSteering(context).getSkillsConfig(lookup);
   });
 }
 
@@ -462,14 +540,14 @@ function createLoadSkillTool(
   context: NodeVeryfrontCloudAgentServiceContext,
   toolContext: RuntimeLoadSkillToolContext,
 ) {
-  return context.projectSteering.createLoadSkillTool(toolContext);
+  return getProjectSteering(context).createLoadSkillTool(toolContext);
 }
 
 async function refreshProjectSkillIds(
   context: NodeVeryfrontCloudAgentServiceContext,
   skillContext: HostedProjectSkillIdsContext,
 ): Promise<void> {
-  await context.projectSteering.refreshProjectSkillIds(skillContext);
+  await getProjectSteering(context).refreshProjectSkillIds(skillContext);
 }
 
 function setFilteredTraceAttributes(
@@ -683,7 +761,7 @@ async function prepareChatExecution(
 
   setPrepareChatExecutionStartAttributes(context, { projectId, userId });
 
-  const agentConfig = await resolveAgentConfig(context, req.agentId ?? context.options.agentId);
+  const agentConfig = await resolveAgentConfig(context, req.agentId ?? getDefaultAgentId(context));
   const {
     effectiveMessages,
     rootRunContext,

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

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