veryfront 0.1.499 → 0.1.501

package/src/extensions/{ext-google → ext-llm-google}/src/google-provider.ts

@@ -1,13 +1,13 @@
 /**
- * Google provider — implements the {@link AIProvider} contract for Google's
+ * Google provider — implements the {@link LLMProvider} contract for Google's
  * Generative Language API (direct + via Veryfront Cloud).
  *
  * Ported from `src/provider/runtime-loader.ts` as part of PR 13.
  *
- * @module extensions/ext-google/google-provider
+ * @module extensions/ext-llm-google/google-provider
  */
 
-import type { AIProvider, AIProviderConfig } from "../../../src/extensions/interfaces/index.js";
+import type { LLMProvider, LLMProviderConfig } from "../../../src/extensions/llm/index.js";
 import type { EmbeddingRuntime, ModelRuntime } from "../../../src/provider/types.js";
 import {
   buildProviderError,
@@ -858,10 +858,10 @@ export function createGoogleEmbeddingRuntime(
   };
 }
 
-export class GoogleProvider implements AIProvider {
+export class GoogleProvider implements LLMProvider {
   readonly id = "google";
 
-  createModel(modelId: string, config: AIProviderConfig): ModelRuntime {
+  createModel(modelId: string, config: LLMProviderConfig): ModelRuntime {
     return createGoogleModelRuntime(
       {
         apiKey: config.credential,
@@ -873,7 +873,7 @@ export class GoogleProvider implements AIProvider {
     );
   }
 
-  createEmbedding(modelId: string, config: AIProviderConfig): EmbeddingRuntime {
+  createEmbedding(modelId: string, config: LLMProviderConfig): EmbeddingRuntime {
     return createGoogleEmbeddingRuntime(
       {
         apiKey: config.credential,

package/src/extensions/ext-llm-google/src/index.ts

@@ -0,0 +1,31 @@
+/**
+ * @veryfront/ext-llm-google — registers the Google provider into the
+ * core `LLMProviderRegistry`.
+ *
+ * @module extensions/ext-llm-google
+ */
+
+import type { ExtensionFactory } from "../../../src/extensions/index.js";
+import type { LLMProviderRegistry } from "../../../src/extensions/llm/index.js";
+import { LLMProviderRegistryName } from "../../../src/extensions/llm/index.js";
+import { GoogleProvider } from "./google-provider.js";
+
+const extGoogle: ExtensionFactory = () => {
+  const provider = new GoogleProvider();
+  return {
+    name: "ext-llm-google",
+    version: "0.1.0",
+    capabilities: [{ type: "contract", name: "LLMProvider:google" }],
+    setup(ctx) {
+      const registry = ctx.require<LLMProviderRegistry>(LLMProviderRegistryName);
+      registry.register(provider);
+      ctx.logger.info("[ext-llm-google] Google provider registered");
+    },
+    teardown() {
+      // No resources to release.
+    },
+  };
+};
+
+export default extGoogle;
+export { GoogleProvider };

package/src/extensions/ext-llm-openai/src/index.ts

@@ -0,0 +1,33 @@
+/**
+ * @veryfront/ext-llm-openai — registers the OpenAI provider into the
+ * core `LLMProviderRegistry`.
+ *
+ * @module extensions/ext-llm-openai
+ */
+
+import type { ExtensionFactory } from "../../../src/extensions/index.js";
+import type { LLMProviderRegistry } from "../../../src/extensions/llm/index.js";
+import { LLMProviderRegistryName } from "../../../src/extensions/llm/index.js";
+import { OpenAIProvider } from "./openai-provider.js";
+
+const extOpenAI: ExtensionFactory = () => {
+  const provider = new OpenAIProvider();
+  let registry: LLMProviderRegistry | undefined;
+  return {
+    name: "ext-llm-openai",
+    version: "0.1.0",
+    capabilities: [{ type: "contract", name: "LLMProvider:openai" }],
+    setup(ctx) {
+      registry = ctx.require<LLMProviderRegistry>(LLMProviderRegistryName);
+      registry.register(provider);
+      ctx.logger.info("[ext-llm-openai] OpenAI provider registered");
+    },
+    teardown() {
+      registry?.unregister(provider.id);
+      registry = undefined;
+    },
+  };
+};
+
+export default extOpenAI;
+export { OpenAIProvider };

package/src/extensions/{ext-openai → ext-llm-openai}/src/openai-provider.ts

@@ -1,14 +1,14 @@
 /**
- * OpenAI provider — implements the {@link AIProvider} contract for OpenAI,
+ * OpenAI provider — implements the {@link LLMProvider} contract for OpenAI,
  * OpenAI-compatible endpoints (Azure OpenAI, Moonshot AI), and OpenAI's
  * Responses API.
  *
  * Ported from `src/provider/runtime-loader.ts` as part of PR 11.
  *
- * @module extensions/ext-openai/openai-provider
+ * @module extensions/ext-llm-openai/openai-provider
  */
 
-import type { AIProvider, AIProviderConfig } from "../../../src/extensions/interfaces/index.js";
+import type { LLMProvider, LLMProviderConfig } from "../../../src/extensions/llm/index.js";
 import type { EmbeddingRuntime, ModelRuntime } from "../../../src/provider/types.js";
 import {
   buildProviderError,
@@ -1467,10 +1467,10 @@ export function createOpenAIEmbeddingRuntime(
   };
 }
 
-export class OpenAIProvider implements AIProvider {
+export class OpenAIProvider implements LLMProvider {
   readonly id = "openai";
 
-  createModel(modelId: string, config: AIProviderConfig): ModelRuntime {
+  createModel(modelId: string, config: LLMProviderConfig): ModelRuntime {
     return createOpenAIModelRuntime(
       {
         apiKey: config.credential,
@@ -1482,7 +1482,7 @@ export class OpenAIProvider implements AIProvider {
     );
   }
 
-  createEmbedding(modelId: string, config: AIProviderConfig): EmbeddingRuntime {
+  createEmbedding(modelId: string, config: LLMProviderConfig): EmbeddingRuntime {
     return createOpenAIEmbeddingRuntime(
       {
         apiKey: config.credential,
@@ -1494,7 +1494,7 @@ export class OpenAIProvider implements AIProvider {
     );
   }
 
-  createResponses(modelId: string, config: AIProviderConfig): ModelRuntime {
+  createResponses(modelId: string, config: LLMProviderConfig): ModelRuntime {
     return createOpenAIResponsesRuntime(
       {
         apiKey: config.credential,

package/src/extensions/{ext-node-compat → ext-node-compatibility}/src/index.ts

@@ -1,5 +1,5 @@
 /**
- * ext-node-compat — Node.js compatibility shims for Veryfront.
+ * ext-node-compatibility — Node.js compatibility shims for Veryfront.
  *
  * Provides the `NodeCompat` contract:
  * - `importKreuzberg()` — document extraction via `@kreuzberg/wasm` (Deno)
@@ -12,7 +12,7 @@
  * Without this extension, core falls back to in-memory KV and document
  * extraction is unavailable.
  *
- * @module extensions/ext-node-compat
+ * @module extensions/ext-node-compatibility
  */
 import * as dntShim from "../../../_dnt.shims.js";
 
@@ -22,7 +22,7 @@ import type {
   KreuzbergExtractor,
   NodeCompat,
   NodeCompatSqliteDatabase,
-} from "../../../src/extensions/interfaces/index.js";
+} from "../../../src/extensions/compat/index.js";
 import { loadKreuzberg } from "./kreuzberg.js";
 
 // ---------------------------------------------------------------------------
@@ -122,7 +122,7 @@ const extNodeCompat: ExtensionFactory = () => {
   const impl = new NodeCompatImpl();
 
   return {
-    name: "ext-node-compat",
+    name: "ext-node-compatibility",
     version: "0.1.0",
     capabilities: [
       { type: "contract", name: "NodeCompat" },
@@ -131,7 +131,7 @@ const extNodeCompat: ExtensionFactory = () => {
 
     setup(ctx) {
       ctx.provide("NodeCompat", impl);
-      ctx.logger.info("[ext-node-compat] NodeCompat registered");
+      ctx.logger.info("[ext-node-compatibility] NodeCompat registered");
     },
   };
 };

package/src/extensions/{ext-node-compat → ext-node-compatibility}/src/kreuzberg.ts

@@ -1,17 +1,17 @@
 /**
- * Shared kreuzberg loader for the ext-node-compat extension.
+ * Shared kreuzberg loader for the ext-node-compatibility extension.
  *
  * Used by both `NodeCompatImpl.importKreuzberg()` (direct calls from
  * Node/Bun) and the extension's upload-extraction worker (Deno isolate).
  * Centralising the loader keeps the compiled-binary WASM glue + pdfium
  * pre-import dance in one place.
  *
- * @module extensions/ext-node-compat/kreuzberg
+ * @module extensions/ext-node-compatibility/kreuzberg
  */
 import * as dntShim from "../../../_dnt.shims.js";
 
 
-import type { KreuzbergExtractor } from "../../../src/extensions/interfaces/index.js";
+import type { KreuzbergExtractor } from "../../../src/extensions/compat/index.js";
 
 type KreuzbergModule = {
   initWasm?: () => Promise<void>;

package/src/extensions/{ext-babel → ext-parser-babel}/src/index.ts

@@ -1,5 +1,5 @@
 /**
- * ext-babel — CodeParser implementation backed by @babel/parser,
+ * ext-parser-babel — CodeParser implementation backed by @babel/parser,
  * @babel/traverse, @babel/generator, @babel/types.
  *
  * Provides the `CodeParser` contract:
@@ -11,7 +11,7 @@
  * Core's `src/transforms/plugins/babel-node-positions.ts` is a shim that
  * resolves this contract at call time.
  *
- * @module extensions/ext-babel
+ * @module extensions/ext-parser-babel
  */
 
 import * as parser from "@babel/parser";
@@ -26,7 +26,7 @@ import type {
   InjectJsxNodePositionsOptions,
   ParseOptions,
   TraverseVisitor,
-} from "../../../src/extensions/interfaces/index.js";
+} from "../../../src/extensions/parser/index.js";
 import { injectNodePositions } from "./inject-node-positions.js";
 
 type TraverseFunction = (ast: unknown, opts: Record<string, unknown>) => void;
@@ -91,12 +91,12 @@ class BabelCodeParser implements CodeParser {
 const extBabel: ExtensionFactory = () => {
   const impl = new BabelCodeParser();
   return {
-    name: "ext-babel",
+    name: "ext-parser-babel",
     version: "0.1.0",
     capabilities: [{ type: "contract", name: "CodeParser" }],
     setup(ctx) {
       ctx.provide("CodeParser", impl);
-      ctx.logger.info("[ext-babel] CodeParser registered");
+      ctx.logger.info("[ext-parser-babel] CodeParser registered");
     },
     teardown() {
       // No resources to release.

package/src/extensions/{ext-mdx → ext-transform-mdx}/src/compiler/markdown-compile.ts

@@ -12,7 +12,7 @@ import { visit } from "unist-util-visit";
 import { toString } from "mdast-util-to-string";
 import Slugger from "github-slugger";
 import type { Heading, Root as MdastRoot } from "@types/mdast";
-import type { ContentCompileOptions, ContentRuntimeBundle } from "../../../../src/extensions/interfaces/index.js";
+import type { ContentCompileOptions, ContentRuntimeBundle } from "../../../../src/extensions/transform/index.js";
 import { extractFrontmatter } from "../../../../src/transforms/mdx/compiler/frontmatter-extractor.js";
 import { isMarkdownPreview } from "../../../../src/transforms/md/utils.js";
 import { rehypeNodePositions } from "../plugins/rehype-node-positions.js";

package/src/extensions/{ext-mdx → ext-transform-mdx}/src/compiler/mdx-compile.ts

@@ -1,6 +1,6 @@
 import { compile } from "@mdx-js/mdx";
 import type { Pluggable } from "unified";
-import type { ContentCompileOptions, ContentRuntimeBundle } from "../../../../src/extensions/interfaces/index.js";
+import type { ContentCompileOptions, ContentRuntimeBundle } from "../../../../src/extensions/transform/index.js";
 import { extractFrontmatter } from "../../../../src/transforms/mdx/compiler/frontmatter-extractor.js";
 import { rewriteBodyImports, rewriteCompiledImports } from "../../../../src/transforms/mdx/compiler/import-rewriter.js";
 import { getRehypePlugins, getRemarkPlugins } from "../plugins/plugin-loader.js";

package/src/extensions/{ext-mdx → ext-transform-mdx}/src/index.ts

@@ -14,7 +14,7 @@
  * core throws an actionable install message (see
  * `src/extensions/recommendations.ts`).
  *
- * @module extensions/ext-mdx
+ * @module extensions/ext-transform-mdx
  */
 
 import type { ExtensionFactory } from "../../../src/extensions/index.js";
@@ -23,7 +23,7 @@ import type {
   ContentPlugin,
   ContentRuntimeBundle,
   ContentTransformer,
-} from "../../../src/extensions/interfaces/index.js";
+} from "../../../src/extensions/transform/index.js";
 import { compileMdx } from "./compiler/mdx-compile.js";
 import { compileMarkdown } from "./compiler/markdown-compile.js";
 import { getRehypePlugins, getRemarkPlugins } from "./plugins/plugin-loader.js";
@@ -46,7 +46,7 @@ class MdxContentTransformer implements ContentTransformer {
 const extMdx: ExtensionFactory = () => {
   const impl = new MdxContentTransformer();
   return {
-    name: "ext-mdx",
+    name: "ext-transform-mdx",
     version: "0.1.0",
     capabilities: [{ type: "contract", name: "ContentTransformer" }],
     setup(ctx) {

package/src/src/agent/agent-service-server.ts

@@ -2,6 +2,8 @@ import {
   createVeryfrontServer,
   type NodeVeryfrontServiceServer,
   startNodeVeryfrontServer,
+  startVeryfrontServer,
+  type VeryfrontServiceServer,
   type VeryfrontServiceServerLogger,
   type VeryfrontServiceServerRuntime,
 } from "../server/service-server.js";
@@ -26,7 +28,15 @@ export type StartNodeAgentServiceServerOptions = CreateAgentServiceServerRuntime
   hardShutdownTimeoutMs?: number;
 };
 
+export type StartAgentServiceServerOptions = CreateAgentServiceServerRuntimeOptions & {
+  port: number;
+  bindAddress?: string;
+  signals?: readonly NodeJS.Signals[];
+  hardShutdownTimeoutMs?: number;
+};
+
 export type NodeAgentServiceServer = NodeVeryfrontServiceServer;
+export type AgentServiceServer = VeryfrontServiceServer | NodeVeryfrontServiceServer;
 
 function getAgentServiceServerName(
   options: CreateAgentServiceServerRuntimeOptions,
@@ -70,3 +80,19 @@ export async function startNodeAgentServiceServer(
   await server.ready;
   return server;
 }
+
+export async function startAgentServiceServer(
+  options: StartAgentServiceServerOptions,
+): Promise<AgentServiceServer> {
+  const runtime = createAgentServiceServerRuntime(options);
+  const server = await startVeryfrontServer({
+    runtime,
+    port: options.port,
+    bindAddress: options.bindAddress,
+    logger: options.logger,
+    signals: options.signals,
+    hardShutdownTimeoutMs: options.hardShutdownTimeoutMs,
+  });
+  await server.ready;
+  return server;
+}

package/src/src/agent/default-hosted-chat-runtime.ts

@@ -45,6 +45,7 @@ export type DefaultHostedChatRuntimeConfig = {
   apiUrl: string;
   apiMcpUrl: string;
   studioMcpUrl?: string | null;
+  studioMcpEnabled?: boolean;
 };
 
 export type DefaultHostedChatRuntimeLogger = {
@@ -154,6 +155,7 @@ async function buildToolAssembly(
     apiUrl: input.config.apiUrl,
     apiMcpUrl: input.config.apiMcpUrl,
     studioMcpUrl: input.config.studioMcpUrl,
+    studioMcpEnabled: input.config.studioMcpEnabled,
     conversationId: input.options.conversationId,
     allowedToolNames: input.options.allowedTools ?? null,
     projectScopedRemoteToolOptions: input.projectScopedRemoteToolOptions,

package/src/src/agent/hosted-agent-service-runtime.ts

@@ -27,7 +27,9 @@ import type { ParsedHostedChatRequest } from "./hosted-chat-request-parser.js";
 import type { AgUiResumeValue } from "./ag-ui-tool-shared.js";
 import type { RuntimeAgentMarkdownDefinition } from "./runtime-agent-definition.js";
 import {
+  type AgentServiceServer,
   type NodeAgentServiceServer,
+  startAgentServiceServer,
   startNodeAgentServiceServer,
 } from "./agent-service-server.js";
 import type { VeryfrontServiceServerLogger } from "../server/service-server.js";
@@ -115,6 +117,15 @@ export type StartNodeAgentServiceOptions<
   TConfig extends AgentServiceRuntimeConfig = AgentServiceRuntimeConfig,
 > = StartNodeHostedAgentServiceOptions<TExecution, TConfig>;
 
+export type StartAgentServiceRuntimeOptions<
+  TExecution extends object,
+  TConfig extends AgentServiceRuntimeConfig = AgentServiceRuntimeConfig,
+> = CreateAgentServiceRuntimeOptions<TExecution, TConfig> & {
+  bindAddress?: string;
+  hardShutdownTimeoutMs?: number;
+  signals?: readonly NodeJS.Signals[];
+};
+
 export type StartNodeHostedAgentServiceResult<
   TExecution extends object,
   TConfig extends HostedAgentServiceRuntimeConfig = HostedAgentServiceRuntimeConfig,
@@ -127,6 +138,13 @@ export type StartNodeAgentServiceResult<
   TConfig extends AgentServiceRuntimeConfig = AgentServiceRuntimeConfig,
 > = StartNodeHostedAgentServiceResult<TExecution, TConfig>;
 
+export type StartAgentServiceRuntimeResult<
+  TExecution extends object,
+  TConfig extends AgentServiceRuntimeConfig = AgentServiceRuntimeConfig,
+> = AgentServiceRuntimeBundle<TExecution, TConfig> & {
+  server: AgentServiceServer;
+};
+
 function defaultTrace<TResult>(
   _operationName: string,
   operation: () => Promise<TResult>,
@@ -236,3 +254,27 @@ export async function startNodeAgentService<
 ): Promise<StartNodeAgentServiceResult<TExecution, TConfig>> {
   return startNodeHostedAgentService(options);
 }
+
+export async function startAgentServiceRuntime<
+  TExecution extends object,
+  TConfig extends AgentServiceRuntimeConfig = AgentServiceRuntimeConfig,
+>(
+  options: StartAgentServiceRuntimeOptions<TExecution, TConfig>,
+): Promise<StartAgentServiceRuntimeResult<TExecution, TConfig>> {
+  const bundle = createAgentServiceRuntime(options);
+  const server = await startAgentServiceServer({
+    runtime: bundle.runtime,
+    serviceName: options.serviceName,
+    lifecycle: bundle.lifecycle,
+    port: bundle.config.PORT,
+    bindAddress: options.bindAddress,
+    signals: options.signals,
+    logger: options.logger,
+    hardShutdownTimeoutMs: options.hardShutdownTimeoutMs,
+  });
+
+  return {
+    ...bundle,
+    server,
+  };
+}

package/src/src/agent/hosted-chat-runtime-tool-assembly.ts

@@ -58,6 +58,7 @@ export type PrepareHostedChatRuntimeToolAssemblyInput<
   apiUrl: string;
   apiMcpUrl: string;
   studioMcpUrl?: string | null;
+  studioMcpEnabled?: boolean;
   conversationId?: string;
   allowedToolNames?: HostedChatRuntimeAllowedToolNames;
   projectScopedRemoteToolOptions?: ProjectScopedRemoteToolOptions;
@@ -120,6 +121,7 @@ export async function prepareHostedChatRuntimeToolAssembly<
     authToken: input.taskContext.authToken,
     apiMcpUrl: input.apiMcpUrl,
     studioMcpUrl: input.studioMcpUrl,
+    studioMcpEnabled: input.studioMcpEnabled,
     clientProfile: input.taskContext.clientProfile,
     createRemoteToolSource: input.createRemoteToolSource ?? createRemoteMCPToolSource,
     defaultProjectId: () => activeProjectId(input.taskContext),

package/src/src/agent/hosted-project-remote-tool-source.ts

@@ -188,6 +188,7 @@ export type CreateHostedProjectRemoteToolSourcesInput =
     authToken: string;
     apiMcpUrl: string;
     studioMcpUrl?: string | null;
+    studioMcpEnabled?: boolean;
     clientProfile?: RuntimeClientProfile | null;
     getProjectId: () => string | null | undefined;
     conversationId?: string;
@@ -242,7 +243,9 @@ export function createHostedProjectRemoteToolSources(
     ),
   ];
 
-  if (!input.studioMcpUrl || !clientAllowsStudioMcp(input.clientProfile)) {
+  if (
+    !input.studioMcpEnabled || !input.studioMcpUrl || !clientAllowsStudioMcp(input.clientProfile)
+  ) {
     return sources;
   }
 

package/src/src/agent/hosted-stream-terminal-error.ts

@@ -5,7 +5,7 @@ import { parseProviderError } from "../chat/provider-errors.js";
 const EMPTY_RESPONSE_TERMINAL_ERROR_CODE = "EMPTY_RESPONSE";
 const EMPTY_RESPONSE_TERMINAL_ERROR_MESSAGE = "Assistant completed without producing a response";
 const EXTERNAL_SERVICE_ERROR_CODE = "EXTERNAL_SERVICE_ERROR";
-const EXTERNAL_SERVICE_ERROR_MESSAGE = "AI provider service error";
+const EXTERNAL_SERVICE_ERROR_MESSAGE = "LLM provider service error";
 const STREAM_ERROR_TERMINAL_ERROR_CODE = "STREAM_ERROR";
 
 export type HostedStreamTerminalError = {

package/src/src/agent/index.ts

@@ -252,10 +252,13 @@ export {
   type NormalizedAgentServiceContract,
 } from "./agent-service.js";
 export {
+  type AgentServiceServer,
   type AgentServiceServerLifecycle,
   createAgentServiceServerRuntime,
   type CreateAgentServiceServerRuntimeOptions,
   type NodeAgentServiceServer,
+  startAgentServiceServer,
+  type StartAgentServiceServerOptions,
   startNodeAgentServiceServer,
   type StartNodeAgentServiceServerOptions,
 } from "./agent-service-server.js";
@@ -316,6 +319,9 @@ export {
   type HostedAgentServiceRuntimeConfig,
   type HostedAgentServiceRuntimeLogger,
   type HostedAgentServiceRuntimeTrace,
+  startAgentServiceRuntime,
+  type StartAgentServiceRuntimeOptions,
+  type StartAgentServiceRuntimeResult,
   startNodeAgentService,
   type StartNodeAgentServiceOptions,
   type StartNodeAgentServiceResult,
@@ -325,11 +331,14 @@ export {
 } from "./hosted-agent-service-runtime.js";
 export {
   createNodeVeryfrontCloudAgentServiceRuntime,
+  type NodeVeryfrontCloudAgentServiceMcpOptions,
   type NodeVeryfrontCloudAgentServiceOptions,
   type NodeVeryfrontCloudAgentServicePreparedExecution,
   type NodeVeryfrontCloudAgentServiceProcessTarget,
   runNodeVeryfrontCloudAgentServiceMain,
+  startAgentService,
   startNodeVeryfrontCloudAgentService,
+  type VeryfrontCloudAgentServiceOptions,
 } from "./veryfront-cloud-agent-service.js";
 export {
   type AgentServiceConfig,

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

@@ -1,5 +1,5 @@
 import { existsSync, readFileSync } from "node:fs";
-import { resolve } from "node:path";
+import { basename, resolve } from "node:path";
 import { z } from "zod";
 import {
   parseRuntimeAgentMarkdownDefinition,
@@ -45,15 +45,20 @@ export function resolveRuntimeAgentDefinitionsDir(
 ): string {
   const parsedInput = resolveRuntimeAgentDefinitionsDirInputSchema.parse(input);
   const fileName = getRuntimeAgentDefinitionFileName(parsedInput);
-  const firstCandidate = resolve(parsedInput.baseDir, "../agents");
+  const firstCandidate = resolve(parsedInput.baseDir, "agents");
+  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;
 
   return candidates.find((candidate) => hasRuntimeAgentDefinitionFile(candidate, fileName)) ??
-    firstCandidate;
+    fallbackCandidate;
 }
 
 export function resolveRuntimeAgentMarkdownDefinitionFilePath(