veryfront 0.1.514 → 0.1.516

package/src/deps/esm.sh/@types/{react@19.2.14 → react@19.2.3}/index.d.ts

@@ -16,7 +16,6 @@ type NativeKeyboardEvent = KeyboardEvent;
 type NativeMouseEvent = MouseEvent;
 type NativeTouchEvent = TouchEvent;
 type NativePointerEvent = PointerEvent;
-type NativeSubmitEvent = SubmitEvent;
 type NativeToggleEvent = ToggleEvent;
 type NativeTransitionEvent = TransitionEvent;
 type NativeUIEvent = UIEvent;
@@ -226,20 +225,12 @@ declare namespace React {
 
     type ComponentState = any;
 
-    interface DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_KEY_TYPES {}
-
     /**
      * A value which uniquely identifies a node among items in an array.
      *
      * @see {@link https://react.dev/learn/rendering-lists#keeping-list-items-in-order-with-key React Docs}
      */
-    type Key =
-        | string
-        | number
-        | bigint
-        | DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_KEY_TYPES[
-            keyof DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_KEY_TYPES
-        ];
+    type Key = string | number | bigint;
 
     /**
      * @internal The props any component can receive.
@@ -1893,7 +1884,7 @@ declare namespace React {
      *
      * @param callback A synchronous, void callback that will execute as a single, complete React commit.
      *
-     * @see {@link https://reactjs.org/blog/2019/02/06/react-v16.8.0.html#testing-hooks}
+     * @see https://reactjs.org/blog/2019/02/06/react-v16.8.0.html#testing-hooks
      */
     // NOTES
     // - the order of these signatures matters - typescript will check the signatures in source order.
@@ -1935,31 +1926,7 @@ declare namespace React {
         reducer: (state: State, action: Action) => State,
     ): [State, (action: Action) => void];
 
-    interface UntrackedReactPromise<T> extends PromiseLike<T> {
-        status?: void;
-    }
-
-    export interface PendingReactPromise<T> extends PromiseLike<T> {
-        status: "pending";
-    }
-
-    export interface FulfilledReactPromise<T> extends PromiseLike<T> {
-        status: "fulfilled";
-        value: T;
-    }
-
-    export interface RejectedReactPromise<T> extends PromiseLike<T> {
-        status: "rejected";
-        reason: unknown;
-    }
-
-    export type ReactPromise<T> =
-        | UntrackedReactPromise<T>
-        | PendingReactPromise<T>
-        | FulfilledReactPromise<T>
-        | RejectedReactPromise<T>;
-
-    export type Usable<T> = ReactPromise<T> | Context<T>;
+    export type Usable<T> = PromiseLike<T> | Context<T>;
 
     export function use<T>(usable: Usable<T>): T;
 
@@ -2074,28 +2041,15 @@ declare namespace React {
         target: EventTarget & Target;
     }
 
-    /**
-     * @deprecated FormEvent doesn't actually exist.
-     *             You probably meant to use {@link ChangeEvent}, {@link InputEvent}, {@link SubmitEvent}, or just {@link SyntheticEvent} instead
-     *             depending on the event type.
-     */
     interface FormEvent<T = Element> extends SyntheticEvent<T> {
     }
 
     interface InvalidEvent<T = Element> extends SyntheticEvent<T> {
+        target: EventTarget & T;
     }
 
-    /**
-     * change events bubble in React so their target is generally unknown.
-     * Only for form elements we know their target type because form events can't
-     * be nested.
-     * This type exists purely to narrow `target` for form elements. It doesn't
-     * reflect a DOM event. Change events are just fired as standard {@link SyntheticEvent}.
-     */
-    interface ChangeEvent<CurrentTarget = Element, Target = Element> extends SyntheticEvent<CurrentTarget> {
-        // TODO: This is wrong for change event handlers on arbitrary. Should
-        // be EventTarget & Target, but kept for backward compatibility until React 20.
-        target: EventTarget & CurrentTarget;
+    interface ChangeEvent<T = Element> extends SyntheticEvent<T> {
+        target: EventTarget & T;
     }
 
     interface InputEvent<T = Element> extends SyntheticEvent<T, NativeInputEvent> {
@@ -2165,13 +2119,6 @@ declare namespace React {
         shiftKey: boolean;
     }
 
-    interface SubmitEvent<T = Element> extends SyntheticEvent<T, NativeSubmitEvent> {
-        // `submitter` is available in react@canary
-        // submitter: HTMLElement | null;
-        // SubmitEvents are always targetted at HTMLFormElements.
-        target: EventTarget & HTMLFormElement;
-    }
-
     interface TouchEvent<T = Element> extends UIEvent<T, NativeTouchEvent> {
         altKey: boolean;
         changedTouches: TouchList;
@@ -2227,19 +2174,11 @@ declare namespace React {
     type CompositionEventHandler<T = Element> = EventHandler<CompositionEvent<T>>;
     type DragEventHandler<T = Element> = EventHandler<DragEvent<T>>;
     type FocusEventHandler<T = Element> = EventHandler<FocusEvent<T>>;
-    /**
-     * @deprecated FormEventHandler doesn't actually exist.
-     *             You probably meant to use {@link ChangeEventHandler}, {@link InputEventHandler}, {@link SubmitEventHandler}, or just {@link EventHandler} instead
-     *             depending on the event type.
-     */
     type FormEventHandler<T = Element> = EventHandler<FormEvent<T>>;
-    type ChangeEventHandler<CurrentTarget = Element, Target = Element> = EventHandler<
-        ChangeEvent<CurrentTarget, Target>
-    >;
+    type ChangeEventHandler<T = Element> = EventHandler<ChangeEvent<T>>;
     type InputEventHandler<T = Element> = EventHandler<InputEvent<T>>;
     type KeyboardEventHandler<T = Element> = EventHandler<KeyboardEvent<T>>;
     type MouseEventHandler<T = Element> = EventHandler<MouseEvent<T>>;
-    type SubmitEventHandler<T = Element> = EventHandler<SubmitEvent<T>>;
     type TouchEventHandler<T = Element> = EventHandler<TouchEvent<T>>;
     type PointerEventHandler<T = Element> = EventHandler<PointerEvent<T>>;
     type UIEventHandler<T = Element> = EventHandler<UIEvent<T>>;
@@ -2293,19 +2232,19 @@ declare namespace React {
         onBlur?: FocusEventHandler<T> | undefined;
         onBlurCapture?: FocusEventHandler<T> | undefined;
 
-        // form related Events
-        onChange?: ChangeEventHandler<T> | undefined;
-        onChangeCapture?: ChangeEventHandler<T> | undefined;
+        // Form Events
+        onChange?: FormEventHandler<T> | undefined;
+        onChangeCapture?: FormEventHandler<T> | undefined;
         onBeforeInput?: InputEventHandler<T> | undefined;
-        onBeforeInputCapture?: InputEventHandler<T> | undefined;
-        onInput?: InputEventHandler<T> | undefined;
-        onInputCapture?: InputEventHandler<T> | undefined;
-        onReset?: ReactEventHandler<T> | undefined;
-        onResetCapture?: ReactEventHandler<T> | undefined;
-        onSubmit?: SubmitEventHandler<T> | undefined;
-        onSubmitCapture?: SubmitEventHandler<T> | undefined;
-        onInvalid?: ReactEventHandler<T> | undefined;
-        onInvalidCapture?: ReactEventHandler<T> | undefined;
+        onBeforeInputCapture?: FormEventHandler<T> | undefined;
+        onInput?: FormEventHandler<T> | undefined;
+        onInputCapture?: FormEventHandler<T> | undefined;
+        onReset?: FormEventHandler<T> | undefined;
+        onResetCapture?: FormEventHandler<T> | undefined;
+        onSubmit?: FormEventHandler<T> | undefined;
+        onSubmitCapture?: FormEventHandler<T> | undefined;
+        onInvalid?: FormEventHandler<T> | undefined;
+        onInvalidCapture?: FormEventHandler<T> | undefined;
 
         // Image Events
         onLoad?: ReactEventHandler<T> | undefined;
@@ -2849,7 +2788,7 @@ declare namespace React {
 
         // Living Standard
         /**
-         * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/inert}
+         * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/inert
          */
         inert?: boolean | undefined;
         /**
@@ -3312,9 +3251,7 @@ declare namespace React {
         value?: string | readonly string[] | number | undefined;
         width?: number | string | undefined;
 
-        // No other element dispatching change events can be nested in a <input>
-        // so we know the target will be a HTMLInputElement.
-        onChange?: ChangeEventHandler<T, HTMLInputElement> | undefined;
+        onChange?: ChangeEventHandler<T> | undefined;
     }
 
     interface KeygenHTMLAttributes<T> extends HTMLAttributes<T> {
@@ -3479,9 +3416,7 @@ declare namespace React {
         required?: boolean | undefined;
         size?: number | undefined;
         value?: string | readonly string[] | number | undefined;
-        // No other element dispatching change events can be nested in a <select>
-        // so we know the target will be a HTMLSelectElement.
-        onChange?: ChangeEventHandler<T, HTMLSelectElement> | undefined;
+        onChange?: ChangeEventHandler<T> | undefined;
     }
 
     interface SourceHTMLAttributes<T> extends HTMLAttributes<T> {
@@ -3533,9 +3468,7 @@ declare namespace React {
         value?: string | readonly string[] | number | undefined;
         wrap?: string | undefined;
 
-        // No other element dispatching change events can be nested in a <textarea>
-        // so we know the target will be a HTMLTextAreaElement.
-        onChange?: ChangeEventHandler<T, HTMLTextAreaElement> | undefined;
+        onChange?: ChangeEventHandler<T> | undefined;
     }
 
     interface TdHTMLAttributes<T> extends HTMLAttributes<T> {
@@ -3607,9 +3540,6 @@ declare namespace React {
         method?: string | undefined;
         min?: number | string | undefined;
         name?: string | undefined;
-        nonce?: string | undefined;
-        part?: string | undefined;
-        slot?: string | undefined;
         style?: CSSProperties | undefined;
         target?: string | undefined;
         type?: string | undefined;
@@ -4127,6 +4057,7 @@ declare namespace React {
          * Captures which component contained the exception, and its ancestors.
          */
         componentStack?: string | null;
+        digest?: string | null;
     }
 
     // Keep in sync with JSX namespace in ./jsx-runtime.d.ts and ./jsx-dev-runtime.d.ts

package/src/deps/esm.sh/react-dom@19.2.4/client.d.ts

@@ -4,7 +4,7 @@
 
 // See https://github.com/facebook/react/blob/main/packages/react-dom/client.js to see how the exports are declared,
 
-import React = require("https://esm.sh/@types/react@19.2.14/index.d.ts");
+import React = require("https://esm.sh/@types/react@19.2.3/index.d.ts");
 
 export {};
 

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

@@ -12,7 +12,10 @@ 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/transform/index.js";
+import type {
+  ContentCompileOptions,
+  ContentProcessingResult,
+} 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";
@@ -64,7 +67,7 @@ export default function MDContent({ components, params, className, ...props }) {
 
 export async function compileMarkdown(
   options: ContentCompileOptions,
-): Promise<ContentRuntimeBundle> {
+): Promise<ContentProcessingResult> {
   const { content, frontmatter: providedFrontmatter, filePath, studioEmbed } = options;
 
   const { body, frontmatter: extractedFrontmatter } = extractFrontmatter(

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

@@ -1,6 +1,9 @@
 import { compile } from "@mdx-js/mdx";
 import type { Pluggable } from "unified";
-import type { ContentCompileOptions, ContentRuntimeBundle } from "../../../../src/extensions/transform/index.js";
+import type {
+  ContentCompileOptions,
+  ContentProcessingResult,
+} 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";
@@ -8,7 +11,7 @@ import { rehypeNodePositions } from "../plugins/rehype-node-positions.js";
 
 type PluggableList = Pluggable[];
 
-export async function compileMdx(options: ContentCompileOptions): Promise<ContentRuntimeBundle> {
+export async function compileMdx(options: ContentCompileOptions): Promise<ContentProcessingResult> {
   const {
     projectDir,
     content,

package/src/extensions/ext-transform-mdx/src/index.ts

@@ -1,12 +1,12 @@
 /**
- * ext-mdx — ContentTransformer implementation backed by MDX + remark/rehype.
+ * ext-mdx: ContentProcessor implementation backed by MDX + remark/rehype.
  *
- * Provides the `ContentTransformer` contract:
- *  - `compileMdx(options)`  — runs @mdx-js/mdx through veryfront's remark +
+ * Provides the `ContentProcessor` contract:
+ *  - `compileMdx(options)` runs @mdx-js/mdx through Veryfront's remark +
  *    rehype plugin stack and returns compiled ESM plus extracted headings
  *    and frontmatter.
- *  - `compileMarkdown(options)` — runs a unified markdown pipeline
- *    (remark-parse → remark-rehype → rehype-sanitize → rehype-stringify)
+ *  - `compileMarkdown(options)` runs a unified markdown pipeline
+ *    (remark-parse to remark-rehype to rehype-sanitize to rehype-stringify)
  *    producing sanitized HTML wrapped in a React component.
  *
  * Core's `src/transforms/md/compiler` and `src/transforms/mdx/compiler`
@@ -21,18 +21,18 @@ import type { ExtensionFactory } from "../../../src/extensions/index.js";
 import type {
   ContentCompileOptions,
   ContentPlugin,
-  ContentRuntimeBundle,
-  ContentTransformer,
+  ContentProcessingResult,
+  ContentProcessor,
 } 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";
 
-class MdxContentTransformer implements ContentTransformer {
-  compileMdx(options: ContentCompileOptions): Promise<ContentRuntimeBundle> {
+class MdxContentProcessor implements ContentProcessor {
+  compileMdx(options: ContentCompileOptions): Promise<ContentProcessingResult> {
     return compileMdx(options);
   }
-  compileMarkdown(options: ContentCompileOptions): Promise<ContentRuntimeBundle> {
+  compileMarkdown(options: ContentCompileOptions): Promise<ContentProcessingResult> {
     return compileMarkdown(options);
   }
   getRemarkPlugins(): ContentPlugin[] {
@@ -44,14 +44,14 @@ class MdxContentTransformer implements ContentTransformer {
 }
 
 const extMdx: ExtensionFactory = () => {
-  const impl = new MdxContentTransformer();
+  const impl = new MdxContentProcessor();
   return {
     name: "ext-transform-mdx",
     version: "0.1.0",
-    capabilities: [{ type: "contract", name: "ContentTransformer" }],
+    capabilities: [{ type: "contract", name: "ContentProcessor" }],
     setup(ctx) {
-      ctx.provide("ContentTransformer", impl);
-      ctx.logger.info("[ext-mdx] ContentTransformer registered");
+      ctx.provide("ContentProcessor", impl);
+      ctx.logger.info("[ext-mdx] ContentProcessor registered");
     },
     teardown() {
       // No resources to release.
@@ -60,4 +60,4 @@ const extMdx: ExtensionFactory = () => {
 };
 
 export default extMdx;
-export { MdxContentTransformer };
+export { MdxContentProcessor };

package/src/src/agent/index.ts

@@ -89,8 +89,6 @@ export type {
   AgentResponse,
   AgentStatus,
   AgentStreamResult,
-  AgentSuggestion,
-  AgentSuggestions,
   EdgeConfig,
   MemoryConfig,
   Message as AgentMessage,
@@ -105,6 +103,8 @@ export type {
   RuntimeStateRequest,
   RuntimeStateResolver,
   StreamToolCall,
+  Suggestion,
+  Suggestions,
   ToolCall,
   ToolCallPart,
   ToolCallPartWithArgs,
@@ -177,6 +177,12 @@ export {
   type PrepareDefaultHostedChildForkToolSourcesInput,
 } from "./hosted-child-fork-tool-sources.js";
 
+export {
+  createRuntimeAgentFromMarkdownDefinition,
+  getRuntimeAgentMarkdownDefinition,
+  isRuntimeAgentMarkdownAgent,
+} from "./runtime-agent-markdown-adapter.js";
+
 export {
   loadRuntimeAgentMarkdownDefinitionFromFile,
   type LoadRuntimeAgentMarkdownDefinitionFromFileInput,

package/src/src/agent/runtime/constants.ts

@@ -15,10 +15,15 @@ const MODEL_MAX_OUTPUT_TOKENS: Record<string, number> = {
   "google-ai-studio/gemini-2.5-flash": 8_192,
 };
 
+const MODEL_MAX_OUTPUT_TOKEN_ALIASES: Record<string, string> = {
+  "google/gemini-2.5-pro": "google-ai-studio/gemini-2.5-pro",
+  "google/gemini-2.5-flash": "google-ai-studio/gemini-2.5-flash",
+};
+
 /** Look up max output tokens for a model, stripping the `veryfront-cloud/` prefix. */
 export function getModelMaxOutputTokens(modelString: string): number | undefined {
   const normalized = modelString.startsWith("veryfront-cloud/")
     ? modelString.slice("veryfront-cloud/".length)
     : modelString;
-  return MODEL_MAX_OUTPUT_TOKENS[normalized];
+  return MODEL_MAX_OUTPUT_TOKENS[MODEL_MAX_OUTPUT_TOKEN_ALIASES[normalized] ?? normalized];
 }

package/src/src/agent/runtime/model-resolution.ts

@@ -9,7 +9,19 @@ import { isVeryfrontCloudEnabled } from "../../platform/cloud/resolver.js";
 
 export const AUTO_AGENT_MODEL = "auto";
 
-const HOSTED_PROVIDER_NAMES = new Set(["anthropic", "google", "openai"]);
+const HOSTED_PROVIDER_NAMES = new Set([
+  "anthropic",
+  "google",
+  "google-ai-studio",
+  "moonshotai",
+  "openai",
+]);
+const DIRECT_CREDENTIAL_PROVIDER_ALIASES: Record<string, string> = {
+  "google-ai-studio": "google",
+};
+const DIRECT_RUNTIME_PROVIDER_ALIASES: Record<string, string> = {
+  "google-ai-studio": "google",
+};
 const LEGACY_MODEL_ALIASES: Record<string, string> = {
   opus: "anthropic/claude-opus-4-6",
   sonnet: "anthropic/claude-sonnet-4-6",
@@ -25,6 +37,7 @@ const LEGACY_MODEL_ALIASES: Record<string, string> = {
   "gemini-3.1-pro": "google-ai-studio/gemini-2.5-pro",
   "gemini-2.5-pro": "google-ai-studio/gemini-2.5-pro",
   "gemini-2.5-flash": "google-ai-studio/gemini-2.5-flash",
+  "kimi-k2.5": "moonshotai/kimi-k2.5",
 };
 
 export function normalizeAgentModelConfig(model?: string): string {
@@ -46,7 +59,7 @@ export function resolveConfiguredAgentModel(model?: string): string {
 }
 
 function hasDirectProviderCredentials(provider: string): boolean {
-  switch (provider) {
+  switch (DIRECT_CREDENTIAL_PROVIDER_ALIASES[provider] ?? provider) {
     case "anthropic":
       return Boolean(getAnthropicEnvConfig().apiKey);
     case "google":
@@ -92,7 +105,8 @@ export function resolveRuntimeModel(model?: string): string {
   }
 
   if (!isVeryfrontCloudEnabled() || hasDirectProviderCredentials(provider)) {
-    return configuredModel;
+    const runtimeProvider = DIRECT_RUNTIME_PROVIDER_ALIASES[provider] ?? provider;
+    return `${runtimeProvider}/${modelId}`;
   }
 
   return `veryfront-cloud/${provider}/${modelId}`;

package/src/src/agent/runtime-agent-markdown-adapter.ts

@@ -0,0 +1,31 @@
+import { agent } from "./factory.js";
+import type { Agent } from "./types.js";
+import type { RuntimeAgentMarkdownDefinition } from "./runtime-agent-definition.js";
+
+const markdownDefinitionByAgent = new WeakMap<Agent, RuntimeAgentMarkdownDefinition>();
+
+export function createRuntimeAgentFromMarkdownDefinition(
+  definition: RuntimeAgentMarkdownDefinition,
+): Agent {
+  const runtimeAgent = agent({
+    id: definition.id,
+    name: definition.name,
+    description: definition.description,
+    system: definition.instructions,
+    ...(definition.model ? { model: definition.model } : {}),
+    ...(definition.maxSteps === undefined ? {} : { maxSteps: definition.maxSteps }),
+  });
+
+  markdownDefinitionByAgent.set(runtimeAgent, definition);
+  return runtimeAgent;
+}
+
+export function getRuntimeAgentMarkdownDefinition(
+  runtimeAgent: Agent,
+): RuntimeAgentMarkdownDefinition | null {
+  return markdownDefinitionByAgent.get(runtimeAgent) ?? null;
+}
+
+export function isRuntimeAgentMarkdownAgent(runtimeAgent: Agent): boolean {
+  return markdownDefinitionByAgent.has(runtimeAgent);
+}

package/src/src/agent/types.ts

@@ -44,30 +44,43 @@ export type ModelString = string;
 // Import for use in AgentConfig
 import type { EdgeConfig, MemoryConfig } from "./schemas/index.js";
 
-export type AgentSuggestion =
+export type Suggestion =
   | {
-    id: string;
     type: "prompt";
+    id?: never;
     title: string;
-    description?: string;
     prompt: string;
+    description?: never;
+    task?: never;
+  }
+  | {
+    id: string;
+    type: "prompt";
+    title?: never;
+    prompt?: never;
+    description?: never;
+    task?: never;
   }
   | {
     id: string;
     type: "task";
-    title: string;
-    description?: string;
-    task: string;
-    prompt?: string;
+    title?: never;
+    prompt?: never;
+    description?: never;
+    task?: never;
   };
 
-export interface AgentSuggestions {
+export interface Suggestions {
   welcomeMessage?: string;
-  suggestions: AgentSuggestion[];
+  suggestions: Suggestion[];
 }
 
 export interface AgentConfig {
   id?: string;
+  /** Human-readable display name for registry and control-plane listings. */
+  name?: string;
+  /** Optional summary shown in registry and control-plane listings. */
+  description?: string;
   /**
    * Optional model string in "provider/model" format.
    *
@@ -121,7 +134,7 @@ export interface AgentConfig {
    * and registers the skill tools.
    */
   skills?: true | string[];
-  suggestions?: AgentSuggestions;
+  suggestions?: Suggestions;
   /** Set to false to disable the default security middleware */
   security?: false;
 }

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

@@ -69,8 +69,11 @@ 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 { listRuntimeAgentMarkdownDefinitionIds } from "./runtime-agent-definition-files.js";
 import type { RuntimeAgentMarkdownDefinition } from "./runtime-agent-definition.js";
+import {
+  getRuntimeAgentMarkdownDefinition,
+  isRuntimeAgentMarkdownAgent,
+} from "./runtime-agent-markdown-adapter.js";
 import {
   buildVeryfrontCloudRuntimeInstructions,
 } from "./veryfront-cloud-runtime-system-messages.js";
@@ -401,8 +404,8 @@ async function createRuntimeAgentDefinitionFromCodeAgent(
 ): Promise<RuntimeAgentMarkdownDefinition> {
   return {
     id: codeAgent.id,
-    name: codeAgent.id,
-    description: "",
+    name: codeAgent.config.name ?? codeAgent.id,
+    description: codeAgent.config.description ?? "",
     instructions: await resolveAgentSystem(codeAgent.config.system),
     model: codeAgent.config.model,
     maxSteps: codeAgent.config.maxSteps,
@@ -435,7 +438,7 @@ async function resolveAgentConfig(
   const source = context.options.agentSource ?? "auto";
   const codeAgent = getAgent(agentId);
 
-  if (source !== "markdown" && codeAgent) {
+  if (source !== "markdown" && codeAgent && !isRuntimeAgentMarkdownAgent(codeAgent)) {
     const agentConfig = await createRuntimeAgentDefinitionFromCodeAgent(codeAgent);
     context.agentConfigs.set(agentConfig.id, agentConfig);
     return agentConfig;
@@ -445,6 +448,14 @@ async function resolveAgentConfig(
     throw new Error(`Code agent "${agentId}" was not discovered.`);
   }
 
+  const discoveredMarkdownDefinition = codeAgent
+    ? getRuntimeAgentMarkdownDefinition(codeAgent)
+    : null;
+  if (discoveredMarkdownDefinition) {
+    context.agentConfigs.set(discoveredMarkdownDefinition.id, discoveredMarkdownDefinition);
+    return discoveredMarkdownDefinition;
+  }
+
   const agentConfig = loadMarkdownAgentConfig(context, agentId);
   context.agentConfigs.set(agentConfig.id, agentConfig);
   return agentConfig;
@@ -477,15 +488,17 @@ async function discoverProjectPrimitives(
 }
 
 function getDiscoveredCodeAgentIds(context: NodeVeryfrontCloudAgentServiceContext): string[] {
-  return [...(context.discoveryResult?.agents.keys() ?? [])].sort((left, right) =>
-    left.localeCompare(right)
-  );
+  return [...(context.discoveryResult?.agents.entries() ?? [])]
+    .filter(([, discoveredAgent]) => !isRuntimeAgentMarkdownAgent(discoveredAgent))
+    .map(([id]) => id)
+    .sort((left, right) => left.localeCompare(right));
 }
 
 function getDiscoveredMarkdownAgentIds(context: NodeVeryfrontCloudAgentServiceContext): string[] {
-  return listRuntimeAgentMarkdownDefinitionIds({
-    baseDir: resolveBaseDir(context.options),
-  });
+  return [...(context.discoveryResult?.agents.entries() ?? [])]
+    .filter(([, discoveredAgent]) => isRuntimeAgentMarkdownAgent(discoveredAgent))
+    .map(([id]) => id)
+    .sort((left, right) => left.localeCompare(right));
 }
 
 function describeAgentIdCandidates(input: {