Skip to content

A programming framework for agentic AI

1.6 KB
Raw Blame
// Copyright (c) Microsoft Corporation. All rights reserved.
// ISaveStateMixin.cs

using System.Text.Json;

namespace Microsoft.AutoGen.Contracts;

/// <summary>
/// Defines a contract for saving and loading the state of an object.
/// The state must be JSON serializable.
/// </summary>
/// <typeparam name="T">The type of the object implementing this interface.</typeparam>
///
public interface ISaveStateMixin<T> : ISaveState
{
    /// <summary>
    /// Saves the current state of the object.
    /// </summary>
    /// <returns>
    /// A task representing the asynchronous operation, returning a dictionary
    /// containing the saved state. The structure of the state is implementation-defined
    /// but must be JSON serializable.
    /// </returns>
    async ValueTask<JsonElement> ISaveState.SaveStateAsync()
    {
        var state = await SaveStateImpl();
        return JsonSerializer.SerializeToElement(state);
    }

    /// <summary>
    /// Loads a previously saved state into the object.
    /// </summary>
    /// <param name="state">
    /// A dictionary representing the saved state. The structure of the state
    /// is implementation-defined but must be JSON serializable.
    /// </param>
    /// <returns>A task representing the asynchronous operation.</returns>
    ValueTask ISaveState.LoadStateAsync(JsonElement state)
    {
        // Throw if failed to deserialize
        var stateObject = JsonSerializer.Deserialize<T>(state) ?? throw new InvalidDataException();
        return LoadStateImpl(stateObject);
    }

    protected ValueTask<T> SaveStateImpl();

    protected ValueTask LoadStateImpl(T state);
}