@elizaos/agent 0.25.8 → 2.0.0-alpha.83

package/packages/agent/src/services/coding-agent-context.d.ts

@@ -0,0 +1,310 @@
+/**
+ * Coding agent context types and validation.
+ *
+ * Provides Zod schemas and TypeScript types for validating coding agent
+ * context objects used in the autonomous coding loop: code generation,
+ * execution, error capture, iterative self-correction, and human-in-the-loop
+ * feedback injection.
+ *
+ * @module services/coding-agent-context
+ */
+import { z } from "zod";
+/** Schema for a single file operation within a coding iteration. */
+export declare const FileOperationSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        search: "search";
+        read: "read";
+        write: "write";
+        edit: "edit";
+        list: "list";
+    }>;
+    target: z.ZodString;
+    size: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Schema for a shell command result captured during execution. */
+export declare const CommandResultSchema: z.ZodObject<{
+    command: z.ZodString;
+    exitCode: z.ZodNumber;
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+    executedIn: z.ZodString;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+/** Schema for an error captured during code execution. */
+export declare const CapturedErrorSchema: z.ZodObject<{
+    category: z.ZodEnum<{
+        other: "other";
+        compile: "compile";
+        runtime: "runtime";
+        test: "test";
+        lint: "lint";
+    }>;
+    message: z.ZodString;
+    filePath: z.ZodOptional<z.ZodString>;
+    line: z.ZodOptional<z.ZodNumber>;
+    raw: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Schema for human feedback injected into the coding loop. */
+export declare const HumanFeedbackSchema: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodNumber;
+    text: z.ZodString;
+    iterationRef: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodEnum<{
+        approval: "approval";
+        correction: "correction";
+        guidance: "guidance";
+        rejection: "rejection";
+    }>;
+}, z.core.$strip>;
+/** Schema for a single iteration of the coding agent loop. */
+export declare const CodingIterationSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    startedAt: z.ZodNumber;
+    completedAt: z.ZodOptional<z.ZodNumber>;
+    generatedCode: z.ZodOptional<z.ZodString>;
+    fileOperations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            search: "search";
+            read: "read";
+            write: "write";
+            edit: "edit";
+            list: "list";
+        }>;
+        target: z.ZodString;
+        size: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    commandResults: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        exitCode: z.ZodNumber;
+        stdout: z.ZodString;
+        stderr: z.ZodString;
+        executedIn: z.ZodString;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        success: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    errors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        category: z.ZodEnum<{
+            other: "other";
+            compile: "compile";
+            runtime: "runtime";
+            test: "test";
+            lint: "lint";
+        }>;
+        message: z.ZodString;
+        filePath: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+        raw: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    feedback: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        timestamp: z.ZodNumber;
+        text: z.ZodString;
+        iterationRef: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodEnum<{
+            approval: "approval";
+            correction: "correction";
+            guidance: "guidance";
+            rejection: "rejection";
+        }>;
+    }, z.core.$strip>>>;
+    selfCorrected: z.ZodDefault<z.ZodBoolean>;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Schema for the connector type used by the coding agent. */
+export declare const ConnectorTypeSchema: z.ZodEnum<{
+    browser: "browser";
+    "local-fs": "local-fs";
+    "git-repo": "git-repo";
+    api: "api";
+    sandbox: "sandbox";
+}>;
+/** Schema for connector configuration. */
+export declare const ConnectorConfigSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        browser: "browser";
+        "local-fs": "local-fs";
+        "git-repo": "git-repo";
+        api: "api";
+        sandbox: "sandbox";
+    }>;
+    basePath: z.ZodString;
+    available: z.ZodDefault<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+/** Interaction mode for the coding session. */
+export declare const InteractionModeSchema: z.ZodEnum<{
+    "fully-automated": "fully-automated";
+    "human-in-the-loop": "human-in-the-loop";
+    "manual-guidance": "manual-guidance";
+}>;
+/** Schema for the full coding agent context. */
+export declare const CodingAgentContextSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    taskDescription: z.ZodString;
+    workingDirectory: z.ZodString;
+    connector: z.ZodObject<{
+        type: z.ZodEnum<{
+            browser: "browser";
+            "local-fs": "local-fs";
+            "git-repo": "git-repo";
+            api: "api";
+            sandbox: "sandbox";
+        }>;
+        basePath: z.ZodString;
+        available: z.ZodDefault<z.ZodBoolean>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>;
+    interactionMode: z.ZodEnum<{
+        "fully-automated": "fully-automated";
+        "human-in-the-loop": "human-in-the-loop";
+        "manual-guidance": "manual-guidance";
+    }>;
+    maxIterations: z.ZodDefault<z.ZodNumber>;
+    active: z.ZodDefault<z.ZodBoolean>;
+    iterations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        startedAt: z.ZodNumber;
+        completedAt: z.ZodOptional<z.ZodNumber>;
+        generatedCode: z.ZodOptional<z.ZodString>;
+        fileOperations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                search: "search";
+                read: "read";
+                write: "write";
+                edit: "edit";
+                list: "list";
+            }>;
+            target: z.ZodString;
+            size: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        commandResults: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            command: z.ZodString;
+            exitCode: z.ZodNumber;
+            stdout: z.ZodString;
+            stderr: z.ZodString;
+            executedIn: z.ZodString;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            success: z.ZodBoolean;
+        }, z.core.$strip>>>;
+        errors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            category: z.ZodEnum<{
+                other: "other";
+                compile: "compile";
+                runtime: "runtime";
+                test: "test";
+                lint: "lint";
+            }>;
+            message: z.ZodString;
+            filePath: z.ZodOptional<z.ZodString>;
+            line: z.ZodOptional<z.ZodNumber>;
+            raw: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        feedback: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            timestamp: z.ZodNumber;
+            text: z.ZodString;
+            iterationRef: z.ZodOptional<z.ZodNumber>;
+            type: z.ZodEnum<{
+                approval: "approval";
+                correction: "correction";
+                guidance: "guidance";
+                rejection: "rejection";
+            }>;
+        }, z.core.$strip>>>;
+        selfCorrected: z.ZodDefault<z.ZodBoolean>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    allFeedback: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        timestamp: z.ZodNumber;
+        text: z.ZodString;
+        iterationRef: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodEnum<{
+            approval: "approval";
+            correction: "correction";
+            guidance: "guidance";
+            rejection: "rejection";
+        }>;
+    }, z.core.$strip>>>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type FileOperation = z.infer<typeof FileOperationSchema>;
+export type CommandResult = z.infer<typeof CommandResultSchema>;
+export type CapturedError = z.infer<typeof CapturedErrorSchema>;
+export type HumanFeedback = z.infer<typeof HumanFeedbackSchema>;
+export type CodingIteration = z.infer<typeof CodingIterationSchema>;
+export type ConnectorType = z.infer<typeof ConnectorTypeSchema>;
+export type ConnectorConfig = z.infer<typeof ConnectorConfigSchema>;
+export type InteractionMode = z.infer<typeof InteractionModeSchema>;
+export type CodingAgentContext = z.infer<typeof CodingAgentContextSchema>;
+/** Result of a validation operation. */
+export type ValidationResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    errors: Array<{
+        path: string;
+        message: string;
+    }>;
+};
+/**
+ * Validate a coding agent context object.
+ * Returns a typed result with either the validated data or an array of errors.
+ */
+export declare function validateCodingAgentContext(input: Record<string, unknown>): ValidationResult<CodingAgentContext>;
+/**
+ * Validate a single coding iteration.
+ */
+export declare function validateCodingIteration(input: Record<string, unknown>): ValidationResult<CodingIteration>;
+/**
+ * Validate human feedback input.
+ */
+export declare function validateHumanFeedback(input: Record<string, unknown>): ValidationResult<HumanFeedback>;
+/**
+ * Validate a connector configuration.
+ */
+export declare function validateConnectorConfig(input: Record<string, unknown>): ValidationResult<ConnectorConfig>;
+/**
+ * Create a new coding agent context with sensible defaults.
+ */
+export declare function createCodingAgentContext(params: {
+    sessionId: string;
+    taskDescription: string;
+    workingDirectory: string;
+    connectorType: ConnectorType;
+    connectorBasePath: string;
+    interactionMode?: InteractionMode;
+    maxIterations?: number;
+}): CodingAgentContext;
+/**
+ * Check if the coding agent context has reached its iteration limit.
+ */
+export declare function hasReachedMaxIterations(ctx: CodingAgentContext): boolean;
+/**
+ * Check if the latest iteration resolved all errors.
+ */
+export declare function isLastIterationClean(ctx: CodingAgentContext): boolean;
+/**
+ * Get all unresolved errors from the latest iteration.
+ */
+export declare function getUnresolvedErrors(ctx: CodingAgentContext): CapturedError[];
+/**
+ * Add an iteration to the context and update the timestamp.
+ */
+export declare function addIteration(ctx: CodingAgentContext, iteration: CodingIteration): CodingAgentContext;
+/**
+ * Inject human feedback into the context.
+ */
+export declare function injectFeedback(ctx: CodingAgentContext, feedback: HumanFeedback): CodingAgentContext;
+/**
+ * Determine if the coding loop should continue based on context state.
+ */
+export declare function shouldContinueLoop(ctx: CodingAgentContext): {
+    shouldContinue: boolean;
+    reason: string;
+};
+//# sourceMappingURL=coding-agent-context.d.ts.map

package/packages/agent/src/services/coding-agent-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding-agent-context.d.ts","sourceRoot":"","sources":["../../../../../src/services/coding-agent-context.ts"],"names":[],"mappings":"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"}

package/packages/agent/src/services/coding-agent-context.js

@@ -0,0 +1,281 @@
+/**
+ * Coding agent context types and validation.
+ *
+ * Provides Zod schemas and TypeScript types for validating coding agent
+ * context objects used in the autonomous coding loop: code generation,
+ * execution, error capture, iterative self-correction, and human-in-the-loop
+ * feedback injection.
+ *
+ * @module services/coding-agent-context
+ */
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// Zod Schemas
+// ---------------------------------------------------------------------------
+/** Schema for a single file operation within a coding iteration. */
+export const FileOperationSchema = z.object({
+    type: z.enum(["read", "write", "edit", "list", "search"]),
+    target: z.string().min(1, "File operation target must not be empty"),
+    /** Size in bytes for write/edit operations. */
+    size: z.number().int().nonnegative().optional(),
+});
+/** Schema for a shell command result captured during execution. */
+export const CommandResultSchema = z.object({
+    command: z.string().min(1),
+    exitCode: z.number().int(),
+    stdout: z.string(),
+    stderr: z.string(),
+    /** Working directory where the command was executed. */
+    executedIn: z.string().min(1),
+    /** Duration in milliseconds. */
+    durationMs: z.number().nonnegative().optional(),
+    success: z.boolean(),
+});
+/** Schema for an error captured during code execution. */
+export const CapturedErrorSchema = z.object({
+    /** Error category: compile, runtime, test, lint, or other. */
+    category: z.enum(["compile", "runtime", "test", "lint", "other"]),
+    /** Human-readable error message. */
+    message: z.string().min(1),
+    /** File path where the error occurred (if applicable). */
+    filePath: z.string().optional(),
+    /** Line number where the error occurred (if applicable). */
+    line: z.number().int().positive().optional(),
+    /** Raw error output from the tool/command. */
+    raw: z.string().optional(),
+});
+/** Schema for human feedback injected into the coding loop. */
+export const HumanFeedbackSchema = z.object({
+    /** Unique feedback identifier. */
+    id: z.string().min(1),
+    /** Timestamp when feedback was received. */
+    timestamp: z.number().int().positive(),
+    /** The feedback text from the user. */
+    text: z.string().min(1),
+    /** The context/iteration the feedback applies to. */
+    iterationRef: z.number().int().nonnegative().optional(),
+    /** Feedback type: correction, guidance, approval, rejection. */
+    type: z.enum(["correction", "guidance", "approval", "rejection"]),
+});
+/** Schema for a single iteration of the coding agent loop. */
+export const CodingIterationSchema = z.object({
+    /** Zero-based iteration index. */
+    index: z.number().int().nonnegative(),
+    /** Timestamp when this iteration started. */
+    startedAt: z.number().int().positive(),
+    /** Timestamp when this iteration completed. */
+    completedAt: z.number().int().positive().optional(),
+    /** Code generation output (the generated/modified code). */
+    generatedCode: z.string().optional(),
+    /** File operations performed during this iteration. */
+    fileOperations: z.array(FileOperationSchema).default([]),
+    /** Commands executed during this iteration. */
+    commandResults: z.array(CommandResultSchema).default([]),
+    /** Errors captured during this iteration. */
+    errors: z.array(CapturedErrorSchema).default([]),
+    /** Human feedback applied at this iteration. */
+    feedback: z.array(HumanFeedbackSchema).default([]),
+    /** Whether this iteration resolved all errors from the previous one. */
+    selfCorrected: z.boolean().default(false),
+    /** Summary of what changed in this iteration. */
+    summary: z.string().optional(),
+});
+/** Schema for the connector type used by the coding agent. */
+export const ConnectorTypeSchema = z.enum([
+    "local-fs",
+    "git-repo",
+    "api",
+    "browser",
+    "sandbox",
+]);
+/** Schema for connector configuration. */
+export const ConnectorConfigSchema = z.object({
+    type: ConnectorTypeSchema,
+    /** Base path / URL for the connector. */
+    basePath: z.string().min(1),
+    /** Whether the connector is currently available. */
+    available: z.boolean().default(true),
+    /** Connector-specific metadata. */
+    metadata: z.record(z.string(), z.string()).optional(),
+});
+/** Interaction mode for the coding session. */
+export const InteractionModeSchema = z.enum([
+    "fully-automated",
+    "human-in-the-loop",
+    "manual-guidance",
+]);
+/** Schema for the full coding agent context. */
+export const CodingAgentContextSchema = z.object({
+    /** Unique session identifier. */
+    sessionId: z.string().min(1),
+    /** Task description / goal for the coding session. */
+    taskDescription: z.string().min(1),
+    /** Working directory for file operations. */
+    workingDirectory: z.string().min(1),
+    /** Connector configuration for accessing code. */
+    connector: ConnectorConfigSchema,
+    /** Interaction mode for this session. */
+    interactionMode: InteractionModeSchema,
+    /** Maximum iterations before the loop stops. */
+    maxIterations: z.number().int().positive().default(10),
+    /** Whether the loop is currently active. */
+    active: z.boolean().default(true),
+    /** All iterations of the coding loop. */
+    iterations: z.array(CodingIterationSchema).default([]),
+    /** All human feedback collected during the session. */
+    allFeedback: z.array(HumanFeedbackSchema).default([]),
+    /** Timestamp when the session was created. */
+    createdAt: z.number().int().positive(),
+    /** Timestamp when the session was last updated. */
+    updatedAt: z.number().int().positive().optional(),
+});
+function formatValidationErrors(issues) {
+    return issues.map((issue) => ({
+        path: issue.path.join("."),
+        message: issue.message,
+    }));
+}
+/**
+ * Validate a coding agent context object.
+ * Returns a typed result with either the validated data or an array of errors.
+ */
+export function validateCodingAgentContext(input) {
+    const result = CodingAgentContextSchema.safeParse(input);
+    if (result.success) {
+        return { ok: true, data: result.data };
+    }
+    return { ok: false, errors: formatValidationErrors(result.error.issues) };
+}
+/**
+ * Validate a single coding iteration.
+ */
+export function validateCodingIteration(input) {
+    const result = CodingIterationSchema.safeParse(input);
+    if (result.success) {
+        return { ok: true, data: result.data };
+    }
+    return { ok: false, errors: formatValidationErrors(result.error.issues) };
+}
+/**
+ * Validate human feedback input.
+ */
+export function validateHumanFeedback(input) {
+    const result = HumanFeedbackSchema.safeParse(input);
+    if (result.success) {
+        return { ok: true, data: result.data };
+    }
+    return { ok: false, errors: formatValidationErrors(result.error.issues) };
+}
+/**
+ * Validate a connector configuration.
+ */
+export function validateConnectorConfig(input) {
+    const result = ConnectorConfigSchema.safeParse(input);
+    if (result.success) {
+        return { ok: true, data: result.data };
+    }
+    return { ok: false, errors: formatValidationErrors(result.error.issues) };
+}
+// ---------------------------------------------------------------------------
+// Context helpers
+// ---------------------------------------------------------------------------
+/**
+ * Create a new coding agent context with sensible defaults.
+ */
+export function createCodingAgentContext(params) {
+    const now = Date.now();
+    return {
+        sessionId: params.sessionId,
+        taskDescription: params.taskDescription,
+        workingDirectory: params.workingDirectory,
+        connector: {
+            type: params.connectorType,
+            basePath: params.connectorBasePath,
+            available: true,
+        },
+        interactionMode: params.interactionMode ?? "fully-automated",
+        maxIterations: params.maxIterations ?? 10,
+        active: true,
+        iterations: [],
+        allFeedback: [],
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/**
+ * Check if the coding agent context has reached its iteration limit.
+ */
+export function hasReachedMaxIterations(ctx) {
+    return ctx.iterations.length >= ctx.maxIterations;
+}
+/**
+ * Check if the latest iteration resolved all errors.
+ */
+export function isLastIterationClean(ctx) {
+    if (ctx.iterations.length === 0)
+        return true;
+    const last = ctx.iterations[ctx.iterations.length - 1];
+    if (!last)
+        return true;
+    return last.errors.length === 0;
+}
+/**
+ * Get all unresolved errors from the latest iteration.
+ */
+export function getUnresolvedErrors(ctx) {
+    if (ctx.iterations.length === 0)
+        return [];
+    const last = ctx.iterations[ctx.iterations.length - 1];
+    if (!last)
+        return [];
+    return last.errors;
+}
+/**
+ * Add an iteration to the context and update the timestamp.
+ */
+export function addIteration(ctx, iteration) {
+    return {
+        ...ctx,
+        iterations: [...ctx.iterations, iteration],
+        updatedAt: Date.now(),
+    };
+}
+/**
+ * Inject human feedback into the context.
+ */
+export function injectFeedback(ctx, feedback) {
+    return {
+        ...ctx,
+        allFeedback: [...ctx.allFeedback, feedback],
+        updatedAt: Date.now(),
+    };
+}
+/**
+ * Determine if the coding loop should continue based on context state.
+ */
+export function shouldContinueLoop(ctx) {
+    if (!ctx.active) {
+        return { shouldContinue: false, reason: "Session is no longer active" };
+    }
+    if (hasReachedMaxIterations(ctx)) {
+        return {
+            shouldContinue: false,
+            reason: `Reached maximum iterations (${ctx.maxIterations})`,
+        };
+    }
+    if (isLastIterationClean(ctx) && ctx.iterations.length > 0) {
+        return {
+            shouldContinue: false,
+            reason: "Last iteration completed without errors",
+        };
+    }
+    // Check for human rejection feedback that should halt the loop
+    const lastFeedback = ctx.allFeedback[ctx.allFeedback.length - 1];
+    if (lastFeedback?.type === "rejection") {
+        return {
+            shouldContinue: false,
+            reason: "User rejected the last iteration",
+        };
+    }
+    return { shouldContinue: true, reason: "Errors to resolve or work to do" };
+}

package/packages/agent/src/services/fallback-training-service.d.ts

@@ -0,0 +1,78 @@
+import type { AgentRuntime } from "@elizaos/core";
+import type { TrainingServiceWithRuntime } from "../api/training-service-like";
+import type { ElizaConfig } from "../config/config";
+type DatasetRecord = {
+    id: string;
+    createdAt: string;
+    limit?: number;
+    minLlmCallsPerTrajectory?: number;
+};
+type TrainingJobRecord = {
+    id: string;
+    datasetId: string;
+    status: "queued" | "running" | "completed" | "failed" | "cancelled";
+    createdAt: string;
+};
+type TrainingModelRecord = {
+    id: string;
+    createdAt: string;
+};
+export declare class FallbackTrainingService implements TrainingServiceWithRuntime {
+    private readonly options;
+    private readonly listeners;
+    private readonly datasets;
+    private readonly jobs;
+    private readonly models;
+    constructor(options: {
+        getRuntime: () => AgentRuntime | null;
+        getConfig: () => ElizaConfig;
+        setConfig: (nextConfig: ElizaConfig) => void;
+    });
+    initialize(): Promise<void>;
+    subscribe(listener: (event: unknown) => void): () => void;
+    private emit;
+    getStatus(): {
+        runningJobs: number;
+        datasetCount: number;
+        modelCount: number;
+    };
+    listTrajectories(options: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        available: boolean;
+        reason: string;
+        trajectories: unknown[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    getTrajectoryById(_trajectoryId: string): Promise<null>;
+    listDatasets(): DatasetRecord[];
+    buildDataset(options: {
+        limit?: number;
+        minLlmCallsPerTrajectory?: number;
+    }): Promise<DatasetRecord>;
+    listJobs(): TrainingJobRecord[];
+    startTrainingJob(options: {
+        datasetId?: string;
+    }): Promise<TrainingJobRecord>;
+    getJob(jobId: string): TrainingJobRecord | null;
+    cancelJob(jobId: string): Promise<TrainingJobRecord>;
+    listModels(): TrainingModelRecord[];
+    importModelToOllama(modelId: string, _body: {
+        modelName?: string;
+        baseModel?: string;
+        ollamaUrl?: string;
+    }): Promise<TrainingModelRecord>;
+    activateModel(modelId: string, _providerModel?: string): Promise<{
+        ok: boolean;
+        activeModelId: string;
+    }>;
+    benchmarkModel(modelId: string): Promise<{
+        ok: boolean;
+        modelId: string;
+    }>;
+}
+export {};
+//# sourceMappingURL=fallback-training-service.d.ts.map

package/packages/agent/src/services/fallback-training-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-training-service.d.ts","sourceRoot":"","sources":["../../../../../src/services/fallback-training-service.ts"],"names":[],"mappings":"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"}