@rowan-agent/agent 0.15.5 → 0.16.1

package/README.md

@@ -183,10 +183,12 @@ const agentId = await runtime.createAgent({
 Each `load*()` call replaces one source atomically; use `directory` or inline
 `values`. `resourceView` controls visibility, so same-name resources can live
 in isolated sources but collide when selected together. The Runtime supplies the
-core `read`/`bash`/`edit`/`write`/`route` Tools itself, and its `rowan.core`
-source — like an Extension's `rowan.extensions` — is implicit in every view, so
-a Definition can select a built-in Phase without naming that source. Core names
-cannot be claimed by another source.
+core `read`/`bash`/`edit`/`write` Tools and built-in `default`/`stop`/`compact` Phases.
+Host-defined resources (including Tools and Phases registered by Extensions) replace
+built-ins by name, retaining the built-in status (replaced Core Tools remain always
+available without explicit Definition selection; replaced Core Phases retain their
+built-in role). Reserved control names (`route` for Tools, `continue` for Phases)
+cannot be claimed by host sources.
 
 Extensions are Runtime-global. Load them only during `AgentRuntime.init()` via
 `bootstrap`; after initialization they are frozen until the Runtime closes.

package/dist/index.d.ts

@@ -206,6 +206,40 @@ type PhaseMessageManager = {
     discard(messageId: string): void;
 };
 
+type ScopeRef = {
+    kind: "global";
+} | {
+    kind: "team";
+    teamId: string;
+} | {
+    kind: "project";
+    teamId: string;
+    projectId: string;
+};
+interface ExtensionStateStore {
+    get(key: string): Promise<JsonValue | undefined>;
+    set(key: string, value: JsonValue): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+interface ExtensionHost {
+    getConfig(extensionId: string, scope?: ScopeRef): Promise<JsonObject | null> | JsonObject | null;
+    onConfigChanged?(listener: (extensionId: string, scope: ScopeRef) => void): (() => void) | void;
+    getAgentState(extensionId: string, agentId: string, key: string): Promise<JsonValue | undefined> | JsonValue | undefined;
+    setAgentState(extensionId: string, agentId: string, key: string, value: JsonValue): Promise<void> | void;
+    deleteAgentState(extensionId: string, agentId: string, key: string): Promise<void> | void;
+}
+type ExtensionToolContribution = {
+    kind: "tool";
+    name: string;
+    description: string;
+};
+type ExtensionCapabilityContribution = ExtensionToolContribution;
+type ExtensionCapability = {
+    extensionId: string;
+    kind: "tool";
+    name: string;
+    description: string;
+};
 interface SourceInfo {
     source: string;
     baseDir?: string;
@@ -235,6 +269,10 @@ interface ToolDefinition {
     description: string;
     /** Parameter schema (JSON Schema) */
     parameters: Record<string, unknown>;
+    /** Optional: one-line snippet shown in the system prompt tool list */
+    promptSnippet?: string;
+    /** Optional: additional guidelines appended to system prompt */
+    promptGuidelines?: string[];
     /** Execute the tool */
     execute: (args: unknown, context: ToolInvocationContext, signal?: AbortSignal) => Promise<ToolExecutionResult$1>;
     /** Optional: per-tool execution mode override */
@@ -318,6 +356,7 @@ type LoadExtensionsResult = {
  * Runner.loadExtensions() calls the factory and creates the full Extension object.
  */
 interface LoadedExtension {
+    id?: string;
     path: string;
     name: string;
     factory: ExtensionFactory;
@@ -325,6 +364,7 @@ interface LoadedExtension {
 }
 /** Extension manifest from package.json `rowan` field. */
 interface ExtensionManifest {
+    id?: string;
     entry?: string;
     name?: string;
 }
@@ -471,6 +511,20 @@ interface ExtensionAPI {
     on<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
     /** Unsubscribe from a hook event. */
     off<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
+    /** Extension configuration — read own layered config or listen for changes. */
+    config: {
+        /** Get the extension's own effective configuration block. */
+        get(scope?: ScopeRef): Promise<JsonObject | null>;
+        /** Listen for configuration changes for a scope. */
+        changed(handler: (scope: ScopeRef) => void): void;
+    };
+    /** Extension state — scoped to run (in-memory) or agent (durable). */
+    state: {
+        /** Run-scoped in-memory state; dropped when the Run ends. */
+        run(runId: string): ExtensionStateStore;
+        /** Agent-scoped durable state; persisted with the Agent record. */
+        agent(agentId: string): ExtensionStateStore;
+    };
     /** Tool capabilities — register and unregister custom tools. */
     tool: {
         /** Register a custom LLM-callable tool. */
@@ -478,6 +532,11 @@ interface ExtensionAPI {
         /** Unregister a previously registered tool by name. */
         unregister(toolName: string): void;
     };
+    /** Capability contributions — advertise tools or features to the host. */
+    capabilities: {
+        /** Contribute a capability to the host. Returns a disposer to remove the contribution. */
+        contribute(contribution: ExtensionCapabilityContribution): () => void;
+    };
     /** Register a model provider. */
     registerProvider(config: _rowan_agent_models.ProviderConfig): void;
     /** Unregister a model provider. */
@@ -524,6 +583,23 @@ type ExtensionDisposer = () => void | Promise<void>;
 type ExtensionFactoryResult = void | ExtensionDisposer;
 type ExtensionFactory = (api: ExtensionAPI) => ExtensionFactoryResult | Promise<ExtensionFactoryResult>;
 
+declare class InMemoryExtensionHost implements ExtensionHost {
+    private readonly configs;
+    private readonly agentState;
+    private readonly listeners;
+    constructor(options?: {
+        configs?: Record<string, Record<string, JsonObject>>;
+        agentState?: Record<string, Record<string, Record<string, JsonValue>>>;
+    });
+    setConfig(extensionId: string, config: JsonObject | null, scope?: ScopeRef): void;
+    getConfig(extensionId: string, scope?: ScopeRef): JsonObject | null;
+    onConfigChanged(listener: (extensionId: string, scope: ScopeRef) => void): () => void;
+    notifyConfigChanged(extensionId: string, scope?: ScopeRef): void;
+    getAgentState(extensionId: string, agentId: string, key: string): JsonValue | undefined;
+    setAgentState(extensionId: string, agentId: string, key: string, value: JsonValue): void;
+    deleteAgentState(extensionId: string, agentId: string, key: string): void;
+}
+
 /**
  * Extension runner — manages extension loading and hook execution.
  *
@@ -538,6 +614,7 @@ type ExtensionFactory = (api: ExtensionAPI) => ExtensionFactoryResult | Promise<
 type ExtensionRunnerOptions = {
     entryPhaseId?: string | null;
     cwd?: string;
+    host?: ExtensionHost;
 };
 /**
  * Manages extensions and provides hooks for the agent loop.
@@ -573,15 +650,20 @@ declare class ExtensionRunner {
     readonly hooks: HooksManager;
     readonly runtime: ExtensionRuntime;
     readonly events: EventBus;
+    readonly host: ExtensionHost;
     private readonly cwd;
     private readonly abortController;
     private _idle;
     private readonly extensions;
+    private readonly runState;
+    private readonly configChangeListeners;
+    private readonly hostUnsubscribers;
     private readonly phases;
     private _phaseCache;
     private readonly pendingProviders;
     private bound;
     private readonly errorListeners;
+    private readonly capabilityListeners;
     /** Current agent context — set by the agent before each phase */
     currentContext?: AgentContext;
     constructor(options?: ExtensionRunnerOptions);
@@ -628,12 +710,25 @@ declare class ExtensionRunner {
     loadExtensions(extensions: LoadedExtension[]): Promise<void>;
     /** Dispose all active Extensions in reverse activation order. */
     close(): Promise<void>;
+    get extensionHost(): ExtensionHost;
+    notifyConfigChanged(extensionId: string, scope: ScopeRef): void;
+    getRunState(runId: string, extensionId: string, key: string): JsonValue | undefined;
+    setRunState(runId: string, extensionId: string, key: string, value: JsonValue): void;
+    deleteRunState(runId: string, extensionId: string, key: string): void;
+    dropRunState(runId: string): void;
     /** Get all registered tools from all extensions. */
     getAllRegisteredTools(): RegisteredTool[];
     /**
      * Get a tool definition by name. Returns undefined if not found.
      */
     getToolDefinition(toolName: string): RegisteredTool["definition"] | undefined;
+    /** Get all contributed capabilities across all extensions. */
+    getCapabilities(): readonly ExtensionCapability[];
+    /**
+     * Subscribe to capability changes (contributions added, removed, or extensions disposed).
+     * Returns an unsubscribe function.
+     */
+    onCapabilitiesChanged(listener: (capabilities: readonly ExtensionCapability[]) => void): () => void;
     getPhase(name: string): Phase | undefined;
     getPhases(): Phase[];
     createPhaseRegistry(input?: {
@@ -665,18 +760,33 @@ declare class ExtensionRunner {
         output?: PhaseOutput;
     }>;
     emitBeforePrompt(phaseId: string, input: PhaseContext): Promise<PhaseContext>;
+    emitRunStart(event: {
+        runId: string;
+        agentId: string;
+        metadata: Readonly<Record<string, unknown>>;
+        turn: JsonObject;
+    }): Promise<void>;
+    emitRunEnd(event: {
+        runId: string;
+        agentId: string;
+        outcome: unknown;
+    }): Promise<void>;
     emitBeforeToolCall(tool: Tool, args: unknown, context?: {
         runId?: string;
         agentId?: string;
         toolCallId?: string;
         metadata?: Readonly<Record<string, unknown>>;
         answer?: unknown;
+        scope?: ScopeRef;
+        turn?: JsonObject;
     }): Promise<BeforeToolCallResult>;
     emitAfterToolCall(tool: Tool, result: ToolResult, context?: {
         runId?: string;
         agentId?: string;
         toolCallId?: string;
         metadata?: Readonly<Record<string, unknown>>;
+        scope?: ScopeRef;
+        turn?: JsonObject;
     }): Promise<ToolResult>;
     /**
      * Create an ExtensionAPI for a specific extension.
@@ -686,6 +796,8 @@ declare class ExtensionRunner {
     private createExtensionAPI;
     private registerTool;
     private unregisterTool;
+    private contributeCapability;
+    private notifyCapabilitiesChanged;
     private registerPhase;
     private registerPhaseDefinition;
     private unregisterPhase;
@@ -724,11 +836,14 @@ declare class RuntimeExtensionLifetime {
     private closed;
     constructor(options?: {
         cwd?: string;
+        host?: ExtensionHost;
     });
     activate(extensions: readonly LoadedExtension[]): Promise<ExtensionActivationResult>;
     tools(): readonly RegisteredTool[];
     phases(): readonly Phase[];
     get extensionRunner(): ExtensionRunner;
+    get extensionHost(): ExtensionHost;
+    dropRunState(runId: string): void;
     close(): Promise<void>;
 }
 /** Bootstrap-only Registry facade; its Extension method disappears after init. */
@@ -736,6 +851,7 @@ declare class RuntimeBootstrapRegistry extends ResourceRegistry {
     private readonly extensions;
     private readonly extensionSourceId;
     constructor(extensions?: RuntimeExtensionLifetime);
+    get extensionHost(): ExtensionHost;
     /** Install Rowan-owned implicit resources before any host source is read. */
     ensureCoreResources(): Promise<void>;
     loadExtensions(input: readonly LoadedExtension[] | ExtensionLoadInput): Promise<ExtensionActivationResult>;
@@ -830,6 +946,8 @@ type ToolCallContext = Readonly<{
     agentMetadata?: Metadata;
     runMetadata?: Metadata;
     toolCallId: ToolCallId;
+    scope?: ScopeRef;
+    turn?: JsonObject;
     reportProgress(progress: JsonValue): void;
 }>;
 type ToolInvocationContext = ToolCallContext & Readonly<{
@@ -841,6 +959,8 @@ type Tool$1 = Readonly<{
     core?: boolean;
     description: string;
     parameters: Type.TSchema;
+    promptSnippet?: string;
+    promptGuidelines?: readonly string[];
     execute(args: JsonValue, context: ToolInvocationContext, signal: AbortSignal): Promise<ToolExecutionResult>;
 }>;
 type ContextCandidate = Readonly<{
@@ -1244,6 +1364,7 @@ type AgentRuntimeOptions = Readonly<{
     configs?: ConfigProvider;
     concurrency?: number;
     bootstrap?: (registry: RuntimeBootstrapRegistry) => void | Promise<void>;
+    host?: ExtensionHost;
 }>;
 type DurableConsumer = Readonly<{
     caughtUp: Promise<void>;
@@ -1268,6 +1389,7 @@ interface AgentRun {
     cancel(reason?: string): Promise<RunBoundary>;
 }
 interface AgentRuntime$1 {
+    readonly host: ExtensionHost;
     loadAgents(input: LoadInput<AgentDefinition>): Promise<LoadResult>;
     loadSkills(input: LoadInput<Skill>): Promise<LoadResult>;
     loadPhases(input: LoadInput<Phase>): Promise<LoadResult>;
@@ -1335,6 +1457,8 @@ interface AgentRuntime$1 {
             signal: AbortSignal;
         }>): void | Promise<void>;
     }): Promise<DurableConsumer>;
+    listCapabilities(): readonly ExtensionCapability[];
+    onCapabilitiesChanged(listener: (capabilities: readonly ExtensionCapability[]) => void): () => void;
     close(): Promise<void>;
 }
 type ConsumerRegistration = Readonly<{
@@ -2039,6 +2163,8 @@ interface BeforeToolCallEvent {
     readonly toolCallId?: string;
     readonly metadata?: Readonly<Record<string, unknown>>;
     readonly answer?: unknown;
+    readonly scope?: ScopeRef;
+    readonly turn?: JsonObject;
 }
 interface AfterToolCallEvent {
     type: "after_tool_call";
@@ -2048,8 +2174,23 @@ interface AfterToolCallEvent {
     readonly agentId?: string;
     readonly toolCallId?: string;
     readonly metadata?: Readonly<Record<string, unknown>>;
+    readonly scope?: ScopeRef;
+    readonly turn?: JsonObject;
+}
+interface RunStartEvent {
+    type: "run_start";
+    runId: string;
+    agentId: string;
+    metadata: Readonly<Record<string, unknown>>;
+    turn: JsonObject;
+}
+interface RunEndEvent {
+    type: "run_end";
+    runId: string;
+    agentId: string;
+    outcome: unknown;
 }
-type HookEvent = BeforePhaseEvent | AfterPhaseEvent | BeforePromptEvent | BeforeToolCallEvent | AfterToolCallEvent;
+type HookEvent = BeforePhaseEvent | AfterPhaseEvent | BeforePromptEvent | BeforeToolCallEvent | AfterToolCallEvent | RunStartEvent | RunEndEvent;
 interface BeforePhaseResult {
     abort?: Outcome$1;
     skip?: {
@@ -2080,6 +2221,8 @@ interface HookResultMap {
     before_prompt: BeforePromptResult | undefined;
     before_tool_call: BeforeToolCallResult | undefined;
     after_tool_call: AfterToolCallResult | undefined;
+    run_start: void;
+    run_end: void;
 }
 type HookEventType = HookEvent["type"];
 type HookHandler<K extends HookEventType> = (event: Extract<HookEvent, {
@@ -2157,12 +2300,15 @@ declare class AgentRuntime implements AgentRuntime$1 {
     private readonly autoCompactionRuns;
     private readonly consumers;
     private readonly transientEvents;
+    readonly host: ExtensionHost;
     private readonly resources;
+    private readonly startedRuns;
     private heartbeat?;
     private pumping;
     private closed;
     private constructor();
     static init(options: AgentRuntimeOptions): Promise<AgentRuntime>;
+    private handleRunEnd;
     loadAgents(input: LoadInput<AgentDefinition>): Promise<LoadResult>;
     loadSkills(input: LoadInput<Skill>): Promise<LoadResult>;
     loadPhases(input: LoadInput<Phase>): Promise<LoadResult>;
@@ -2235,6 +2381,8 @@ declare class AgentRuntime implements AgentRuntime$1 {
             signal: AbortSignal;
         }>): void | Promise<void>;
     }): Promise<DurableConsumer>;
+    listCapabilities(): readonly ExtensionCapability[];
+    onCapabilitiesChanged(listener: (capabilities: readonly ExtensionCapability[]) => void): () => void;
     close(): Promise<void>;
     snapshot(runId: RunId): Promise<RunSnapshot>;
     history(agentId: AgentId): Promise<readonly Message[]>;
@@ -2990,4 +3138,4 @@ declare function parseFrontmatter<T = Record<string, unknown>>(raw: string): Fro
 
 declare function createCoreTools(input?: CoreToolContext): Tool$1[];
 
-export { type AfterToolCall, type AgentConfiguration, type AgentDefinition, type AgentId, type AgentListCursor, type AgentRecord, type AgentRun, AgentRuntime, type AgentRuntimeOptions, type AgentSummary, type AnyRuntimeError, type AssistantContent, type AssistantMessage, type BeforeToolCall, COMPACT_PHASE_ID, type ConfigProvider, type ConfigPutResult, type ConfigResolution, type ConfigToken, type ConfigurationSnapshot, type ContextCandidate, type ContextCompactionRecord, type ContextStatus, type CoreToolContext, DEFAULT_PHASE_ID, type DefinitionLayer, type DurableConsumer, type DurableRunEvent, type DurableStore, type DurableToolResult, type EntryPhaseSpec, type EventCursor, type EventId, type ExecutionCheckpoint, type ExecutionId, type ExecutionToken, type ExtensionAPI, type ExtensionActivationError, type ExtensionActivationResult, type ExtensionContribution, type ExtensionDisposer, type ExtensionFactory, type ExtensionFactoryResult, ExtensionLifetimeError, type ExtensionLifetimeErrorCode, type ExtensionLoadInput, type FrontmatterResult, type HistorySeed, type HookEvent, type HookEventType, type HookHandler, InMemoryConfigProvider, InMemoryStore, type InteractionRecord, type InvocationCatalogEntry, type InvocationSource, type JsonObject, type JsonPrimitive, type JsonValue, type LoadExtensionsResult, type LoadInput, type LoadResult, type LoadedExtension, type Message, type MessageBase, type MessageCommitted, type MessageContent, type MessageDelta, type MessageId, type MessageRevised, type MessageRevisionResult, type Metadata, type OpaqueId, type Outcome, type OwnerLease, type OwnerToken, type Page, type Phase, type PhaseContext, type PhaseContribution, type PhaseExecution, type PhaseExecutionIdentity, type PhaseInput, type PhaseInvocation, type PhaseMessageManager, type PhaseOutput, type PhaseRegistry, type PhaseRegistrySelection, type PhaseSettingsBadge, type PhaseSettingsContext, type PhaseSettingsControl, type PhaseSettingsDefinition, type PhaseSettingsItem, type PhaseSettingsOption, type PhaseSettingsProvider, type PhaseSettingsSection, type PhaseState, type PhaseStatus, type PhaseStatusState, type ResolvedResourceView, type ResourceDiagnostic, type ResourceKind, type ResourceRef, ResourceRegistry, ResourceRegistryError, type ResourceRegistryErrorCode, type ResourceSourceId, type ResourceView, type RetentionResult, type RunBoundary, type RunClaim, type RunEvent, type RunFailure, type RunId, type RunInteraction, RunInteractionBoundary, RunInteractionCancelledError, type RunInteractionDriver, type RunInteractionKind, type RunInteractionRequest, type RunInteractionState, type RunInteractionStatus, type RunListCursor, type RunRecord, type RunSnapshot, type RunState, type RunStateChanged, type RunSummary, RuntimeBootstrapRegistry, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, RuntimeExtensionLifetime, STOP_PHASE_ID, type Skill, SqliteStore, type TextContent, type ThinkingContent, type ThinkingDelta, type Tool$1 as Tool, type ToolCallContext, type ToolCallId, type ToolCallSnapshot, type ToolCallState, type ToolContribution, type ToolDefinition, type ToolExecutionResult, type ToolInvocationContext, type ToolMessage, type ToolMessageContent, type ToolProgress, type ToolResultContent, type ToolStateChanged, type ToolUseContent, type UserContent, type UserInput, type UserMessage, brandConfigToken, createCompactPhase, createCorePhases, createCoreTools, createDefaultPhase, createStopPhase, isConfigurationSnapshot, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhaseSettings, loadPhases, loadSkill, loadSkills, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };
+export { type AfterToolCall, type AgentConfiguration, type AgentDefinition, type AgentId, type AgentListCursor, type AgentRecord, type AgentRun, AgentRuntime, type AgentRuntimeOptions, type AgentSummary, type AnyRuntimeError, type AssistantContent, type AssistantMessage, type BeforeToolCall, COMPACT_PHASE_ID, type ConfigProvider, type ConfigPutResult, type ConfigResolution, type ConfigToken, type ConfigurationSnapshot, type ContextCandidate, type ContextCompactionRecord, type ContextStatus, type CoreToolContext, DEFAULT_PHASE_ID, type DefinitionLayer, type DurableConsumer, type DurableRunEvent, type DurableStore, type DurableToolResult, type EntryPhaseSpec, type EventCursor, type EventId, type ExecutionCheckpoint, type ExecutionId, type ExecutionToken, type ExtensionAPI, type ExtensionActivationError, type ExtensionActivationResult, type ExtensionCapability, type ExtensionCapabilityContribution, type ExtensionContribution, type ExtensionDisposer, type ExtensionFactory, type ExtensionFactoryResult, type ExtensionHost, ExtensionLifetimeError, type ExtensionLifetimeErrorCode, type ExtensionLoadInput, type ExtensionStateStore, type ExtensionToolContribution, type FrontmatterResult, type HistorySeed, type HookEvent, type HookEventType, type HookHandler, InMemoryConfigProvider, InMemoryExtensionHost, InMemoryStore, type InteractionRecord, type InvocationCatalogEntry, type InvocationSource, type JsonObject, type JsonPrimitive, type JsonValue, type LoadExtensionsResult, type LoadInput, type LoadResult, type LoadedExtension, type Message, type MessageBase, type MessageCommitted, type MessageContent, type MessageDelta, type MessageId, type MessageRevised, type MessageRevisionResult, type Metadata, type OpaqueId, type Outcome, type OwnerLease, type OwnerToken, type Page, type Phase, type PhaseContext, type PhaseContribution, type PhaseExecution, type PhaseExecutionIdentity, type PhaseInput, type PhaseInvocation, type PhaseMessageManager, type PhaseOutput, type PhaseRegistry, type PhaseRegistrySelection, type PhaseSettingsBadge, type PhaseSettingsContext, type PhaseSettingsControl, type PhaseSettingsDefinition, type PhaseSettingsItem, type PhaseSettingsOption, type PhaseSettingsProvider, type PhaseSettingsSection, type PhaseState, type PhaseStatus, type PhaseStatusState, type ResolvedResourceView, type ResourceDiagnostic, type ResourceKind, type ResourceRef, ResourceRegistry, ResourceRegistryError, type ResourceRegistryErrorCode, type ResourceSourceId, type ResourceView, type RetentionResult, type RunBoundary, type RunClaim, type RunEndEvent, type RunEvent, type RunFailure, type RunId, type RunInteraction, RunInteractionBoundary, RunInteractionCancelledError, type RunInteractionDriver, type RunInteractionKind, type RunInteractionRequest, type RunInteractionState, type RunInteractionStatus, type RunListCursor, type RunRecord, type RunSnapshot, type RunStartEvent, type RunState, type RunStateChanged, type RunSummary, RuntimeBootstrapRegistry, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, RuntimeExtensionLifetime, STOP_PHASE_ID, type ScopeRef, type Skill, SqliteStore, type TextContent, type ThinkingContent, type ThinkingDelta, type Tool$1 as Tool, type ToolCallContext, type ToolCallId, type ToolCallSnapshot, type ToolCallState, type ToolContribution, type ToolDefinition, type ToolExecutionResult, type ToolInvocationContext, type ToolMessage, type ToolMessageContent, type ToolProgress, type ToolResultContent, type ToolStateChanged, type ToolUseContent, type UserContent, type UserInput, type UserMessage, brandConfigToken, createCompactPhase, createCorePhases, createCoreTools, createDefaultPhase, createStopPhase, isConfigurationSnapshot, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhaseSettings, loadPhases, loadSkill, loadSkills, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };