eve/dist/src/compiler/compile-from-memory.d.ts

Filesystem-first framework for durable backend AI agents that run anywhere.

import type { JsonObject } from "#shared/json.js";
import { type CompiledAgentManifest } from "#compiler/manifest.js";
import type { CompiledModuleMap } from "#compiler/module-map.js";
/**
 * Declarative description of an in-memory authored agent used by the test
 * harness.
 */
export interface CompileFromMemoryInput {
    /** Identifies this synthetic agent in manifest metadata and error output. */
    readonly name?: string;
    /**
     * Virtual app root used in manifest paths. The directory does not need to
     * exist on disk; discovery never runs against it.
     */
    readonly appRoot?: string;
    /**
     * Virtual agent root. Defaults to `<appRoot>/agent`.
     */
    readonly agentRoot?: string;
    /** Model id assigned to the synthetic agent config. */
    readonly model: string;
    readonly outputSchema?: JsonObject;
    /**
     * Authored tools to project into the compiled manifest and module map.
     *
     * Each entry corresponds to a single module-backed tool. The harness does
     * not load the tool module from disk — its runtime behaviour is injected
     * separately via the AppHarness `mockTool` API.
     */
    readonly tools?: readonly CompileFromMemoryToolInput[];
    /**
     * Authored markdown skills to include in the manifest.
     */
    readonly skills?: readonly CompileFromMemorySkillInput[];
}
/**
 * Per-tool descriptor entry consumed by {@link compileFromMemory}.
 */
export interface CompileFromMemoryToolInput {
    /** Model-facing tool name; must match the slot name in the module map. */
    readonly name: string;
    /** Human-readable description propagated to the compiled manifest. */
    readonly description?: string;
    /**
     * JSON-schema-like object describing the tool input. Passed through as-is
     * (lowered to `null` when omitted).
     */
    readonly inputSchema?: JsonObject | null;
    /** JSON-schema-like object describing the tool output. */
    readonly outputSchema?: JsonObject;
}
/**
 * Per-skill descriptor entry consumed by {@link compileFromMemory}.
 */
export interface CompileFromMemorySkillInput {
    readonly name: string;
    readonly description: string;
    readonly markdown?: string;
}
/**
 * Result produced by {@link compileFromMemory}. Shaped to match the subset
 * of `CompileAgentResult` that the runtime and harness need.
 */
export interface CompileFromMemoryResult {
    readonly manifest: CompiledAgentManifest;
    readonly moduleMap: CompiledModuleMap;
}
/**
 * Builds a compiled manifest and matching module map directly from an
 * in-memory descriptor, bypassing discovery and bundling entirely.
 *
 * Intended for integration tests that want to exercise runtime behaviour
 * without the cost of real compilation. Production code must continue to
 * use {@link compileAgent}.
 */
export declare function compileFromMemory(input: CompileFromMemoryInput): CompileFromMemoryResult;